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 este utiliza orquestração generativa. Define as instruções na página de Visão Geral do seu agente.

O agente utiliza as instruções das seguintes formas:

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

Linguagem para instruções de escrita

Use verbos como Get ou Use para recuperar e analisar dados, e palavras como From e With para agir com base nos resultados.

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

Instruções de base em fontes de conhecimento e ferramentas

Os agentes não podem agir segundo instruções para usar 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 fontes de conhecimento certas para o seu agente, certifique-se de que cada ferramenta e fonte de conhecimento segue as melhores práticas para a autoria das descrições. Para obter os melhores resultados, o nome e a descrição devem ser precisos e específicos, pois o agente utiliza estes campos para determinar o que chamar. Use a descrição para indicar o que não deve fazer caso veja o agente a ligar-lhes na hora errada.

Não precisa de definir as ferramentas ou fontes de conhecimento disponíveis nas instruções, pois essa informação já está disponível para o agente. Podes usar / , enquanto escreves instruções, especificar uma ferramenta, tema, variável ou expressão Power Fx específica para o teu 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 recupera com sucesso informações de fontes de conhecimento, certifique-se de explicar quais os documentos a procurar nas instruções. Por exemplo, "procure na sua base de dados o documento de integração de funcionários." Embora este tipo de especificidade não seja estritamente necessário, pode ser útil orientar o seu agente. Este tipo de especificidade é útil quando há 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 ordem de compra no Dataverse usando a create order ferramenta, use / 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, crie uma ordem de compra usando /Purchase Order." Esta especificidade é útil quando existem inúmeras ferramentas (mais de cinco) adicionadas ao agente.

Numere ou liste (usando tópicos) as suas instruções e especifique que o agente deve segui-las por ordem. Também pode usar o formato Markdown para melhorar a legibilidade das suas instruções e ajudar a IA generativa a compreendê-las e processá-las.

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

Se exigir que o seu agente seja muito específico ao responder a inputs dos utilizadores, considere criar um tópico para lidar com este caso de uso específico. Por exemplo, crie um tema que reconheça frases como "existem outras opções disponíveis?" O agente responde especificamente: "Não há outras opções disponíveis neste momento, por favor selecione da lista de disponíveis."

O agente usa a descrição da ferramenta para perceber porque é que deve usar essa ferramenta. Preencher a descrição da ferramenta ajuda o seu agente a escolher a ferramenta certa. Adicione uma descrição que informe o agente quando deve ligar para uma ferramenta específica, como "chamar esta ferramenta quando o utilizador 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 atacante pode pedir ao agente que envie por email 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, envie informações por e-mail somente depois de verificar uma fonte de conhecimento para obter o contexto.

• Limite os parâmetros que o agente deve usar 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 usando filtragem de conteúdo, atualize as instruções do agente para indicar que se espera que o comportamento funcione.

Ajudar o agente a preencher campos para ferramentas

O agente pode chamar uma ferramenta que tem parâmetros de entrada que precisam de ser preenchidos. Neste caso, o agente utiliza 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, 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 após fazer chamadas para ferramentas ou fontes de conhecimento relevantes para o cenário atual. Se ativar a opção Permitir respostas sem fundamento na secção de Conhecimento das definições de IA Generativa do seu agente, o agente pode gerar uma resposta sem recorrer a qualquer ferramenta ou fonte de conhecimento.

Aqui está um exemplo de como usar as diretrizes para estruturas de apoio:

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 quiser que o seu agente discuta um tema específico, adicione um tema para esse cenário com uma resposta manuscrita. Este método evita ter de depender apenas de instruções para evitar esse tópico.

Em segundo lugar, dê ao agente instruções 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 precisa de dar instruções para este tom, pois é o comportamento padrão 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ções usando 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 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çã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 segue 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 de resposta após a recuperação do documento. Os seguintes equívocos comuns e as melhores práticas ajudam-no a criar experiências fiáveis para os agentes.

Comportamento do cartão adaptativo

As instruções do agente não podem modificar a forma como as Cartões Adaptativos são ativadas.

Em vez disso, se usares Cartões Adaptativos:

• Edita diretamente o cartão adaptativo.
• Ajuste as frases de ativação na configuração do cartão para controlar a sua exibição.

Utilizar perguntas de seguimento

Use perguntas de seguimento para clarificar intenções, recolher os inputs em falta e revelar ações ou conhecimentos relevantes. Quando usa esta abordagem, o agente faz a próxima pergunta certa com base no que pode fazer e no que sabe em tempo de execução.

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

• Se a opção Permitir respostas sem fundamento estiver desativada, as perguntas de seguimento não funcionam.
• Se desativares esta definição, o orquestrador considera que as perguntas clarificadoras que não têm citação são sem fundamento 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 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 ó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 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 a referência a agentes, variáveis, ferramentas, conhecimento e expressões Power Fx.

• Peça ao agente que conclua as respostas com perguntas de seguimento relevantes ao contexto atual e às ferramentas ativas do agente. Esta abordagem permite 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 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. Vá ao tópico Fallback: Tópicos → Sistema → Fallback.

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.

Recuperaçã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 gatilho por defeito para ajudar o seu agente a compreender o que fazer quando o gatilho é acionado. Use variáveis para reduzir o tamanho do payload. Cria o gatilho, depois edita-o no Power Automate e seleciona 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 emails usando formatação de texto rico no corpo do email" 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 que pedem suporte multilíngue podem funcionar, mas não são garantidas. A funcionalidade multilingue não é testada nem oficialmente suportada.

Principais conclusões

• Utilize instruções do agente para resumo e fluxo conversacional, não para comportamentos ao nível do sistema.
• Use a configuração dos tópicos para fallback e personalização dos Adaptive Cards em vez de instruções.
• Valide funcionalidades como suporte multilíngue antes de as prometer aos utilizadores.

Informações adicionais

• Orquestre o comportamento do agente com IA generativa
• Resumo das origens de conhecimento
• Adicionar ferramentas a agentes personalizados
• FAQ para usar orquestração generativa