Atende Direito · Docs

Tema

Criar seu primeiro Agent ​

Vamos criar juntos um Agent simples — um atendente que recebe mensagens dos seus clientes, entende o que eles precisam e responde de forma amigável. Depois que você entender o básico, é só personalizar.

Tela inicial do Agent Builder com a listagem de agents

Tela inicial do Agent Builder com a listagem de agents

Antes de começar ​

Você vai precisar de:

  • Acesso ao Agent Builder (menu lateral da plataforma)
  • Pelo menos um modelo de IA configurado (ex.: GPT-4o, Claude Sonnet)
Dica

Se você ainda não tem um modelo configurado, peça ao administrador da sua conta para habilitar um provedor de IA nas configurações da plataforma.

Passo a passo

  1. Abra o Agent Builder no menu lateral da plataforma e clique em Novo Agent.

    Menu lateral com Agentes destacado e tela de listagem de agents

    Menu lateral com Agentes destacado e tela de listagem de agents

  2. Preencha o nome e a descrição do Agent na aba Identidade. Escolha um nome que identifique claramente o papel dele — por exemplo, "Atendente de Dúvidas Jurídicas" ou "Assistente de Vendas".

    Ainda na aba Identidade, defina a aparência do Agent: uma cor (código hexadecimal, no formato #RRGGBB) e um ícone, escolhido entre os ícones disponíveis na plataforma. Essa cor e ícone formam o badge do Agent — a marca visual que aparece no painel de conversa toda vez que ele responde um cliente. Um preview do badge é exibido ali mesmo enquanto você escolhe, para conferir como vai ficar.

    Aba Identidade do assistente de criação do Agent, com os campos Nome, Descrição, Tipo e Instrução (System Prompt).

    Aba Identidade do assistente de criação do Agent, com os campos Nome, Descrição, Tipo e Instrução (System Prompt).

    Dica

    Cor e ícone são opcionais, mas ajudam bastante quem acompanha o atendimento: quando vários agents atuam no mesmo canal, o badge colorido no chat deixa claro, num olhar, qual agent respondeu cada mensagem. Veja como o badge aparece em Controle da IA no chat → Quem respondeu cada mensagem.

  3. Escolha o tipo do Agent. Para começar, selecione LLM (o mais simples — um único modelo que recebe suas instruções e responde). Você pode mudar o tipo depois.

    Formulário de identidade do agent com as opções de tipo LLM, Sequencial, Paralelo e Loop

    Formulário de identidade do agent com as opções de tipo LLM, Sequencial, Paralelo e Loop

  4. Escreva as instruções do Agent. Esse é o coração da configuração — é aqui que você "treina" seu atendente. Explique em linguagem natural: quem ele é, como deve se comportar, quais temas pode responder e quais deve recusar.

    Exemplo:

    Você é um assistente de atendimento da empresa Advocacia Silva. 
Responda dúvidas sobre nossos serviços de forma educada e objetiva.
Não forneça aconselhamento jurídico específico — oriente o cliente a agendar uma consulta.
    Campo Instrução (System Prompt) do Agent preenchido com um exemplo de instrução, na aba Identidade.

    Campo Instrução (System Prompt) do Agent preenchido com um exemplo de instrução, na aba Identidade.

  5. Selecione o modelo de IA na seção "Modelo". Escolha o provedor (ex.: OpenAI) e o modelo (ex.: gpt-4o). Para a maioria dos casos, as configurações padrão já funcionam bem.

    Seção Modelo no formulário de identidade do agent

    Seção Modelo no formulário de identidade do agent

  6. Salve e teste o Agent. Use o botão Testar (ou o painel de chat lateral) para enviar uma mensagem e ver como ele responde. Ajuste as instruções se necessário.

  7. Publique o Agent quando estiver satisfeito com o comportamento. A partir daí, ele pode ser chamado dentro de um fluxo ou vinculado a um canal de atendimento.

    Revisão e publicação do Agent — confirmação antes de ativar o fluxo

    Revisão e publicação do Agent — confirmação antes de ativar o fluxo

Próximos passos ​

Agora que seu Agent está no ar, você pode aprofundar cada área:

  • Instruções e modelo — como escrever boas instruções e configurar o modelo de IA
  • Memória — fazer o Agent lembrar de conversas anteriores
  • Conhecimento — conectar documentos e bases de dados ao Agent
  • Guardrails — definir regras de segurança e comportamento
  • Ferramentas — dar superpoderes ao Agent (busca web, conexões externas, MCP)