Diretrizes gerais para criar e mapear uma intenção

Versão de lançamento: Australia

Atualizado 12 de mar. de 2026

6 min. de leitura

Ao seguir algumas diretrizes gerais para criar intenções de e-mail e mapear ações para intenções, você pode criar instruções claras e eficazes que ajudam a maximizar a eficiência e a eficácia.

Visão geral da criação e mapeamento de uma intenção

Os agentes de IA e fluxos de trabalho agentivos dependem de LLMs, portanto, a linguagem que você usa para suas instruções é importante. Há muitas etapas que você pode seguir para ajudar a melhorar a qualidade e a consistência de suas soluções de IA do agente.

Diretrizes de intenção

A discussão destaca várias diretrizes cruciais para definir e configurar intenções para garantir a precisão, ajudar a evitar erros de interpretação e otimizar o desempenho do sistema orientado por LLM:

Seja claro, específico e evite imprecisão

Use instruções concisas, claras e precisas. Uma linguagem simples pode ajudar a remover situações ambíguas que podem parar ou interromper o andamento de um agente.
As intenções devem ser altamente específicas e não se sobrepor a outras intenções.
Em vez disso, evite usar apenas palavras-chave ou nomes de tópicos. Descreva a intenção completa do usuário.
Intenções vagas podem confundir o LLM e levar a correspondências incorretas.
Esclarecer limites e limitações.

Tabela 1. Exemplo de intenções claras
Exemplo	Intenção fraca	Intenção específica e forte	Anotações
Cancelamento de assinatura	Usuário que está solicitando o cancelamento da assinatura	Usuário que está solicitando o cancelamento da assinatura de música	Se o seu sistema lida com vários tipos de assinaturas, por exemplo, streaming de música e vídeo, licenças de software, uma intenção vaga, como cancelar assinatura, pode fazer com que o LLM identifique incorretamente qual serviço o usuário deseja cancelar. Uma intenção específica, como cancelar assinatura de música, garante que o LLM entenda o serviço exato, permitindo que o fluxo de trabalho correto seja acionado.
Aprovação de licença	Aprovação de licença	Usuário que está solicitando uma aprovação de licença	A aprovação de licença é um tópico, não uma ação ou intenção do usuário. O LLM precisa entender a intenção do usuário. Ao declarar Usuário que está solicitando uma aprovação de licença, você comunica claramente que o usuário está iniciando uma solicitação, não apenas mencionando um tópico.
Aprovação de licença, incluindo destinatário	Usuário que está solicitando uma aprovação de licença	Usuário que está solicitando uma aprovação de licença para seu colega	Embora o sistema possa assumir como padrão que a solicitação é do remetente do e-mail, declarar explicitamente para o colega fornece um contexto crucial. Isso evita cenários em que uma solicitação feita em nome de outra pessoa é processada incorretamente para o remetente, destacando a necessidade de inteligência para entender o assunto da solicitação.

Contexto e coerência:

A intenção deve articular claramente o que o usuário está pedindo ou solicitando.
Distinguir entre um usuário meramente mencionar algo e solicitar explicitamente uma ação.
Projetar instruções que atendam ao objetivo geral. Todas as suas ferramentas e agentes de IA trabalham juntos para resolver problemas.

Tabela 2. Exemplo de intenções para solicitação explícita do usuário
E-mail do usuário	Correspondência de intenção incorreta	Anotações
Eu acabei de comprar um carro, meu pai estava insistindo em obter uma cotação de seguro de carro	Solicitação de uma cotação de seguro de carro	Neste cenário, o usuário está falando sobre obter uma cotação porque seu pai insistiu, mas ele não solicitou explicitamente uma do sistema. Se uma intenção projetada para gerar uma cotação corresponder a este e-mail, o usuário receberá uma cotação não solicitada, levando a uma experiência ruim e potencialmente confusa. O sistema só deve agir quando a intenção do usuário é uma solicitação direta para essa ação.
E-mail de marketing, talvez eu deva cancelar a assinatura	Solicitando cancelamento de assinatura de e-mails	E-mails de marketing, basta cancelar a assinatura. Esta declaração é sarcástica ou uma expressão casual de frustração, não uma solicitação direta para cancelar a assinatura. Se a intenção for configurada de forma muito ampla, como apenas "cancelar assinatura de e-mail", ela pode acionar incorretamente uma ação de cancelamento de assinatura. A intenção deve ser precisa o suficiente para diferenciar entre uma observação casual e uma solicitação clara e acionável.

Incluir detalhes críticos:

Certifique-se de que a descrição da intenção contenha todos os detalhes críticos que a diferenciem de solicitações semelhantes.
Use formatação consistente. Instruções semelhantes devem usar padrões de linguagem semelhantes.
Detalhes críticos ausentes podem levar a falsos positivos ou falsos negativos.
Se um detalhe puder mudar o significado ou a ação apropriada, ele deverá ser incluído na intenção.
Use terminologia consistente em todo o .

Tabela 3. Exemplos de intenções que incluem detalhes críticos
Intenção fraca	Forte intenção	Anotações
Solicitação de uma cotação de seguro	Solicitação de uma cotação de seguro de carro	Se uma empresa oferecer vários seguros e o fluxo de trabalho associado for projetado especificamente para seguro de carro, a intenção deve incluir CAR. Sem esse detalhe crítico, um e-mail solicitando um tipo diferente de seguro pode corresponder incorretamente à intenção da cotação de seguro, levando a um fluxo de trabalho com falha ou inadequado.
Usuário solicitando dinheiro para casa	Usuário que está solicitando um empréstimo residencial	Solicitar dinheiro é extremamente amplo. Um e-mail como "Eu dei dinheiro na semana passada, me devolva meu dinheiro" (um pedido de reembolso) poderia corresponder incorretamente a essa intenção vaga, mesmo que não seja um pedido de empréstimo imobiliário. Incluir empréstimo imobiliário como um detalhe crítico esclarece a transação financeira específica.

Diferencie entre solicitações de ação e consultas informativas:

Defina claramente se uma intenção é executar uma ação ou fornecer informações.
Isso ajuda a impedir que o sistema execute uma ação quando somente informações são buscadas, ou vice-versa.

Tabela 4. Exemplo de tipo de intenção
E-mail do usuário	Tipo de intenção	Nota
"Minha equipe precisa de software de gravação instalado em nossas novas máquinas. Providencie isso.	Intenção da solicitação de ação	Este e-mail solicita claramente que uma ação seja realizada (instalação de software). Uma intenção configurada como "Usuário solicitando instalação do Adobe Creative Suite" corresponderia corretamente, acionando um fluxo de trabalho para provisionar e instalar o software.
Preciso instalar software de escrita no meu dispositivo pessoal para um projeto. Você pode me dizer como fazer isso?	Intenção da consulta informativa	O usuário não está solicitando que o sistema execute a instalação, mas sim orientações ou instruções. Se existir apenas a intenção de solicitação de ação, ela poderá acionar incorretamente um fluxo de trabalho de instalação ou não fornecer ao usuário as informações solicitadas. Uma intenção separada para o usuário solicitar instruções sobre como instalar o software de gravação corresponderia corretamente e forneceria um link para um artigo da base de conhecimento ou um guia passo a passo.

Ajude o LLM – não faça adivinhar:
- O princípio abrangente é tornar as intenções o mais claras e inequívocas possível para orientar o LLM de forma eficaz.
- O sistema é uma estrutura; sua eficácia depende de quão sabiamente as intenções são configuradas.

Para obter diretrizes mais gerais, consulte General guidelines for creating AI agents and agentic workflows.

Considerações importantes

É recomendável não configurar fluxos de trabalho para produzir artefatos finais diretamente. Em vez disso, os fluxos de trabalho devem criar rascunhos ou artefatos intermediários que exigem revisão e confirmação humana.

Registro de destino para rascunho e e-mail: Se estiver usando o recurso de rascunho de e-mail, um registro de destino deve ser anexado ao e-mail no momento em que o fluxo de trabalho do agente for acionado. Sem um registro de destino, os rascunhos de e-mail gerados não podem ser acessados.
Ordem de execução: Ao habilitar o fluxo de trabalho agentivo via Ação de entrada ou gatilho de e-mail de entrada, considere sua ordem relativa às ações de entrada existentes. A ordem padrão 999 a coloca por último para evitar interferir em outros processos, mas isso pode ser ajustado.
Supervisão humana: O sistema visa remover gargalos e aumentar a eficiência, mas não elimina a necessidade de envolvimento humano. Ele foi projetado para aumentar, não substituir totalmente, os agentes humanos.