Diretrizes de instrução para orquestração generativa

Este artigo dá orientação sobre como escrever as melhores instruções para o agente quando ele estiver usando orquestração generativa. As instruções são definidas na página Visão geral do seu agente.

As instruções são usadas pelo agente assim:

• Instruções são utilizadas quando o agente está decidindo qual ferramenta ou conhecimento deve ser acionado para tratar uma consulta de usuário ou um gatilho autônomo.

• As instruções também são usadas para preencher entradas para qualquer ferramenta com base no contexto disponível.

• As instruções são usadas quando o agente está gerando uma resposta para o usuário final.

Contexto de instruções

É importante entender que os agentes não podem agir com instruções para usar ferramentas ou pesquisas de fonte de dados de conhecimento se o agente não tiver essas ferramentas ou fontes de conhecimento. Primeiro, você deve configurar seu agente com as ferramentas e fontes de conhecimento apropriadas. Por exemplo, se você fornecer uma instrução para seu agente pesquisar as perguntas frequentes de um site, o agente não poderá seguir essa instrução, a menos que você adicione as perguntas frequentes do site como uma fonte de conhecimento em um tópico. Certifique-se de que as instruções que você dá ao seu agente estão fundamentadas nas ferramentas e no conhecimento que você configurou para ele.

Instruções baseadas em conversação

O exemplo a seguir ilustra como formatar instruções baseadas em conversação, usando uma construção de restrições, formato de resposta e orientação. As três são combinadas 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.

Ajude o agente a determinar as ferramentas e o conhecimento apropriados para chamar

Antes de adicionar instruções para chamar as ferramentas certas e a fonte de conhecimento para seu agente, verifique se cada ferramenta e fonte de conhecimento está seguindo as práticas recomendadas para criar descrições. Para obter os melhores resultados, o nome e a descrição devem ser precisos e específicos, porque esses campos são o que o agente usa para determinar o que chamar. Além disso, 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 disponíveis ou a fonte de conhecimento nas instruções, pois essas informações já estão disponíveis para o agente. Você pode usar / ao escrever instruções para especificar uma ferramenta, um tópico ou uma variável específico ou uma expressão do Power Fx para o agente. No entanto, seu agente também usa nomes e descrições de ferramentas ou fontes de conhecimento para determinar quais usar, portanto, você não precisa especificar quais usar para seu agente.

Em vez disso, concentre-se em adicionar instruções somente para casos em que você deseja dar dicas ao agente quando a ferramenta certa ou a fonte de conhecimento pode ser ambígua. Você também pode fornecer uma instrução que faça referência a várias 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 preencher dados de entrada para ferramentas

O agente pode chamar uma ferramenta que tem parâmetros de entrada que precisam ser preenchidos. Nesse caso, ele usa o histórico de conversas e chamadas anteriores para ferramentas e fontes de conhecimento para determinar quais devem ser as entradas. Caso não identifique 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, você pode usar instruções para dar ao seu agente orientações para quando ele não deve responder. O agente gerará uma resposta depois de fazer chamadas a ferramentas ou fontes de conhecimento relevantes para o cenário atual. Se você tiver ativado Permitir que a IA use seu próprio conhecimento geral (versão prévia), 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 tiver um tópico específico que não deseja que o agente discuta, você poderá adicionar 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, você pode dar 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, não será necessário 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 autônomas

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

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

Seu agente tenta selecionar a ferramenta certa e geralmente é bem-sucedido, mas ajuda a ser explícito em suas instruções. Por exemplo, se você quiser que seu agente crie um registro de pedido 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 tiver fornecido detalhes de seu laptop preferencial, crie uma ordem de compra usando /Pedido de Compra". Essa especificidade é útil quando há várias ferramentas (mais de cinco) adicionadas ao agente.

Numere ou use lista com marcadores para suas instruções e especifique se elas devem ser seguidas na ordem. Você também pode aplicar o formato de markdown, que não só melhora a legibilidade de suas instruções, mas também pode ajudar a IA generativa a entender e processar suas instruções.

Ao 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.

Se você exigir que o agente seja altamente específico ao responder à entrada do usuário, talvez seja indicado criar um tópico para lidar com esse caso de uso em especial. Por exemplo, criando 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 de maneira significativa ajuda o agente a escolher a ferramenta certa. Preencha a descrição da ferramenta para informar ao agente quando chamar uma ferramenta específica, como "chamar essa 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 para enviar por email para si mesmo as informações que o agente pode acessar.

Para proteger seu agente contra esse risco, verifique se as instruções incluem as seguintes informações:

• Limite quais ferramentas o agente deve usar ao referenciar 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 devem ser usados para ferramentas. Por exemplo, só envie e-mail para uma lista especificada de indivíduos.

Se você observar que o agente bloqueia o comportamento normal com a filtragem de conteúdo, você pode atualizar as instruções do agente para indicar que o comportamento deve funcionar.

Linguagem para escrever instruções

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

Os seguintes verbos costumam ser usados para criar instruções simples:

Ajudar o agente a escolher as fontes de conhecimento certas

Para ajudar a garantir que seu agente recupere com êxito informações de fontes de conhecimento, certifique-se de explicar quais documentos procurar nas instruções, como "pesquise o documento de integração do funcionário na Base de Conhecimento". Embora esse tipo de especificidade não seja estritamente necessário, pode ser útil orientar seu agente. Essa especificidade é útil quando existem inúmeros documentos que o agente precisa pesquisar.

Incluir um gatilho

Modifique o conteúdo de gatilho 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 o edite usando o Power Automate para selecionar 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 essa solicitação na descrição da ferramenta para ênfase extra.

Instruções e comportamento do agente

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

Comportamento adaptativo do cartão

As instruções do agente não podem modificar como as Cartas Adaptativas são acionadas.

Em vez disso, se estiver usando Cartas Adaptativas:

• Edite o cartão adaptativo 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 entradas faltantes e destacar ações ou conhecimentos relevantes. Isso permite que o agente faça a próxima pergunta correta em seguida, com base no que ele pode fazer e no que sabe em tempo de execução.

Para usar perguntas de acompanhamento, as seguintes ressalvas se aplicam:

• Perguntas de acompanhamento só funcionam quando o Use conhecimentos gerais está ativado.
• Se usar conhecimento geral estiver desligado, o orquestrador considera que perguntas esclarecedoras que não têm citação são fundamentadas e as suprime. O agente responde com a seguinte resposta: "Desculpe, não sei como ajudar com isso. Você pode tentar reformular?"

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

Essa abordagem reduz caminhos de diálogo codificados fixamente. Em vez disso, transfere o ônus de criar todos os ramos possíveis para orientar o raciocínio do agente com instruções que referenciam suas capacidades.

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

• Ferramentas de referência, conhecimento e variáveis nas instruções para que o agente possa usá-las para gerar perguntas de acompanhamento conscientes do contexto. Instruções suportam diretamente agentes de referência, variáveis, ferramentas, conhecimento e expressões Power Fx.

• Peça ao agente que conclua as respostas com perguntas de acompanhamento relevantes para o contexto atual e para as ferramentas ativas do agente. Isso possibilita 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 reserva padrão

Instruções personalizadas não podem sobrescrever a mensagem de remédio padrão.

A mensagem padrão é: "Desculpe, não sei como ajudar com isso. Você pode tentar reformular?"

Para alterar a mensagem padrão:

1. Navegue até o tópico Reserva:Tópicos → Sistema → Alternativa.

2. Dentro do tópico Reserva , 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 busca

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

Compartilhamento de documentos recuperados

Você não pode mudar como os documentos recuperados são compartilhados. Esse comportamento é controlado pelo sistema.

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

• Use instruções do agente para resumo e fluxo conversacional, não para comportamentos em nível de sistema.
• Para a personalização de cartas de reserva e adaptativa, confie na configuração do tópico em vez das instruções.
• Sempre valide recursos como suporte multilíngue antes de prometê-los aos usuários.

Conteúdo relacionado

• Orquestrar o comportamento do agente com IA generativa
• Visão geral das fontes de conhecimento
• Usar ferramentas com agentes personalizados
• Perguntas frequentes sobre como usar orquestração generativa