Como revisar as instruções do Agente de IA

Revise as instruções do seu Agente de IA para identificar problemas de configuração antes de publicar ou atualizar o Agente.

A revisão verifica suas Instruções e as instruções de ação ativadas do Agente de IA em relação à configuração do espaço de trabalho. Ela pode identificar referências inválidas, ações configuradas incorretamente, instruções não suportadas, instruções conflitantes e outros problemas que podem afetar o funcionamento do seu Agente de IA.

Como revisar seu Agente de IA

Vá para Agentes de IA.
Crie um novo Agente de IA ou selecione um existente para editar.
Clique em Revisar.
Aguarde a conclusão da revisão.
Se forem encontrados problemas, selecione Revisar problemas para visualizá‑los.

Você pode revisar os problemas e as correções sugeridas antes de fazer alterações no seu Agente de IA.

O que a revisão verifica

A revisão verifica várias partes da configuração do seu Agente de IA.

Referências e Tokens

A revisão verifica se os itens do espaço de trabalho referenciados em suas instruções existem e são usados corretamente.

Isso inclui:

Campos de Contato:$FieldName
Fluxos de trabalho: !WorkflowName
Usuários e Equipes: @UserName e @TeamName
Tags: %TagName

Por exemplo, um problema pode ser detectado se suas instruções fizerem referência a um Campo de Contato ou Tag que não exista mais.

Para Campos de Contato, a revisão também pode detectar quando um valor de campo é usado sem contexto suficiente para que o Agente de IA entenda o que o valor representa.

Ações do Agente de IA

A revisão verifica se as ações do Agente de IA descritas em suas instruções correspondem às ações configuradas para o Agente de IA.

Problemas podem ser detectados quando:

Suas instruções fazem referência a uma ação que não está ativada.
Uma ação ativada referenciada por suas instruções não possui instruções de ação.
Suas instruções fazem referência a uma ação que não está disponível.
Uma Ação usa um destino inválido, como um
uma ação Atribuir a agente ou equipe sem destino ou uma ação Adicionar comentário que mencione uma equipe ou Agente de IA em vez de um usuário.
Suas instruções se contradizem sobre quando ou como uma ação deve ser usada.

Saiba mais sobre como configurar e usar as ações do Agente de IA. O guia de ações existente já explica o comportamento das ações, como o fato de algumas serem executadas antes das respostas, e a necessidade de usar os nomes exatos dos itens do espaço de trabalho.

Instruções não suportadas

A revisão pode detectar instruções que pedem ao Agente de IA para executar tarefas não suportadas.

Por exemplo:

Ler as Tags existentes de um Contato.
Ler comentários internos.
Encontrar informações em uma Fonte de Conhecimento com base no título do documento em vez do conteúdo.
Enviar tipos de anexo não suportados, como vídeos, notas de voz ou figurinhas.

Para mais informações sobre o que os Agentes de IA podem e não podem acessar, veja Agentes de IA: limitações conhecidas e soluções alternativas.

Instruções de acompanhamento e limites

A revisão verifica se suas instruções permanecem dentro dos limites suportados pelo Agente de IA.

Podem ser detectados problemas para:

Mais de 5 etapas de acompanhamento.
Um acompanhamento agendado para mais de 24 horas após a mensagem anterior.
Ramificações ou várias sequências de acompanhamento paralelas.
Instruções que pedem ao Agente de IA para referir-se a mais do que as últimas 20 mensagens em uma conversa.

Clareza e consistência das instruções

A revisão também verifica se suas instruções fornecem um fluxo claro e consistente para o Agente de IA seguir.

Pode identificar:

Instruções conflitantes para a mesma situação.
Um objetivo ausente ou pouco claro.
Nenhuma condição de saída clara.
Instruções que carecem de estrutura suficiente para o fluxo pretendido.

Para orientações sobre como estruturar suas instruções, veja Como Escrever Prompts Eficazes para Agentes de IA.

Revisar e Corrigir Problemas

Quando problemas são detectados, selecione Revisar para vê‑los em mais detalhes.

Os problemas são agrupados de acordo com onde aparecem, como suas principais Instruções ou uma Ação individual.

Para problemas com uma correção sugerida:

Selecione os problemas que deseja corrigir.
Revise as alterações sugeridas.
Selecione Aplicar correções.
Verifique as alterações propostas antes de confirmá‑las.

Suas instruções não são alteradas até que você confirme as correções. Após a aplicação das correções, as instruções são revisadas novamente em busca de problemas remanescentes.

Ignorar um Problema

Selecione Ignorar se você não quiser tratar um problema durante a revisão atual.

Ignorar um problema:

Remove‑o da lista atual de problemas em aberto.
Não altera as instruções do seu Agente de IA.
Não marca o problema como permanentemente resolvido.

Os problemas ignorados são removidos quando você executa uma nova revisão, portanto um problema pode reaparecer se ainda for detectado.

FAQ e solução de problemas

A Revisão altera automaticamente as instruções do meu Agente de IA?

Não. A Revisão identifica problemas e pode sugerir correções, mas suas instruções não são alteradas até que você revise e confirme as alterações propostas.

A Revisão testa como meu Agente de IA responde aos Contatos?

Não. A Revisão verifica as instruções e a configuração do seu Agente de IA. Ela não testa conversas ao vivo ou o comportamento em tempo de execução real.

A Revisão verifica o conteúdo da minha Fonte de Conhecimento?

Não. A Revisão não lê o conteúdo das suas Fontes de Conhecimento. Em vez disso, ela verifica as instruções do Agente de IA, as instruções das ações e a configuração relevante do espaço de trabalho.

A Revisão verifica se um Workflow está publicado?

Não. A Revisão pode verificar se um Workflow referenciado existe, mas não verifica se esse Workflow está publicado.