Configurar instruções de alta qualidade para orquestração generativa

Este artigo dá orientação sobre como escrever as melhores instruções para o agente quando seu agente usar orquestração generativa. Você define instruções em sua página de Visão geraldo agente.

O agente usa instruções das seguintes formas:

• Para decidir qual ferramenta ou conhecimento chamar para tratar uma consulta do usuário ou trigger autônomo.
• Para preencher entradas para qualquer ferramenta com base no contexto disponível.
• Para gerar uma resposta para o usuário final.

Linguagem para escrever instruções

Use verbos como Obter ou Usar para recuperar e analisar dados, e palavras como De e Com para agir sobre os resultados.

As seguintes palavras costumam ser usadas para criar instruções simples:

Fundamente as instruções em fontes de conhecimento e ferramentas

Os agentes não podem agir seguindo instruções para usar tools or origens de conhecimento se o agente não tiver essas ferramentas ou fontes de conhecimento. Você deve primeiro configurar seu agente com as ferramentas e fontes de conhecimento apropriadas. Por exemplo, se você der uma instrução para seu agente pesquisar nas Perguntas frequentes de um site, o agente não pode seguir essa instrução a menos que você adicione as Perguntas frequentes do site como fonte de conhecimento em um tópico. Certifique-se de que quaisquer instruções que você der ao seu agente estejam fundamentadas em ferramentas e conhecimentos que você configurou para ele.

Ajude o agente a determinar as ferramentas e conhecimentos adequados para chamar

Antes de adicionar instruções para chamar as ferramentas e fontes de conhecimento certas para seu agente, certifique-se de que cada ferramenta e fonte de conhecimento seguem as melhores práticas para criação de descrições. Para obter os melhores resultados, o nome e a descrição devem ser precisos e específicos, porque o agente usa esses campos para determinar o que chamar. Use a descrição para indicar o que não fazer se o agente estiver consultando-os no momento errado.

Você não precisa definir as ferramentas ou as fontes de conhecimento disponíveis nas instruções, já que essa informação já está disponível para o agente. Você pode usar / ao escrever instruções, especificar uma ferramenta, tópico, variável ou expressão Power Fx específica para seu agente. No entanto, seu agente também usa nomes e descrições de ferramentas ou fontes de conhecimento para decidir quais usar, então você não precisa especificar ferramentas específicas para seu agente.

Em vez disso, concentre-se em adicionar instruções apenas para casos em que você queira dar dicas ao agente quando a ferramenta ou fonte de conhecimento certa pode ser ambígua. Você também pode dar uma instrução que faça referência a múltiplas ferramentas ou fontes de conhecimento.

Use the FAQ documents only if the question is not relevant to Hours, Appointments, or Billing.
Only use the ticket creation topic for creating tickets.
For other requests related to fixing issues, use the troubleshooting topic.

Ajudar o agente a escolher as fontes de conhecimento certas

Para ajudar a garantir que seu agente recupere informações com sucesso de fontes de conhecimento, certifique-se de explicar quais documentos devem ser pesquisados nas instruções. Por exemplo, "pesquise seu KB para o documento de integração do funcionário". Embora esse tipo de especificidade não seja rigorosamente necessário, pode ser útil orientar seu agente. Essa tipo de especificidade é útil quando existem inúmeros documentos que o agente precisa pesquisar.

Ajude o agente a escolher a sequência certa de ferramentas

Seu agente tenta escolher a ferramenta certa e geralmente é bem sucedido, mas é bom ser explícito em suas instruções. Por exemplo, se você quiser que seu agente crie um registro de ordem de compra no Dataverse usando a ferramenta create order, use / e adicione essa ferramenta específica às instruções. Nesse cenário, você fornece uma instrução clara: "Quando o usuário fornecer detalhes do laptop que prefere, crie uma ordem de compra usando /Ordem de Compra." Essa especificidade é útil quando há inúmeras ferramentas (mais de cinco) adicionadas ao agente.

Numere ou relacione (usando marcadores) para suas instruções e especifique se o agente deve segui-los na ordem. Você também pode usar o formato Markdown para melhorar a legibilidade de suas instruções e ajudar a IA generativa a entendê-las e processá-las.

Quando você nomear uma ferramenta nas instruções, certifique-se de usar exatamente o mesmo nome da própria ferramenta. Pequenas diferenças na nomenclatura podem afetar negativamente os resultados. Além disso, certifique-se de usar o / ao criar o nome específico da ferramenta (/"Tool_Name").

Se você exigir que o agente seja altamente específico ao responder à entrada do usuário, crie um tópico para lidar com esse caso de uso em especial. Por exemplo, crie um tópico que reconheça frases semelhantes a "há outras opções disponíveis?" O agente acaba respondendo especificamente: "Nenhuma outra opção está disponível no momento. Selecione na lista disponível".

O agente usa a descrição da ferramenta para entender por que usar essa ferramenta. Preencher a descrição da ferramenta ajuda o agente a escolher a ferramenta certa. Adicione uma descrição que informa ao agente quando chamar uma ferramenta específica, como "chame esta ferramenta quando o usuário pedir para recuperar o histórico de reservas do cliente."

Gatilhos podem ser vulneráveis a ataques de jailbreak. Esse tipo de ataque acontece quando um invasor envia instruções para que o agente siga no conteúdo do gatilho. Por exemplo, o invasor pode pedir ao agente que envie por email para si mesmo as informações acessadas pelo agente.

Para proteger seu agente contra esse risco, certifique-se de que suas instruções incluam as seguintes informações:

• Limite quais ferramentas o agente deve usar ao fazer referência a fontes de conhecimento. Por exemplo, somente informações de email após a verificação de uma fonte de conhecimento em busca de contexto.

• Limite quais parâmetros o agente deve usar para as ferramentas. Por exemplo, só envie e-mail para uma lista especificada de indivíduos.

Se você perceber que seu agente bloqueia o comportamento normal usando filtragem de conteúdo, atualize as instruções do agente para indicar que o comportamento deve funcionar.

Ajudar o agente a preencher as entradas das ferramentas

O agente pode chamar uma ferramenta que tem parâmetros de entrada que precisam ser preenchidos. Nesse caso, o agente usa o histórico de conversas e as chamadas anteriores para ferramentas e fontes de conhecimento para determinar quais devem ser as entradas. Se o agente não identificar todas as entradas, ele pede ajuda ao usuário para preencher as informações não encontradas.

Nesse cenário, primeiro configure entradas para o agente com base nos tipos de interações que se espera que o agente processe. Em seguida, apenas em situações nas quais o agente deva preencher a melhor entrada disponível, ele usa as instruções para ajudar a preencher as entradas.

Use the email address from the contact field of the lead when helping the user to draft an email to follow-up on a lead.

Ajudar o agente a gerar uma resposta

Primeiro, use instruções para dar ao seu agente orientações para quando ele não deve responder. O agente gera uma resposta após fazer chamadas para ferramentas ou fontes de conhecimento relevantes para o cenário atual. Se você ativar a configuração Permitir respostas não fundamentadas na seção Conhecimento das configurações de IA generativa do seu agente, o agente poderá gerar uma resposta sem chamar nenhuma ferramenta ou fonte de conhecimento.

Aqui está um exemplo de como usar instruções para proteções:

Only respond to messages that are relevant to Contoso corporation and ordering coffee. 
Otherwise, tell the user you can't help with their inquiry.

Se você não quiser que o agente discuta um tópico específico, adicione um tópico para esse cenário com uma resposta criada manualmente. Esse método evita ter que confiar apenas em instruções para evitar esse tópico.

Em segundo lugar, dê instruções ao agente sobre como ele deve formatar ou estruturar respostas. Por exemplo:

Always give responses about order status in a table format.

Se você quiser que o agente seja profissional e fale educadamente, você não precisa dar instruções nesse tom, já que se trata do comportamento padrão do agente. Só dê instruções de tom em casos de uso específicos.

Instruções baseadas em conversa

O exemplo a seguir mostra como formatar instruções baseadas em conversação, usando uma construção de restrições, formato de resposta e orientação. Combine este três elementos em uma só para oferecer um conjunto completo de instruções para o agente.

Restrições

Only respond to requests to provide information about educational, legal, wellness, wellbeing, health, dental care, and newborn benefits for employees and dependents. 
Respond to benefit types with details, health plan comparisons available for employees and dependents in tabular format.
Answer in bold and underline fonts as necessary.

Formato de resposta

Respond to inquiries by providing benefit types along with details, health plan comparisons available for employees and dependents in tabular format. 
Add a column for available options. 
Include insurance provider details and provide a link for enrollment. 
Answer in bold and underline fonts as necessary.

Orientação

Search only within specific country folders relevant to the employee's country.

Instruções autônomas

O gráfico a seguir ilustra as etapas que um agente executa com base em instruções autônomas:

Instruções e comportamento do agente

Use instruções do agente no Copilot Studio para influenciar o resumo das respostas após a recuperação do documento. Os seguintes equívocos comuns e melhores práticas ajudam você a criar experiências confiáveis com agentes.

Comportamento do Cartão Adaptável

As instruções do agente não podem modificar como os Cartões Adaptáveis são acionados.

Em vez disso, se você usar Cartões Adaptáveis:

• Edite o Cartão Adaptável diretamente.
• Ajuste frases de gatilho dentro da configuração do cartão para controlar quando elas aparecem.

Use perguntas de acompanhamento

Use perguntas de acompanhamento para esclarecer a intenção, coletar informações faltantes e apresentar ações ou conhecimentos relevantes. Quando você usa essa abordagem, o agente faz a próxima pergunta certa com base no que ele pode fazer e no que ele conhece no runtime.

As seguintes ressalvas se aplicam ao usar perguntas de acompanhamento:

• Se a configuração Permitir respostas sem fundamento estiver desativada, perguntas de acompanhamento não funcionam.
• Se você desativar essa configuração, o orquestrador considera perguntas esclarecedoras que não possuem citação como não fundamentadas e as suprime. O agente responde com a seguinte resposta: "Desculpe, não sei como ajudar com isso. Pode tentar reformular?"

Os agentes podem antecipar as necessidades dos usuários e sugerir a próxima etapa lógica com base nas ferramentas e conhecimentos disponíveis para eles. Por exemplo, um agente que responde “Qual é o tempo hoje em Roma?” pode oferecer “Você gostaria de saber a previsão para amanhã também?” e então agir com base no “sim” do usuário, sem necessidade de esclarecimento adicional.

Essa abordagem reduz caminhos de diálogo codificados fixamente. Em vez disso, transfere a responsabilidade de criar todas as possíveis ramificações para orientar a justificativa do agente com instruções que fazem referência direta às capacidades do agente.

Ao usar perguntas de acompanhamento, siga esta estratégia:

• Inclua referências a ferramentas, conhecimento e variáveis nas instruções para que o agente possa usá-los para gerar perguntas de acompanhamento adaptadas ao contexto. As instruções suportam diretamente a referência a agentes, variáveis, ferramentas, conhecimento e expressões do Power Fx.

• Peça ao agente que conclua as respostas com perguntas de acompanhamento relevantes ao contexto atual e às ferramentas ativas do agente. Essa abordagem permite um comportamento adaptativo em vez de fluxos fixos e frágeis.

• Mantenha exemplos e raciocínios visíveis nas instruções para que o agente aprenda o padrão esperado (o que perguntar e por quê). Listar as ferramentas disponíveis melhora a relevância e a naturalidade das perguntas de acompanhamento, mesmo que o orquestrador já saiba quais ferramentas estão ativas.

Alterar a mensagem de fallback padrão

Instruções personalizadas não podem sobrescrever a mensagem de fallback padrão.

A mensagem padrão é: "Infelizmente, não sei como ajudar com isso. Pode tentar reformular?"

Para alterar a mensagem padrão:

1. Acesse o tópico Fallback: Tópicos → Sistema → Fallback.

2. No tópico de Fallback, edite o texto da Mensagem.

Termos ambíguos

Evite frases vagas, como "caixa de digitação", nas instruções. Esses tipos de termos são ambíguos para o modelo de linguagem e podem levar a comportamentos imprevisíveis.

Recuperação de pesquisa

Instruções do agente não podem modificar a lógica de recuperação de pesquisa. Remova quaisquer instruções que tentem influenciar a recuperação do documento.

Compartilhamento de documentos recuperados

Você não pode alterar a forma como os documentos recuperados são compartilhados. O sistema controla esse comportamento.

Incluir um gatilho

Modifique o trigger padrão para ajudar o agente a compreender o que fazer quando o gatilho é invocado. Use variáveis para reduzir o tamanho do conteúdo. Crie o gatilho e edite-o usando o Power Automate e selecione variáveis específicas. Por exemplo, envie apenas o campo de assunto de um email recebido, em vez de toda a carga útil da mensagem.

Pode ser útil dizer ao agente o que fazer com a carga útil do gatilho nas instruções do gatilho. Por exemplo, se o agente ajudar novos funcionários a integrar-se a empresa, defina a carga útil do gatilho como "Integrar o seguinte funcionário". Essa instrução é seguida pelo corpo do gatilho, que contém os detalhes do novo funcionário. Depois que o agente recebe a carga útil, ele segue as instruções definidas para a integração do funcionário.

Vários gatilhos

Você pode adicionar vários gatilhos, cada um com as próprias instruções. Essas instruções podem complementar as instruções gerais do agente ou ser usadas em diferentes casos de uso no mesmo agente, como processar a integração de funcionários e relatórios de incidentes. Pode ser útil garantir que o conteúdo de cada gatilho instrua o agente sobre o que fazer quando o gatilho for disparado.

Formatar emails

Instrua seu agente a "enviar e-mails usando formatação de texto rico para o conteúdo do corpo do e-mail" ou palavras semelhantes. Você também pode adicionar esse pedido na descrição da ferramenta para dar ênfase adicional.

Suporte multilíngue

Instruções solicitando suporte multilíngue podem funcionar, mas não são garantidas. O recurso multilíngue não é testado nem oficialmente suportado.

Principais conclusões

• Mantenha as instruções do agente o mais simples e curtas possível.
• Use instruções do agente para fluxo de resumo e conversa, não para comportamentos em nível de sistema.
• Use a configuração do tópico de fallback e personalização do Cartão Adaptável, em vez de nas instruções.
• Valide recursos como suporte multilíngue antes de prometê-los aos usuários.

Informações relacionadas

• Orquestrar o comportamento do agente com IA generativa
• Resumo de fontes de conhecimento
• Adicionar ferramentas a agentes personalizados
• Perguntas frequentes sobre como usar orquestração generativa