Mensagens do Sistema e Ferramentas
- Como adicionar mensagens do sistema que instruem seu agente LLM
- Como configurar ferramentas de chamada de funcao que o agente pode usar
- Como configurar pre-acoes que executam antes do agente processar uma mensagem
Quando voce cria um agente baseado em LLM, tres das quatro abas de configuracao controlam o que o agente sabe, o que ele pode fazer e o que acontece antes de ele responder. Esta pagina cobre as abas Messages, Tools e Actions.
Aba Messages -- Mensagens do Sistema
A aba Messages contem a secao de Mensagens do Sistema. Mensagens do sistema sao as instrucoes que voce da ao modelo de linguagem antes que qualquer conversa com o cliente comece. Elas definem a personalidade, conhecimento, limites e comportamento do agente.
Como as mensagens do sistema funcionam
As mensagens do sistema sao enviadas ao LLM no inicio de cada conversa como contexto. O modelo le essas instrucoes e as segue ao gerar respostas. Voce pode adicionar varias mensagens do sistema, e elas sao processadas em ordem.
Adicionando mensagens do sistema
- Abra seu agente LLM e va para a aba Messages.
- Voce vera uma area de lista para mensagens do sistema.
- Clique no botao "Add Item" para adicionar uma nova mensagem do sistema.
- Digite sua instrucao no campo de texto que aparece.
- Repita para adicionar quantas mensagens do sistema forem necessarias.
Dicas para escrever mensagens do sistema eficazes
- Identidade: Diga ao agente quem ele e. Exemplo: "Voce e o assistente virtual do Bella Salon, um estudio de cabelo e beleza no centro de Lisboa."
- Conhecimento: Forneca fatos importantes. Exemplo: "Nossos servicos incluem cortes de cabelo (a partir de 25 euros), coloracao e penteados. Funcionamos de terca a sabado, das 9h as 19h."
- Tom: Defina o estilo de comunicacao. Exemplo: "Seja amigavel, profissional e conciso. Use o primeiro nome do cliente quando possivel."
- Limites: Defina o que o agente nao deve fazer. Exemplo: "Nunca discuta precos de concorrentes. Nao faca afirmacoes medicas ou juridicas. Se nao tiver certeza, ofereca conectar o cliente com um atendente humano."
- Encaminhamento: Explique quando transferir. Exemplo: "Se o cliente pedir para falar com uma pessoa, ou se voce nao conseguir resolver a questao em 3 trocas, transfira a conversa para um agente humano."
Usando variaveis dinamicas em mensagens do sistema
As mensagens do sistema suportam expressoes CEL que inserem informacoes dinamicas em tempo de execucao. Isso permite personalizar o comportamento do agente com base no cliente, na mensagem recebida ou na conversa.
Para usar uma variavel dinamica em uma mensagem do sistema:
- Ative o interruptor CEL em uma mensagem do sistema para habilitar o modo de expressao.
- Escreva uma expressao CEL usando as variaveis disponiveis.
Variaveis disponiveis:
| Variavel | Descricao |
|---|---|
client | Informacoes do cliente (nome, telefone, email, tags, campos personalizados) |
contactMessage | A mensagem recebida (tipo, conteudo de texto, midia, timestamp) |
conversation | A sessao de chat (canal, status, ultima mensagem) |
company | O registro da sua empresa |
Exemplos:
- Personalizando saudacoes:
ffConcat('The customer name is ', client.name) - Incluindo tags do cliente:
ffConcat('Client tags: ', client.tags) - Comportamento condicional baseado no tipo de mensagem:
contactMessage.type == 'text' ? contactMessage.body.text : '(media message)'
Use o painel CEL Explorer para navegar por todas as variaveis disponiveis e suas propriedades. Clique em uma variavel para ver seus subcampos e inseri-los na sua expressao.
Aba Tools -- Chamada de funcao
A aba Tools permite dar ao seu agente a capacidade de chamar funcoes externas durante uma conversa. Isso e conhecido como "chamada de funcao" ou "uso de ferramentas" e permite que o agente busque dados, faca calculos, verifique disponibilidade, crie agendamentos e muito mais.
Escolha de ferramenta
No topo da aba Tools, voce encontrara a secao Tool choice com um dropdown Type. A configuracao padrao e "auto", o que significa que o modelo decide por conta propria quando chamar uma ferramenta com base no contexto da conversa. Outras opcoes podem permitir forcar o uso de ferramentas ou desativa-lo.
Adicionando ferramentas
- Va para a aba Tools no seu agente LLM.
- Na lista de Tools, clique no botao "Add Item".
- Configure a ferramenta fornecendo seu nome, descricao e esquema de parametros. A descricao e critica porque o LLM a le para decidir quando e como usar a ferramenta.
- Repita para cada ferramenta que deseja que o agente acesse.
Exemplos de ferramentas
| Ferramenta | Proposito |
|---|---|
| Verificar disponibilidade do calendario | Permite que o agente consulte horarios de consulta disponiveis |
| Criar agendamento | Permite que o agente agende uma consulta para o cliente |
| Buscar registro do cliente | Recupera detalhes do cliente do seu banco de dados |
| Enviar notificacao | Envia um alerta para um membro da equipe |
Comece com uma ou duas ferramentas essenciais e teste completamente antes de adicionar mais. Cada ferramenta aumenta a capacidade do agente, mas tambem adiciona complexidade. O modelo precisa de descricoes claras das ferramentas para usa-las corretamente.
Aba Actions -- Pre-acoes
A aba Actions permite configurar Pre-acoes -- etapas que executam automaticamente antes do LLM processar cada mensagem recebida. Pre-acoes podem transformar dados, chamar APIs, definir variaveis ou executar outra logica para preparar o contexto para a IA.
Se voce precisar de um guia campo a campo dos tipos de acao disponiveis, veja a Referencia de Acoes.
Configurando pre-acoes
- Va para a aba Actions no seu agente LLM.
- Voce vera a secao de Pre-acoes.
- Clique em "Add step" para adicionar uma nova etapa de pre-acao.
- Configure a etapa com a logica desejada.
- Adicione etapas adicionais conforme necessario. As etapas executam em sequencia.
Depurando pre-acoes
A aba Actions inclui um botao Debug all. Clicar nele executa todas as etapas de pre-acao em modo de depuracao para que voce possa ver exatamente o que cada etapa faz, quais dados produz e se algum erro ocorre. Isso e inestimavel durante a configuracao e resolucao de problemas.
Use pre-acoes para enriquecer o contexto da conversa antes que a IA responda. Por exemplo, uma pre-acao pode buscar o historico de pedidos recentes do cliente para que o agente possa referencia-lo em sua resposta sem precisar de uma chamada de ferramenta durante a conversa.