Utilizar prompts para fazer seu agente ou fluxo de agente executar tarefas específicas

Note

Este artigo descreve recursos usados em agentes ou fluxos de agentes baseados no harness padrão.

Você pode criar prompts personalizados para configurar instruções para um serviço do Azure OpenAI ou modelo do Fábrica de IA do Azure para seu agente personalizado.

Você pode adicionar prompts personalizados a um agente em qualquer um dos dois níveis:

• Nível do agente
• Nível do tópico

Você também pode adicionar um prompt personalizado como um nó em um fluxo de agente. Essa abordagem permite que você invoque um prompt em qualquer ponto do fluxo.

Adicionar uma solicitação como uma ferramenta a um agente

1. Selecione Agentes no painel esquerdo e selecione o agente ao qual você deseja adicionar um novo prompt como uma ferramenta.

2. Selecione a guia Ferramentas .

3. Selecione Nova ferramenta.

4. Selecione Prompt.

   O editor de prompt personalizado é aberto. Use este editor para criar um prompt personalizado para seu corretor.

Adicionar um nó de prompt em um tópico

1. Selecione Agentes no painel esquerdo e selecione o agente que contém o tópico que você deseja modificar.

2. Abra um tópico e selecione o ícone Adicionar nó sob o nó após o qual você deseja adicionar o novo nó.

3. Selecione Adicionar uma ferramenta>Novo prompt.

   O editor de prompt personalizado é aberto. Use este editor para criar um prompt personalizado para seu corretor.

Note

Os agentes configurados para permitir usuários anônimos (sem autenticação) não podem usar tabelas do Dataverse como fontes de conhecimento. No entanto, você ainda pode especificar parâmetros de entrada para o prompt, escolher o modelo desejado para executar o prompt e definir a temperatura desejada para controlar a aleatoriedade e a criatividade do texto gerado.

Adicionar um nó de prompt em um fluxo de agente

1. Selecione Fluxos no painel esquerdo e selecione o fluxo do agente que você deseja modificar.

2. Selecione o ícone Inserir nova ação no ponto do fluxo em que você deseja adicionar o novo nó. O painel Adicionar uma ação é aberto.

3. Em recursos de IA, selecione Executar um prompt.

   Um nó Executar um prompt é adicionado ao canvas do fluxo.

4. Se você quiser adicionar um prompt existente, selecione esse prompt na lista. Para adicionar um novo prompt, selecione Novo prompt personalizado.

   O editor de prompt personalizado é aberto. Use este editor para criar um prompt personalizado para seu corretor.

Configurar e testar um prompt com o editor de prompts

O editor personalizado de prompts é uma ferramenta poderosa que você pode usar para criar, personalizar e testar modelos de prompts para seu agente. O editor de prompts foi projetado para ajudá-lo a criar prompts eficazes para seu agente.

O editor de prompt permite que você escreva suas instruções de prompt de algumas maneiras diferentes. É possível:

• Escreva suas próprias instruções manualmente
• Use o Copilot para gerar instruções para você com base na descrição do que você deseja que o prompt faça
• Usar um modelo predefinido da biblioteca de prompts para criar um prompt

Você pode configurar vários aspectos do prompt, incluindo:

• Modelo de chat a ser usado para o prompt e configurações do modelo, como temperatura, recuperação de conhecimento, inclusão de links na resposta e ativação do interpretador de código e raciocínio.
• Entradas do usuário no prompt, como texto e imagens, além de dados de exemplo para teste.
• Conhecimento para processar e incluir usando tabelas do Dataverse.
• Formatação a ser aplicada à saída.

Quando terminar de criar seu prompt, teste especificando dados de amostra para qualquer entrada e selecionando Testar. O editor gera uma resposta com base no prompt e nos dados de exemplo fornecidos.

Aprenda a usar o editor para criar e testar prompts em Criar um prompt personalizado.

Práticas recomendadas para instruções imediatas

Quando você usar o nó de prompt, siga as melhores práticas para engenharia de prompts. Use essas dicas para aproveitar ao máximo esse recurso:

• Seja específico: Deixe instruções personalizadas claras e específicas, para que o agente saiba exatamente o que fazer. Evite linguagem vaga ou ambígua que possa causar confusão ou respostas incorretas.
• Use exemplos: forneça exemplos para ilustrar as instruções e ajudar o agente a compreender as expectativas. Os exemplos ajudam o agente a gerar respostas precisas e relevantes.
• Mantenha simples: Não sobrecarregue suas instruções personalizadas com muitos detalhes ou lógica complexa. Mantenha suas instruções simples e diretas para que o agente possa processá-las de forma eficaz.
• Seja breve: Faça instruções personalizadas concisas e diretas. Instruções que são muito longas podem levar à latência, tempo limite ou problemas ao lidar com o prompt.
• Dê ao agente uma saída: Dê ao agente um caminho alternativo para quando ele não conseguir completar a tarefa atribuída. Por exemplo, quando o usuário faz uma pergunta, você pode incluir "responder com 'não encontrado' se a resposta não estiver presente". Esse caminho alternativo ajuda o agente a evitar a geração de respostas falsas.
• Teste e refine: Teste suas instruções personalizadas cuidadosamente para garantir que elas estejam funcionando como deveria. Faça os ajustes necessários para melhorar a precisão e a eficácia das respostas do agente.

Importante

• Os prompts do construtor de prompts são executados em modelos baseados no Serviço OpenAI do Azure e no Fábrica de IA do Azure.
• Esse recurso é limitado a regiões específicas.
• Esse recurso pode estar sujeito a limites de uso ou limitação de capacidade.