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

Este artigo fornece orientações sobre como escrever as melhores instruções para o seu agente quando o agente utiliza orquestração generativa. As instruções são definidas na página Descrição geral do seu agente.

O agente utiliza instruções das seguintes formas:

• Para decidir que ferramenta ou conhecimento chamar para responder a uma consulta do utilizador ou a um acionador autónomo.
• Para preencher entradas para qualquer ferramenta com base no contexto disponível.
• Para gerar uma resposta para o utilizador final.

Linguagem para instruções de escrita

Utilize verbos como Obter ou Utilizar para obter e analisar dados, e palavras como De e Com para agir com base nos resultados.

As seguintes palavras são comumente usadas para criar instruções simples:

Fundamentar instruções em fontes de conhecimento e ferramentas

Os agentes não conseguem agir com base em instruções para utilizar ferramentas ou fontes de conhecimento se o agente não tiver essas ferramentas ou fontes de conhecimento. Deve primeiro configurar o seu agente com as ferramentas e fontes de conhecimento apropriadas. Por exemplo, se der uma instrução para o seu agente pesquisar as FAQ de um site, o agente não pode seguir essa instrução, a menos que adicione as FAQ do site como fonte de conhecimento num tópico. Certifique-se de que quaisquer instruções que dê ao seu agente estão fundamentadas em ferramentas e conhecimentos que configurou para o seu agente.

Ajudar o agente a determinar as ferramentas e os conhecimentos apropriados para chamar

Antes de adicionar instruções para chamar as ferramentas e as fontes de conhecimento corretas para o seu agente, certifique-se de que cada ferramenta e fonte de conhecimento segue as melhores práticas para as descrições de criação. Para obter os melhores resultados, o nome e a descrição devem ser precisos e específicos, porque o agente utiliza esses campos para determinar o que chamar. Utilize a descrição para indicar o que não deve ser feito, caso verifique que o agente os está a chamar no momento inadequado.

Não precisa de definir as ferramentas ou as fontes de conhecimento disponíveis nas instruções, pois essa informação já está disponível para o agente. Pode utilizar / ao escrever instruções para especificar uma ferramenta, um tópico, uma variável ou uma expressão do Power Fx específicos para o seu agente. No entanto, o seu agente também usa nomes e descrições de ferramentas ou fontes de conhecimento para determinar quais usar, portanto, não é necessário especificar nenhum específico para o seu agente.

Em vez disso, concentre-se em adicionar instruções apenas para os casos em que deseja dar dicas ao agente quando a ferramenta ou fonte de conhecimento correta puder ser ambígua. 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 escolher as fontes de conhecimento certas

Para ajudar a garantir que o seu agente obtém com sucesso informações de fontes de conhecimento, certifique-se de que explica, nas instruções, quais os documentos que deve procurar. Por exemplo, "procure na sua BDC o documento de inclusão de colaboradores." Embora este tipo de especificidade não seja estritamente necessário, pode ser útil orientar o seu agente. Este tipo de especificidade é útil quando existem vários documentos que o agente precisa de pesquisar.

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

O seu agente tenta selecionar a ferramenta certa e geralmente tem sucesso, mas ajuda ser explícito nas suas instruções. Por exemplo, se quiser que o seu agente crie um registo de nota de encomenda no Dataverse utilizando a ferramenta create order, utilize / e adicione essa ferramenta específica às instruções. Neste cenário, fornece uma instrução clara: "Quando o utilizador fornecer detalhes do seu portátil preferido, cria uma nota de encomenda utilizando /Nota de Encomenda." Esta especificidade é útil quando existem inúmeras ferramentas (mais de cinco) adicionadas ao agente.

Enumere ou faça uma lista (utilizando marcas de lista) das suas instruções e especifique que o agente deve segui-las por ordem. Também pode utilizar o formato Markdown para melhorar a legibilidade das suas instruções e ajudar a IA generativa a compreendê-las e processá-las.

Quando nomear uma ferramenta nas instruções, certifique-se de que utiliza exatamente o mesmo nome da ferramenta. Pequenas diferenças na nomeação podem afetar negativamente os resultados. Além disso, garanta que utiliza a / na construção do nome específico da ferramenta (/"Tool_Name").

Se precisar que o seu agente seja altamente específico ao responder às entradas de utilizador, considere criar um tópico para processar este caso de utilização específico. Por exemplo, crie um tópico que reconheça frases semelhantes a "há outras opções disponíveis?" O agente responde então especificamente: "Não há outras opções disponíveis no momento, selecione a partir da lista disponível".

O agente usa a descrição da ferramenta para perceber porque é que deve usar essa ferramenta. Povoar a descrição da ferramenta ajuda o seu agente a escolher a ferramenta certa. Adicione uma descrição que informe o agente sobre quando deve chamar uma ferramenta específica, como por exemplo: "chama esta ferramenta quando o utilizador pedir para obter o histórico de reservas do cliente".

Os acionadores 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 atacante pode pedir ao agente que envie por e-mail para si próprio a informação a que o agente pode aceder.

Para proteger o seu agente contra este risco, certifique-se de que as instruções incluem as seguintes informações:

• Limite as ferramentas que o agente deve usar ao referenciar fontes de conhecimento. Por exemplo, apenas informação por e-mail depois de verificar uma fonte de conhecimento para o contexto.

• Limite os parâmetros que o agente deve utilizar para as ferramentas. Por exemplo, envie apenas um e-mail a uma lista específica de indivíduos.

Se notar que o seu agente bloqueia o comportamento normal ao utilizar filtragem de conteúdo, atualize as instruções do agente para indicar que é esperado que esse comportamento funcione.

Ajudar o agente a preencher entradas para ferramentas

O agente pode chamar uma ferramenta que tem parâmetros de entrada que precisam de ser preenchidos. Neste caso, o agente usa o histórico de conversações e chamadas anteriores a ferramentas e fontes de conhecimento para determinar quais devem ser as entradas. Se o agente não identificar todas as entradas, pede ao utilizador que ajude a preencher a informação em falta.

Neste cenário, primeiro certifique-se de que configura as entradas para o seu agente com base nos tipos de interações que espera que o agente processe. Então, apenas em situações em que o agente deve preencher a melhor entrada disponível, 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, utilize as instruções para dar ao seu agente verificadores de integridade sobre quando não deve responder. O agente gera uma resposta depois de fazer todas as chamadas a ferramentas ou fontes de conhecimento relevantes para o cenário atual. Se ativar a definição Permitir respostas não fundamentadas na secção Conhecimento das definições de IA generativa do agente, 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 não quer que o seu agente discuta um tópico específico, adicione um tópico para este cenário com uma resposta criada manualmente. Este método evita ter de depender apenas de instruções para evitar esse tópico.

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

Always give responses about order status in a table format.

Se quiser que o seu agente seja profissional e fale educadamente, não tem de dar instruções para este tom, pois é o comportamento predefinido do agente. Só dê instruções de tom para casos de utilização específicos.

Instruções baseadas em conversação

O exemplo seguinte mostra como formatar instruções baseadas em conversação ao utilizar uma construção de restrições, formato de resposta e orientação. Combine estes três elementos num só para fornecer um conjunto completo de instruções ao 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ção

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

Instruções autónomas

O gráfico seguinte ilustra os passos que um agente dá com base em instruções autónomas:

Instruções e comportamento do agente

Utilize instruções do agente no Copilot Studio para influenciar o resumo das respostas após a obtenção do documento. Os equívocos comuns e as melhores práticas a seguir ajudam a estruturar experiências de agentes fiáveis.

Comportamento do cartão adaptativo

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

Em vez disso, se utilizar Cartões Adaptativos:

• Edita diretamente o cartão adaptativo.
• Ajuste as frases de acionador na configuração do cartão para controlar quando aparece.

Utilizar perguntas de seguimento

Utilize perguntas de seguimento para clarificar a intenção, recolher entradas em falta e identificar ações ou conhecimentos relevantes. Quando utiliza esta abordagem, o agente faz a pergunta certa seguinte com base no que pode fazer e no que sabe em runtime.

As seguintes ressalvas aplicam-se ao utilizar perguntas de seguimento:

• Se a definição Permitir respostas não fundamentadas estiver desativada, as perguntas de seguimento não funcionam.
• Se desativar esta definição, o orquestrador considera perguntas de esclarecimento que não tenham referência como não fundamentadas e suprime-as. O agente responde automaticamente à seguinte resposta: "Desculpe, não sei como ajudar com isso. Pode tentar reformular?"

Os agentes podem antecipar as necessidades dos utilizadores e sugerir o próximo passo lógico com base nas ferramentas e nos conhecimentos disponíveis. Por exemplo, um agente que responda à pergunta "Qual é o estado do tempo hoje em Roma?" pode oferecer "Quer saber também a previsão para amanhã?" e, posteriormente, agir com base no "sim" do utilizador sem necessidade de esclarecimentos adicionais.

Esta abordagem reduz caminhos de diálogo hard-coded. Em vez disso, transfere o ónus da criação de todos os ramos possíveis para a orientação do raciocínio do agente com instruções que fazem referência às capacidades do agente.

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

• Mencione ferramentas, conhecimento e variáveis nas instruções para que o agente possa usá-los para gerar perguntas de seguimento contextuais. As instruções permitem referenciar diretamente agentes, variáveis, ferramentas, conhecimento e expressões do 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. Esta abordagem ativa comportamentos adaptativos 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 são as ferramentas ativas.

Alterar a mensagem de contingência predefinida

As instruções personalizadas não podem substituir a mensagem de contingência predefinida.

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

Para alterar a mensagem predefinida:

1. Aceda ao tópico de Contingência: Tópicos → Sistema → Contingência.

2. No tópico Contingência, 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.

Obtenção de pesquisa

As instruções do agente não podem modificar a lógica de obtenção de pesquisa. Remova quaisquer instruções que tentem influenciar a obtenção de documentos.

Partilha de documentos obtidos

Não pode alterar a forma como os documentos obtidos são partilhados. O sistema controla este comportamento.

Incluir um acionador

Modifique o payload do acionador predefinido para ajudar o seu agente a perceber o que fazer quando o acionador é invocado. Use variáveis para reduzir o tamanho do payload. Crie o acionador, depois edite-o no Power Automate e selecione variáveis específicas. Por exemplo, envie apenas o campo de assunto de um e-mail recebido, em vez do payload completo 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.

Acionadores múltiplos

Podes adicionar vários acionadores, cada um com as suas próprias instruções. Estas instruções podem complementar as instruções gerais do seu agente, ou ser usadas em diferentes casos de uso dentro do mesmo agente, como processar a inclusã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 e-mails

Instrua o seu agente para "enviar e-mails através da a formatação de texto formatado para o conteúdo do corpo do e-mail" ou uma redação semelhante. Também pode adicionar este pedido na descrição da ferramenta para dar mais ênfase.

Suporte multilíngue

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

Principais conclusões

• Mantenha as instruções para os agentes o mais simples e curtas possível.
• Utilize instruções do agente para resumo e fluxo conversacional, não para comportamentos ao nível do sistema.
• Utilize a configuração do tópico para a personalização de contingência e de Cartões Adaptativos em vez de instruções.
• Valide funcionalidades como suporte multilingue antes de as prometer aos utilizadores.

Informações relacionadas

• Orquestrar o comportamento do agente com IA generativa
• Resumo das origens de conhecimento
• Adicionar ferramentas a agentes personalizados
• FAQ sobre a utilização de orquestração generativa