Procedimentos

Instruções específicas para tarefas que seu agente carrega quando são relevantes

Visão geral

Um procedimento contém instruções para uma tarefa específica. Cada procedimento tem um gatilho que descreve quando ele se aplica e um conteúdo que descreve o que fazer. Quando uma conversa corresponde ao gatilho, o agente carrega o procedimento.

Use procedimentos quando seu agente precisar lidar com várias tarefas diferentes. Um caso de uso é um agente de suporte ao cliente, em que cada procedimento abrange um tipo de solicitação: reembolsos, verificação de identidade, recuperação de conta ou solução de problemas de conexão.

Tipos de procedimento

Há dois tipos de procedimentos:

Procedimentos de formato livre são escritos como instruções em linguagem natural, que o agente interpreta e adapta à situação.
Procedimentos estruturados são uma lista ordenada de etapas tipadas que o agente executa da mesma forma todas as vezes.

Você pode usar os dois tipos, junto com workflows, no mesmo agente. O agente escolhe o procedimento relevante com base no gatilho, independentemente do tipo.

Quando usar procedimentos

Todo agente tem um prompt de sistema. Procedimentos e workflows são duas formas alternativas de adicionar estrutura. Escolha com base em quanto a conversa pode variar.

Requisito	Usar	Por quê
Agente simples de prova de conceito	Apenas prompt de sistema	É a forma mais rápida de configurar e iterar, mas um único prompt se torna difícil de gerenciar à medida que o escopo do agente aumenta.
Tarefa em que o agente pode adaptar a redação e a ordem	Procedimento de formato livre	Mantém toda a conversa no contexto de um LLM, para que o agente adapte a redação e a ordem e possa lidar com rumos inesperados. Usa mais da janela de contexto.
Tarefa cujas etapas devem ser executadas da mesma forma sempre	Procedimento estruturado	Cada etapa é executada na ordem definida, da mesma forma todas as vezes, e você a cria como uma lista curta de etapas.
Controle total sobre ramificações e casos extremos complexos	Workflow	É executado como um grafo de subagentes que você projeta e conecta, com total controle sobre as ramificações e o modelo usado em cada etapa.

Gerenciar procedimentos

O painel é a forma recomendada de criar procedimentos. Use a API para gerenciar procedimentos programaticamente ou integrá-los às ferramentas de implantação.

No momento, a CLI da ElevenLabs não oferece suporte ao gerenciamento de procedimentos.

Criar pelo painel

Gerenciar pela API

Abra seu agente no painel e selecione Procedimentos. Use + para criar um procedimento de formato livre ou estruturado. Veja Procedimentos de formato livre e Procedimentos estruturados para orientações de criação.

Limitações

O conteúdo de um procedimento é limitado a 50.000 caracteres.
Não é possível alterar o tipo de um procedimento depois de criá-lo.
Os procedimentos pertencem a um único agente. Eles não podem ser compartilhados entre agentes nem armazenados como recursos no nível do workspace.
Duplicar um agente copia seus procedimentos em vez de compartilhá-los. As cópias recebem novos IDs de procedimento, portanto as referências no agente duplicado devem usar esses novos IDs.
Procedimentos estruturados não podem fazer referência a documentos da base de conhecimento.