> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Procedury ## Przegląd Procedura zawiera instrukcje dotyczące jednego konkretnego zadania. Każda procedura ma wyzwalacz opisujący, kiedy ma zastosowanie, oraz treść opisującą, co robić. Gdy rozmowa pasuje do wyzwalacza, agent ładuje procedurę. Używaj procedur, gdy agent ma obsługiwać wiele różnych zadań. Przykładem jest agent obsługi klienta, gdzie każda procedura obejmuje jeden typ zgłoszenia: zwroty, weryfikację tożsamości, odzyskiwanie konta lub rozwiązywanie problemów z połączeniem. ![Karta Procedury w panelu agenta](/docs/_fern-img/38b190b7a08cb9e628da309a86c5e4b315eabccf238a41d5d3a6c2646aba11af.webp) ## Typy procedur Są dwa rodzaje procedur: * **[Procedury swobodne](/docs/pl/eleven-agents/customization/procedures/free-form-procedures)** są zapisane jako instrukcje w języku naturalnym, które agent interpretuje i dostosowuje do sytuacji. * **[Procedury strukturalne](/docs/pl/eleven-agents/customization/procedures/structured-procedures)** to uporządkowana lista kroków określonego typu, które agent wykonuje zawsze tak samo. Możesz używać obu rodzajów, razem z [workflow](/docs/pl/eleven-agents/customization/agent-workflows), w tym samym agencie. Agent wybiera odpowiednią procedurę na podstawie jej wyzwalacza, niezależnie od typu. ## Kiedy używać procedur Każdy agent ma [prompt systemowy](/docs/pl/eleven-agents/best-practices/prompting-guide). Procedury i [workflow](/docs/pl/eleven-agents/customization/agent-workflows) to dwa alternatywne sposoby na dodanie struktury. Wybór zależy od tego, jak bardzo może różnić się rozmowa. | Wymaganie | Użyj | Dlaczego | | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Prosty agent proof of concept | Tylko prompt systemowy | To najszybszy sposób na konfigurację i iterację, ale pojedynczy prompt staje się nieporęczny, gdy zakres agenta rośnie. | | Zadanie, w którym agent może zmieniać słowa i kolejność | [Procedura swobodna](/docs/pl/eleven-agents/customization/procedures/free-form-procedures) | Utrzymuje całą rozmowę w kontekście jednego LLM-a, więc agent dostosowuje słowa i kolejność oraz radzi sobie z nieoczekiwanymi zwrotami. Zużywa więcej okna kontekstu. | | Zadanie, którego kroki muszą zawsze przebiegać tak samo | [Procedura strukturalna](/docs/pl/eleven-agents/customization/procedures/structured-procedures) | Każdy krok jest wykonywany w ustawionej kolejności, zawsze tak samo, a ty tworzysz ją jako krótką listę kroków. | | Pełna kontrola nad złożonymi rozgałęzieniami i przypadkami brzegowymi | [Workflow](/docs/pl/eleven-agents/customization/agent-workflows) | Działa jako graf subagentów, które sam projektujesz i łączysz, z pełną kontrolą nad rozgałęzieniami i modelem używanym w każdym kroku. | ## Zarządzanie procedurami Panel to zalecany sposób tworzenia procedur. Użyj API, aby zarządzać procedurami programowo lub zintegrować je z narzędziami wdrożeniowymi. > **Note** > > CLI ElevenLabs obecnie nie obsługuje zarządzania procedurami. #### Tworzenie w panelu Otwórz agenta w [panelu](https://elevenlabs.io/app/agents), a następnie wybierz **Procedury**. Użyj **+**, aby utworzyć procedurę swobodną lub strukturalną. Zobacz [Procedury swobodne](/docs/pl/eleven-agents/customization/procedures/free-form-procedures) oraz [Procedury strukturalne](/docs/pl/eleven-agents/customization/procedures/structured-procedures) , aby poznać wskazówki dotyczące tworzenia. #### Zarządzanie przez API Szkice procedur działają zgodnie z [cyklem życia wersji agenta](/docs/pl/eleven-agents/operate/versioning#drafts). Są przypisane do użytkownika i gałęzi, więc każdy członek zespołu ma osobne szkice w każdej gałęzi. Publikacja zapisuje zmiany procedury w nowej, niezmiennej wersji agenta w tej gałęzi. Szkice innych użytkowników pozostają bez zmian. Odpowiedzi konfiguracji agenta zawierają metadane procedur, takie jak identyfikatory, nazwy, typy i wyzwalacze, ale nie treść procedur ani szkice. Użyj endpointów procedur, aby odczytać i edytować pełną treść. Wszystkie endpointy procedur są zagnieżdżone w `/v1/convai/agents/{agent_id}/branches/{branch_id}`. ### Utwórz lub zaktualizuj szkic Utwórz procedurę za pomocą `POST /procedures`. Zaktualizuj ją przez `PATCH /procedures/{procedure_id}/draft`, podając `name`, `content`, `type` i `trigger` w każdym żądaniu. Użyj `GET /procedures/{procedure_id}/draft`, aby odczytać nieopublikowane zmiany. Jeśli nie masz szkicu, endpoint zwróci opublikowaną wersję. ### Opublikuj zmiany Opublikuj szkic, tworząc nową wersję agenta. Procedury swobodne możesz opublikować bezpośrednio. W przypadku procedur strukturalnych najpierw wywołaj `/procedures/compile`, aby wygenerować workflow. Postępuj zgodnie z instrukcjami dla danego typu: [procedury swobodne](/docs/pl/eleven-agents/customization/procedures/free-form-procedures#manage-a-free-form-procedure) lub [procedury strukturalne](/docs/pl/eleven-agents/customization/procedures/structured-procedures#manage-a-structured-procedure). ### Odrzuć lub usuń procedurę `DELETE /procedures/{procedure_id}/draft` odrzuca nieopublikowane zmiany i przywraca opublikowaną wersję. Jeśli procedura nigdy nie została opublikowana, zostanie usunięta. `DELETE /procedures/{procedure_id}` przygotowuje usunięcie opublikowanej procedury. Opublikuj zmianę, używając tego samego procesu dla danego typu. Pełne schematy endpointów znajdziesz w [dokumentacji API procedur](/docs/pl/api-reference/agents/procedures/). ## Ograniczenia * Treść procedury jest ograniczona do 50 000 znaków. * Po utworzeniu procedury nie można zmienić jej typu. * Procedury należą do jednego agenta. Nie można ich udostępniać między agentami ani przechowywać jako zasobów na poziomie workspace'a. * Duplikowanie agenta kopiuje jego procedury zamiast je współdzielić. Kopie otrzymują nowe identyfikatory procedur, więc odwołania w zduplikowanym agencie muszą używać tych nowych identyfikatorów. * Procedury strukturalne nie mogą odwoływać się do dokumentów bazy wiedzy.