Guia de instruções para orquestração generativa

Este artigo fornece orientação sobre como escrever as melhores instruções para seu 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 utilizadas pelo agente das seguintes formas:

• As instruções são usadas quando o agente está decidindo qual ferramenta ou conhecimento pode precisar ser chamado para abordar uma consulta de usuário ou 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 das instruções

É importante entender que os agentes não podem agir de acordo com instruções para usar ferramentas ou pesquisas de fontes 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 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 fonte de conhecimento em um tópico. Certifique-se de que todas as instruções que você dá ao seu agente estão fundamentadas em ferramentas e conhecimentos que você configurou para o seu agente.

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. Os três são combinados em um para fornecer 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 da 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ções

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

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

Antes de adicionar instruções para chamar as ferramentas e a fonte de conhecimento certas 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 perceber que o agente está a contatá-los num momento errado.

Você não precisa definir as ferramentas disponíveis ou a fonte de conhecimento nas instruções, uma vez que essas informações já estão disponíveis para o agente. Você pode usar / ao escrever instruções para especificar uma ferramenta, tópico ou variável específica ou expressão Power Fx para seu 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 nomes específicos para seu agente.

Em vez disso, concentre-se em adicionar instruções apenas para os casos em que você deseja 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 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.

Ajude o agente a preencher dados de entrada para ferramentas

O agente pode chamar uma ferramenta que tenha 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, pede ajuda ao utilizador para preencher as informações em falta.

Nesse cenário, primeiro certifique-se de configurar entradas para seu agente com base nos tipos de interações que você espera que seu agente manipule. Então, apenas em situações em que o agente deve 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, pode utilizar as instruções para indicar ao seu agente quando não deve responder. O agente gerará uma resposta depois de fazer chamadas para ferramentas ou fontes de conhecimento relevantes para o cenário atual. Se activaste Permitir que a IA use o seu próprio conhecimento geral (pré-visualização), o agente pode gerar uma resposta sem chamar qualquer ferramenta ou fonte de conhecimento.

Aqui está um exemplo de como usar as instruções para indicaçõ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ê tiver um tópico específico que não deseja que seu agente discuta, poderá adicionar um tópico para esse cenário com uma resposta criada manualmente. Este 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 as respostas. Por exemplo:

Always give responses about order status in a table format.

Se você quer que seu agente seja profissional e fale educadamente, não é necessário dar instruções para esse tom, pois é o comportamento padrão do agente. Dê apenas instruções de tom para casos de uso específicos.

Instruções baseadas em autonomia

O gráfico a seguir ilustra as etapas tomadas 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 consegue, mas ajuda a 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 'criar ordem', 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 preferido, crie uma ordem de compra usando /Purchase Order." Esta especificidade é útil quando existem inúmeras ferramentas (mais de cinco) adicionadas ao agente.

Numeire ou coloque uma lista com as suas instruções e especifique que devem ser seguidas pela ordem indicada. Você também pode aplicar o formato 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 que a própria ferramenta. Pequenas diferenças na nomenclatura podem afetar negativamente os resultados.

Se você exigir que seu agente seja altamente específico ao responder à entrada do usuário, talvez seja apropriado criar um tópico para lidar com esse caso de uso específico. Por exemplo, criar um tópico que reconheça frases semelhantes a "existem outras opções disponíveis?" O agente então responde 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. Povoar a descrição da ferramenta ajuda significativamente o seu agente a escolher a ferramenta certa. Preencha a descrição da ferramenta para informar o agente quando ligar para uma ferramenta específica, como "chamar esta ferramenta quando o usuário pedir para recuperar o histórico de reservas do cliente".

Os gatilhos podem ser vulneráveis a ataques de jailbreak. Este tipo de ataque ocorre quando um atacante envia instruções para o agente seguir no payload do acionador. Por exemplo, o invasor pode pedir ao agente que envie por e-mail as informações que o agente pode acessar.

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 referenciar fontes de conhecimento. Por exemplo, só envie informações por e-mail depois de verificar o contexto de uma fonte de conhecimento.

• Limite quais parâmetros devem ser usados para ferramentas. Por exemplo, envie apenas uma lista específica de indivíduos por e-mail.

Se você notar que seu 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 instruções de escrita

Use verbos como Get ou Use para recuperar e analisar dados, e verbos como From e With para agir sobre os resultados.

Os seguintes verbos são comumente usados para criar instruções simples:

Ajude o agente a escolher as fontes de conhecimento certas

Para ajudar a garantir que o seu agente obtém com êxito informações de origens de conhecimento, certifique-se de que explica os documentos a procurar nas instruções, como "pesquisa na sua BDC o documento de integração de colaboradores". Embora este tipo de especificidade não seja estritamente necessário, pode ser útil orientar o seu agente. Essa especificidade é útil quando há inúmeros documentos que o agente precisa pesquisar.

Incluir um acionador

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

Pode ser útil dizer ao agente o que fazer com o payload do acionador nas instruções do acionador. Por exemplo, se o seu agente ajudar os novos colaboradores a integrarem-se na sua empresa, defina o payload do acionador como "Integrar o colaborador seguinte". Esta instrução é seguida pelo corpo do seu acionador, que contém os detalhes do novo colaborador. Assim que o agente receber o payload, segue as instruções definidas pelo agente para a inclusão de colaboradores.

Vários gatilhos

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

Formatar correio eletrónico

Instrua o seu agente a "enviar e-mails utilizando a formatação de texto enriquecido 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 o ajudar a conceber experiências fiáveis para os agentes.

Comportamento adaptativo das cartas

As instruções do agente não podem modificar a forma como os Adaptive Cards são ativados.

Em vez disso, se estiver a usar Cartas Adaptativas:

• Edita diretamente o cartão adaptativo.
• Ajusta as frases de gatilho dentro da configuração da carta para controlar quando aparece.

Use perguntas de seguimento

Use perguntas de seguimento para clarificar intenções, recolher os inputs em falta e revelar ações ou conhecimentos relevantes. Isto permite que o agente faça a próxima pergunta correta a seguir, com base no que consegue fazer e no que sabe em tempo de execução.

Para usar perguntas de seguimento, aplicam-se as seguintes ressalvas:

• As perguntas de seguimento só funcionam quando Usar conhecimentos gerais está ativado.
• Se o Usar conhecimentos gerais estiver desligado, o orquestrador considera que as perguntas esclarecedoras que não têm citação são fundamentadas e suprime-as. O agente responde automaticamente à seguinte resposta: "Desculpe, não sei como ajudar com isso. Você pode tentar refrasear?"

Os agentes podem antecipar as necessidades dos utilizadores e sugerir o próximo passo lógico com base nas ferramentas e conhecimentos disponíveis. Por exemplo, um agente que responde "Qual é o tempo hoje em Roma?" pode oferecer "Gostaria de saber a previsão para amanhã também?" e depois agir de acordo com o "sim" do utilizador sem esclarecimento adicional.

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

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

• Ferramentas de referência, conhecimento e variáveis nas instruções para que o agente as possa usar para gerar perguntas de seguimento contextuais. As 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 seguimento relevantes para o contexto atual e para as ferramentas ativas do agente. Isto 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 porquê). Listar as ferramentas disponíveis melhora a relevância e naturalidade das perguntas de seguimento, mesmo que o orquestrador já saiba quais as ferramentas ativas.

Alterar a mensagem de retenção por defeito

Instruções personalizadas não conseguem sobrepor a mensagem de retenção predefinida.

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

Para alterar a mensagem padrão:

1. Navegue até ao tópico Plano B : Tópicos → Sistema → Recurso Alternativo.

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

Termos ambíguos

Evite frases vagas, como "caixa de digitação", nas instruções. Este tipo de termos é ambíguo para o modelo de linguagem e pode levar a comportamentos imprevisíveis.

Recuperação de busca

As 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 de documentos.

Partilha de documentos recuperados

Não podes alterar a forma como os documentos recuperados são partilhados. Este comportamento é controlado pelo sistema.

Suporte multilingue

Instruções a pedir suporte multilíngue podem funcionar, mas não são garantidas. A funcionalidade multilíngue não é testada nem oficialmente suportada.

Principais conclusões

• Use instruções do agente para resumo e fluxo conversacional, não para comportamentos ao nível do sistema.
• Para resoluções e personalização adaptativa das cartas, confie na configuração do tópico em vez das instruções.
• Valide sempre funcionalidades como suporte multilíngue antes de as prometer aos utilizadores.

Conteúdo relacionado

• Orquestre o comportamento do agente com IA generativa
• Descrição geral das origens de conhecimento
• Usar ferramentas com agentes personalizados
• FAQ para usar orquestração generativa