Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 usadas pelo agente das seguintes maneiras:
As instruções são usadas quando o agente está decidindo qual ação ou conhecimento pode precisar ser chamado para endereçar uma consulta do usuário ou um gatilho autônomo.
As instruções também são usadas para preencher entradas para qualquer ação 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 de acordo com instruções para executar ações ou pesquisas na fonte de conhecimento se o agente não tiver essas ações ou fontes de conhecimento. Você deve primeiro configurar seu agente com as ações e fontes de conhecimento apropriadas. Por exemplo, se você der uma instrução para que seu agente pesquise 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. Certifique-se de que todas as instruções fornecidas ao agente estejam fundamentadas nas ações e no conhecimento que você configurou para o 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 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.
Ajudar o agente a determinar as ações apropriadas e o conhecimento para chamar
Antes de adicionar instruções para chamar as ações e a fonte de conhecimento corretas para seu agente, verifique se cada ação e fonte de conhecimento está seguindo as melhores práticas 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.
Não é necessário definir as ações disponíveis ou a fonte de conhecimento nas instruções, pois essas informações já estão disponíveis para o agente. Além disso, você não precisa adicionar instruções quando o agente deve chamar uma ação específica ou fonte de conhecimento. Essas informações fazem parte do nome e da descrição da ação ou da fonte de conhecimento.
Em vez disso, concentre-se em adicionar instruções apenas para os casos em que você deseja dar dicas ao agente quando a ação ou a fonte de conhecimento corretas podem ser ambíguas. Você também pode dar uma instrução que faça referência a várias ações ou fontes de conhecimento.
Use the FAQ knowledge source 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 entradas para ações
O agente pode chamar uma ação que tem parâmetros de entrada que precisam ser preenchidos. Nesse caso, ele usa o histórico de conversas e chamadas anteriores para ações e fontes de conhecimento para determinar quais devem ser as entradas. Caso não identifique todas as entradas, pede ajuda ao usuário para preencher as informações faltantes.
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, 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 para ações ou fontes de conhecimento relevantes para o cenário atual. Se você ativou Permitir que a IA use seu próprio conhecimento geral (versão preliminar), o agente poderá gerar uma resposta sem chamar nenhuma ação 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ê 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. 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ê quer que seu agente seja profissional e fale educadamente, não é necessário dar instruções para esse tom, já que é o comportamento padrão do agente. Dê apenas instruções de tom para casos de uso específicos.
Instruções baseadas em autônomas
O gráfico a seguir ilustra as etapas executadas por um agente com base em instruções autônomas:
Ajudar o agente a escolher a sequência certa de ações
Seu agente tenta selecionar a ação certa e geralmente tem sucesso, mas isso 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 ação "criar ordem", indique isso claramente nas 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 a ação 'Ordem de compra'". Essa especificidade é útil quando há inúmeras ações (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 markdown, que não só melhora a legibilidade de suas instruções, mas também pode ajudar o IA generativa a entender e processar suas instruções.
Observação
Se você não quiser que seu agente entre em contato com o usuário, pode ser útil declará-lo explicitamente nas instruções. Por exemplo, "Não peça detalhes ao usuário".
Ao nomear uma ação nas instruções, certifique-se de usar exatamente o mesmo nome da ação em si. Pequenas diferenças na nomeação 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 "há 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 ação para entender por que usar essa ação. Preencher a descrição da ação ajuda significativamente o agente a escolher a ação certa. Preencha a descrição da ação para informar ao agente quando chamar uma ação específica, como "chamar esta ação quando o usuário solicitar a recuperação do histórico de reservas do cliente".
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 são comumente usados para criar instruções simples:
Meta | Vocabulário |
---|---|
Condições | quando, se, garantir, comparar |
Filtro | de, incluir, excluir, comparar, identificar |
Dados | Fornecer, recuperar, obter, usar, analisar, extrair |
Ações | Notificar, direcionar, perguntar, atribuir |
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 há inúmeros documentos que o agente precisa pesquisar.
Incluir um gatilho
Modifique a carga de gatilho padrão para ajudar seu agente a entender o que fazer quando o gatilho é chamado. 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 email recebido, em vez de toda a carga útil da mensagem.
Observação
Os gatilhos não podem ser editados diretamente no Copilot Studio. Após a criação, você deve editá-los por meio do Power Automate.
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 suas próprias instruções. Essas instruções podem complementar as instruções gerais do agente ou ser usadas para diferentes casos de uso no mesmo agente, como lidar com a integração de funcionários e relatórios de incidentes. Pode ser útil garantir que cada carga útil do gatilho instrua o agente sobre o que fazer quando o gatilho for acionado.
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 ação para dar ênfase extra.