Otimize os prompts dos agentes usando o Prompt Optimizer (pré-visualização)

Use o Prompt Optimizer no Microsoft Foundry para melhorar automaticamente as instruções de sistema do seu agente. O Prompt Optimizer aplica as melhores práticas de engenharia de prompts para reestruturar, clarificar e melhorar as suas instruções. Fornece raciocínio transparente, ao nível de parágrafo, para cada alteração. Pode refinar os resultados iterativamente adicionando sugestões e reotimizando até ficar satisfeito, e depois aplicar o resultado final com um único clique.

Este artigo aborda como usar o Prompt Optimizer no playground do portal Foundry.

Pré-requisitos

• Um projeto Foundry com pelo menos um agente de prompts ou de workflow.
• Um modelo de implementação numa região suportada. A região do seu projeto Foundry determina a disponibilidade de funcionalidades.
• Aceder ao painel de configuração do agente no portal Foundry.

Como funciona o Optimizador de Prompts

O Prompt Optimizer utiliza um processo em vários passos que combina a sua entrada com otimização orientada por LLM:

1. Recolha de entradas: Fornece uma descrição inicial do que o seu agente deve fazer (para agentes novos) ou abre o otimizador com as instruções já existentes. Opcionalmente, pode fornecer sugestões adicionais para orientar a otimização (por exemplo, "Tenha um tom profissional" ou "Torne-o adequado para crianças").

2. Otimização baseada em LLM: Um LLM recebe as suas instruções e quaisquer sugestões. Aplica as melhores práticas de engenharia rápida para reestruturar, clarificar e melhorar as instruções.

3. Geração de raciocínio: Para cada parágrafo modificado, o LLM gera uma explicação do motivo pelo qual a alteração foi feita. Este raciocínio é apresentado juntamente com o texto otimizado para total transparência.

4. Refinamento iterativo: Após a otimização inicial, pode fornecer sugestões adicionais e reotimizar. Cada otimização subsequente usa o texto otimizado mais recente como nova linha de base, combinado com a sua nova sugestão. Repete este ciclo até ficares satisfeito com o resultado.

Open Prompt Optimizer

Para abrir o Prompt Optimizer no portal Foundry, faça o seguinte:

1. Iniciar sessão no Microsoft Foundry. Certifica-te de que a opção New Foundry está ativada.
2. Vai a Construir>Agentes e seleciona o agente que queres otimizar.
3. No painel de configuração do agente, encontre a secção Instruções .
4. Selecione o lápis com o ícone de brilho (✏️✨) ao lado do cabeçalho de Instruções . Esta ação abre a caixa de diálogo do Otimizador de Prompts.

Otimizar as instruções de um novo agente

Se o seu agente ainda não tem instruções:

1. Abrir o Prompt Optimizer. O diálogo mostra uma situação de vazio, pedindo-lhe para descrever o que deseja que o seu agente faça.
2. Na área de texto, introduza uma descrição do propósito e comportamento do seu agente. Por exemplo: "Um assistente de planeamento de viagens que ajuda os utilizadores a planear viagens de vários dias com recomendações de orçamento."
3. Selecione Otimizar. O otimizador gera um conjunto completo de instruções estruturadas do sistema com base na sua descrição.
4. Revê as instruções otimizadas. Os parágrafos alterados são destacados em roxo com uma borda roxa à esquerda.
5. Selecione Usar o prompt para aplicar as instruções otimizadas ao seu agente. O diálogo fecha e o campo Instruções atualiza-se com o texto otimizado.

Otimizar as instruções existentes

Se o seu agente já tem instruções, siga estes passos:

1. Abrir o Prompt Optimizer. O diálogo mostra as tuas instruções originais num cartão com borda.
2. Opcionalmente, introduza uma sugestão na barra de sugestões para orientar a otimização. Por exemplo: "Adicionar guardas para perguntas fora do tema" ou "Tornar o tom mais conversacional."
3. Selecione Otimizar. O otimizador analisa as suas instruções atuais e gera uma versão melhorada.
4. Revê as instruções otimizadas.
5. Selecione Usar prompt para substituir as suas instruções atuais pela versão otimizada. O diálogo fecha e o campo Instruções atualiza-se com o texto otimizado.

Avaliação do raciocínio por trás da otimização

O Prompt Optimizer fornece raciocínio transparente, ao nível do parágrafo, para cada alteração:

• Raciocínio individual: Selecione o ícone do balão de chat (💬) ao lado de qualquer parágrafo alterado para ver porque é que essa alteração específica foi feita. O raciocínio aparece numa caixa realçada em roxo abaixo do parágrafo.
• Mostrar todos os raciocínios: Selecione o botão Mostrar todos os raciocínios para mostrar o raciocínio de cada parágrafo alterado de uma só vez.

Explicações de raciocínio descrevem qual princípio de engenharia de prompts foi aplicado e por que melhora as instruções. Esta informação ajuda-o a compreender e validar cada sugestão antes de a aceitar.

Iterar nas otimizações

Pode refinar o resultado otimizado tantas vezes quanto necessário:

1. Depois de rever as instruções otimizadas, introduza uma nova sugestão na barra de sugestões. Por exemplo: "Encurtar a secção de formato de resposta" ou "Adicionar um comportamento de resposta alternativa quando o utilizador perguntar algo fora do escopo."
2. Selecione Otimizar novamente. O otimizador usa o seu texto otimizado mais recente como nova linha de base e aplica a sua nova sugestão.
3. Repete até ficares satisfeito.
4. Selecione Usar prompt para aplicar o resultado final. O diálogo fecha e o campo Instruções atualiza-se com o texto otimizado.

Regiões apoiadas

Pode usar o Prompt Optimizer em projetos alojados nas seguintes regiões.

• E.U.A. Central
• E.U.A. Leste 2
• Centro de França
• Alemanha Centro-Oeste
• Norte de Itália
• Oeste do Japão
• E.U.A. Centro-Norte
• Polónia Central
• Espanha Central
• Suécia Central
• Oeste da Suíça
• Norte dos E.A.U.
• E.U.A. Oeste
• E.U.A. Oeste 2
• E.U.A. Oeste 3

Em regiões não suportadas, o botão Otimizar não aparece.

Limitações

• Apenas instruções baseadas em texto: O otimizador funciona apenas com instruções de agente baseadas em texto. Não suporta otimização de elementos de configuração não textuais, como definições de ferramentas ou fontes de conhecimento.
• Resultados efémeros: Os resultados de otimização não são mantidos entre sessões. Selecione Utilizar o prompt para aplicar resultados antes de fechar a caixa de diálogo.
• Sem histórico de versões: O otimizador não guarda automaticamente versões anteriores das tuas instruções. Considera copiar as tuas instruções originais antes de otimizar, se quiseres preservá-las.

Melhores práticas

• Comece de forma simples, depois aperfeiçoe: comece com uma breve descrição do propósito do seu agente e deixe o otimizador criar a estrutura inicial. Depois itera com sugestões direcionadas.
• Usa sugestões específicas: Sugestões vagas como "melhora" produzem resultados menos úteis do que algumas específicas como "adicionar tratamento de erros para datas inválidas" ou "restringir respostas apenas ao inglês."
• Reveja o raciocínio antes de aceitar: O raciocínio por parágrafo ajuda-o a detetar alterações que possam não estar alinhadas com o seu caso de uso, mesmo que sigam as melhores práticas de engenharia de prompts.
• Teste após otimização: Depois de aplicar instruções otimizadas, teste o seu agente no playground para verificar se as alterações produzem o comportamento esperado antes de implementar.
• Conserve o seu prompt original: Antes de otimizar, copie as instruções atuais se quiser reverter. Recarregar a página depois de aplicar as alterações restaurará as instruções anteriores, desde que não tenha guardado o agente.
• Faça uma avaliação completa: Depois de otimizar, faça uma avaliação com o seu próprio conjunto de dados para medir se as alterações realmente melhoram o desempenho do seu agente. O Prompt Optimizer aplica as melhores práticas gerais, mas os teus dados de avaliação validam se essas alterações funcionam para o teu caso de uso específico.

Resolução de problemas

Conteúdo relacionado

• Avalie os seus agentes de IA
• Visão geral dos agentes
• Técnicas de engenharia rápida
• Monitorize os agentes com o Painel de Monitorização de Agentes