Variáveis do prompt e referências a ferramentas
Use $ para inserir variáveis (como o nome do contato) e ! para referenciar ações dentro das instruções do seu agente.
Veja este passo no vídeo · Instruções: o editor
As instruções do seu agente não precisam ser um texto estático. No editor de Instruções você pode inserir variáveis que se preenchem sozinhas com dados do contato e referenciar as ações (ferramentas) que o agente pode executar.
Os dois atalhos do editor
Na aba Instruções, enquanto você escreve o prompt:
- Digite
$para inserir uma variável (por exemplo, o nome do contato). - Digite
!para inserir uma referência a uma ação (uma ferramenta do agente).
Ao digitar qualquer um dos dois, aparece um autocompletar com as opções disponíveis. Escolha uma e ela vira uma "pílula" dentro do texto.
Variáveis mais usadas
As variáveis são agrupadas por origem. Algumas comuns:
$contact.first_name— Nome do contato$contact.last_name— Sobrenome$contact.email— Email$contact.phone— Telefone$contact.language— Idioma do contato$workspace.name— Nome do workspace$conversation.channel_type— Tipo de canal
Em tempo real, $contact.first_name é substituído pelo nome real da pessoa. Se o dado estiver vazio, o agente simplesmente o ignora.
Como inserir uma variável
- Abra o agente e vá até a aba Instruções.
- Posicione o cursor onde quer o dado.
- Digite
$e comece a escrever (ex.:nome). - Escolha a variável na lista (ex.: Nome).
- Salve as alterações.
Exemplo: Cumprimente o cliente pelo nome: $contact.first_name.
Como referenciar uma ação
As ações são as ferramentas que você já configurou na aba Ações personalizadas (agendar uma visita, etiquetar um contato, criar uma oportunidade, etc.).
- No editor de Instruções, digite
!. - Escolha a ação no autocompletar.
- Explique quando ela deve ser usada: "Se o cliente quiser uma visita, use !agendar_visita".
Referenciar a ação não a executa: apenas avisa ao agente que aquela ferramenta existe e em que momento convém usá-la.
Verificação
- Vá até a aba Sandbox.
- Envie uma mensagem que acione o dado ou a ação.
- Veja o Trace: ali aparecem os valores reais injetados e qual ferramenta o agente chamou.
Se não funcionar
- A variável fica vazia: esse contato não tem aquele dado preenchido; teste com um contato completo.
- O autocompletar não aparece: garanta que você digitou
$ou!como primeiro caractere do token, sem espaço antes. - A ação não é executada: confirme que ela está criada e ativa em Ações personalizadas; se você a apagou ou renomeou, a referência no prompt quebra.
Dicas
- Personalizar com
$contact.first_nameaumenta muito a sensação de atendimento humano. - Não exagere nas ações: referencie apenas as que o agente realmente precisa naquela conversa.
Artigos relacionados
Artigos relacionados
-
Crie seu primeiro agente de IA
Aprenda o que um agente de IA faz no Omnifox, como dar instrucoes, conecta-lo a um canal e testa-lo no sandbox antes de falar com clientes reais.
-
Como escrever boas instruções para seu agente de IA
Aprenda a redigir instruções claras para que seu agente de IA responda com o tom, os limites e as ações corretas.
-
Guia completo dos Agentes de IA
Os Agentes de IA a fundo, em 65 capítulos: criar, instruções, ferramentas, conhecimento, comportamento, teste, caixa de entrada, fluxos, análise e consumo, com cada opção explicada.
-
Conectar seu agente de IA ao WhatsApp, Instagram, Messenger e chat do site
Um agente sem canais não atende ninguém. Conecte-o ao seu WhatsApp, Instagram, Messenger ou ao chat do seu site na seção Conexões e ative-o para ele começar a responder.
-
Comece aqui: os Agentes de IA em 8 minutos
O essencial dos Agentes de IA em um vídeo curto: criar um agente, as instruções, ferramentas, conhecimento, canais, o teste, o horário e a passagem para uma pessoa.