Utilizar pedidos para fazer com que o seu agente ou fluxo de agentes realize tarefas específicas

Pode criar pedidos personalizados para configurar instruções para o Azure OpenAI Service ou para o modelo Azure AI Foundry para o seu agente personalizado.

Pode adicionar pedidos personalizados a um agente em qualquer um destes dois níveis:

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

Também pode adicionar um pedido personalizado como nó num fluxo de agentes. Isto permite-lhe chamar um pedido em qualquer ponto do fluxo.

Adicionar um pedido como ferramenta a um agente

1. Selecione Agentes no painel à esquerda e selecione o agente ao qual pretende adicionar um novo pedido como ferramenta.

2. Selecione o separador Ferramentas.

3. Selecione Nova ferramenta.

4. Selecione Pedido.

   O editor de pedidos personalizados é aberto. Pode utilizar este editor para criar um pedido personalizado para o seu agente.

Adicionar um nó de pedido num tópico

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

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

3. Selecione Adicionar uma ferramenta>Novo pedido.

   O editor de pedidos personalizados é aberto. Pode utilizar este editor para criar um pedido personalizado para o seu agente.

Adicionar um nó pedido a um fluxo de agentes

1. Selecione Fluxos no painel de navegação esquerdo e selecione o fluxo de agente que quer modificar.

2. Selecione o ícone Inserir nova ação no ponto do fluxo onde quer adicionar o novo nó. O painel Adicionar uma ação é aberto.

3. Em Capacidades de IA, selecione Executar um pedido.

   Um nó Executar um pedido é adicionado à tela de fluxos.

4. Se quiser adicionar um pedido existente, selecione esse pedido da lista. Para adicionar um novo pedido, selecione Novo pedido personalizado.

   O editor de pedidos personalizados é aberto. Pode utilizar este editor para criar um pedido personalizado para o seu agente.

Configurar e testar um pedido com o editor de pedidos

O editor de pedidos personalizados é uma ferramenta poderosa que permite criar, personalizar e testar modelos de pedidos para o seu agente. O editor de pedidos foi concebido para ajudar a criar pedidos eficazes para o seu agente.

O editor de pedidos permite escrever as instruções do pedido de várias formas. Pode:

• Escrever as suas próprias instruções manualmente
• Utilizar o Copilot para gerar instruções com base na sua descrição do que pretende que o pedido faça
• Utilizar um modelo predefinido da biblioteca de pedidos para criar um pedido

Pode configurar vários aspetos do pedido, incluindo:

• Modelo de chat a utilizar para o pedido, e definições do modelo, tais como temperatura, definições para obtenção de conhecimento, se devem ser incluídas ligações na resposta e se o intérprete de código e a racionalização devem ser ativados.
• Entradas de utilizador para o pedido, como texto e imagens, e dados de exemplo para testar.
• Conhecimento para processar e incluir a partir de tabelas Dataverse.
• Formatação a aplicar à saída.

Quando terminar de criar o seu pedido, pode testá-lo especificando dados de amostra para quaisquer entradas e selecionando Testar. O editor gera uma resposta a partir do pedido e dos dados de exemplo fornecidos.

Para obter detalhes completos sobre como usar o editor para criar e testar pedidos, consulte Criar um pedido personalizado, na documentação do construtor de pedidos.

Melhores práticas para instruções de pedidos

Ao usar o nó de pedido, é importante seguir as melhores práticas para a engenharia de pedidos. Eis algumas sugestões para o ajudar a tirar o máximo partido desta caraterística:

• Seja específico: As instruções personalizadas devem ser 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.
• Utilize exemplos: Forneça exemplos para ilustrar as suas instruções e ajudar o agente a compreender as suas expectativas. Os exemplos ajudam o agente a gerar respostas precisas e relevantes.
• Simplifique: Evite sobrecarregar as suas instruções personalizadas com demasiados detalhes ou lógica complexa. Mantenha as suas instruções simples e diretas para que o agente as possa processar eficazmente.
• Seja breve: As instruções personalizadas devem ser concisas e diretas. As instruções demasiado longas podem causar latência, tempos limite ou problemas no processamento do pedido.
• Dê ao agente uma saída: Dê ao agente um caminho alternativo para quando este não conseguir concluir a tarefa atribuída. Por exemplo, quando o utilizador fizer uma pergunta, pode incluir «responde "não encontrado" se a resposta não estiver disponível». Esse caminho alternativo ajuda o agente a evitar gerar respostas falsas.
• Teste e refine: É importante testar cuidadosamente as suas instruções personalizadas para garantir que estão a funcionar como previsto. Faça ajustes conforme necessário para melhorar a precisão e a eficácia das respostas do seu agente.