Construir o agente

Ferramentas e variáveis

O que o agente pode fazer além de responder, e como ele guarda informações durante a conversa.

Ferramentas dão ao agente ações. Você as adiciona na aba Ferramentas e escreve, para cada uma, uma descrição que diz ao modelo quando usá-la.

Ferramentas disponíveis

Ferramentas do agente
Ferramenta	Para que serve
Conhecimento	Consultar as bases ligadas ao agente.
HTTP	Chamar uma API sua ou de terceiros no meio da conversa.
Solicitar humano	Passar a conversa para uma pessoa do time.
Marcar como resolvida	Encerrar o atendimento quando o cliente confirmar que deu certo.
Google Calendar	Oferecer horários e marcar reuniões, usando as suas credenciais do Google.
Variáveis	Guardar dados da conversa, como nome e número do pedido.
Follow Up	Retomar o contato com quem parou de responder.

Ferramenta HTTP

Defina o método (GET, POST, PUT, PATCH ou DELETE), o endereço, os cabeçalhos, os parâmetros e o corpo.
Use {{variavel}} em qualquer campo para o agente preencher com dados da conversa.
O botão Teste de API faz uma chamada de ensaio e mostra a resposta.
Com Aprovação necessária ligada, a chamada só acontece depois que uma pessoa aprova na conversa.

Cuidado com os dados

O modelo decide quando chamar uma ferramenta. Evite ligar ações que apagam ou alteram dados sem a aprovação necessária.

Variáveis

Com a ferramenta Variáveis, você define nomes (em letras minúsculas e sublinhado, como nome_cliente) e uma descrição que ensina o agente o que guardar. O valor fica salvo na conversa e pode ser usado com {{nome_cliente}} nas instruções, nos estágios, nas ferramentas HTTP e nos follow-ups.

Variáveis personalizadas: as que você cria.
Variáveis globais do canal: user-name, user-email e user-phone-number.
Variáveis de runtime: today, conversation-id, status, priority, channel, total-messages e created-at.

Uma variável sem atividade por 30 dias expira. O Chat de teste mostra os valores em tempo real.

Quando souber o nome do cliente, chame-o pelo nome.
O número do pedido é {{numero_pedido}}.
Hoje é {{today}}.

Ferramentas disponíveis

Ferramentas do agente
Ferramenta	Para que serve
Conhecimento	Consultar as bases ligadas ao agente.
HTTP	Chamar uma API sua ou de terceiros no meio da conversa.
Solicitar humano	Passar a conversa para uma pessoa do time.
Marcar como resolvida	Encerrar o atendimento quando o cliente confirmar que deu certo.
Google Calendar	Oferecer horários e marcar reuniões, usando as suas credenciais do Google.
Variáveis	Guardar dados da conversa, como nome e número do pedido.
Follow Up	Retomar o contato com quem parou de responder.

Ferramenta HTTP

Defina o método (GET, POST, PUT, PATCH ou DELETE), o endereço, os cabeçalhos, os parâmetros e o corpo.

Use {{variavel}} em qualquer campo para o agente preencher com dados da conversa.

O botão Teste de API faz uma chamada de ensaio e mostra a resposta.

Com Aprovação necessária ligada, a chamada só acontece depois que uma pessoa aprova na conversa.

Cuidado com os dados

O modelo decide quando chamar uma ferramenta. Evite ligar ações que apagam ou alteram dados sem a aprovação necessária.

Variáveis

Variáveis personalizadas: as que você cria.

Variáveis globais do canal: user-name, user-email e user-phone-number.

Variáveis de runtime: today, conversation-id, status, priority, channel, total-messages e created-at.

Uma variável sem atividade por 30 dias expira. O Chat de teste mostra os valores em tempo real.

Quando souber o nome do cliente, chame-o pelo nome.
O número do pedido é {{numero_pedido}}.
Hoje é {{today}}.