Compartilhar via

Ciclo de vida de desenvolvimento do agente

O ciclo de vida de desenvolvimento do agente no Microsoft Foundry abrange desde a criação inicial até o monitoramento de produção. Seguir esse ciclo de vida ajuda você a criar agentes confiáveis, detectar problemas mais cedo e enviar com confiança. Use o portal do Foundry ou o código para criar, personalizar e testar o comportamento do agente. Em seguida, faça iterações com rastreamento, avaliação e monitoramento para melhorar a qualidade e a confiabilidade. Quando estiver pronto, publique seu agente como um aplicativo de agente para compartilhá-lo e integrá-lo aos seus aplicativos.

Este artigo é para desenvolvedores que desejam criar, testar e enviar agentes prontos para produção.

Pré-requisitos

Ciclo de vida em um relance

Use esse ciclo de vida como uma lista de verificação prática ao compilar e enviar um agente.

  1. Escolha um tipo de agente: comece com um agente baseado em prompt, um fluxo de trabalho ou um agente hospedado.
  2. Crie seu agente e comece a testar: experimente no playground ou no código.
  3. Adicionar ferramentas e dados: anexe ferramentas para recuperação e ações e valide a configuração antes de salvar.
  4. Salvar alterações como versões: capturar marcos significativos e comparar versões.
  5. Depurar com rastreamento: Use o rastreamento para confirmar chamadas de ferramentas, latência e comportamento de ponta a ponta. Para obter detalhes, consulte a visão geral do rastreamento do agente.
  6. Avaliar a qualidade e a segurança: execute avaliações repetíveis para capturar regressões antes da publicação. Para obter diretrizes conceituais, consulte Avaliações de agentes.
  7. Publicar e integrar: publicar um endpoint estável e integrá-lo ao seu aplicativo. Para obter etapas, consulte Publicar e compartilhar agentes no Microsoft Foundry.
  8. Monitorar e iterar: monitore o desempenho e a qualidade na produção, depois, atualize e republique conforme necessário. Para obter diretrizes, consulte Qualidade e segurança do Monitor.

Tipos de agente no Microsoft Foundry

Há três tipos de agentes:

  • Baseado em prompt: um agente baseado em prompt é um agente único definido declarativamente que combina configuração de modelo, instruções, ferramentas e prompts de linguagem natural para conduzir o comportamento. Estenda-o anexando ferramentas para conhecimento e memória. Edite, versione, teste, avalie, monitore e publique agentes baseados em prompt do playground de agentes no portal do Foundry.

  • Fluxo de trabalho: use fluxos de trabalho para criar um fluxo de trabalho mais avançado que orquestra uma sequência de ações ou coordena vários agentes. Os fluxos de trabalho têm sua própria interface no portal, mas o mesmo ciclo de vida se aplica. Para obter detalhes, consulte Criar um fluxo de trabalho no Microsoft Foundry.

  • Hospedados (versão prévia): os agentes hospedados são agentes em contêineres que você cria no código usando estruturas compatíveis ou código personalizado. O serviço Foundry Agent implanta e gerencia esses agentes. Você não edita agentes hospedados na interface do usuário de criação de agente, mas ainda pode invocá-los, avaliar, monitorar e publicá-los. Para obter detalhes, confira O que são agentes hospedados?

Crie agentes e fluxos de trabalho baseados em prompt no portal do Foundry ou em seu próprio ambiente de desenvolvimento usando a CLI, o SDK ou a API REST. Para obter mais informações, confira o Início Rápido.

Criando um agente baseado em prompt

Se você já souber que tipo de agente deseja criar, nomeie-o e, em seguida, comece a configurar suas instruções e ferramentas de modelo.

Observação

Depois de nomear seu agente, você não poderá alterar o nome. No código, você se refere ao seu agente por <agent_name>:<version>.

Desenvolver agentes por meio de código

Se você preferir trabalhar no código, use maneiras compatíveis de colocar o código do agente em um ambiente de desenvolvimento do qual você pode testar localmente e, em seguida, implantar no Azure.

Na guia Código no painel de chat do playground do agente, você pode transferir um trecho de código que referencia seu agente para um ambiente na nuvem dedicado do Visual Studio Code para a Web. O snippet vem pré-configurado com os pacotes e extensões de que você precisa, juntamente com instruções para desenvolver e implantar com eficiência seu agente do Foundry no Azure. Você também pode copiar o snippet de código diretamente para seu ambiente de desenvolvimento preferido. Para obter detalhes, confira a documentação do playground.

Principais funcionalidades para o ciclo de vida de desenvolvimento do agente

A experiência de criação do agente oferece experiências integradas para cada etapa principal do ciclo de vida de desenvolvimento do agente. Use esses recursos principais à medida que você desenvolve seu aplicativo de agente pronto para produção. Cada funcionalidade tem uma documentação detalhada em que você pode saber mais.

Salvar alterações como versões

Depois de criar a primeira versão de um agente baseado em prompt ou de um fluxo de trabalho, salve as alterações subsequentes como novas versões. Você pode testar alterações não salvas no playground do agente. Porém, se você quiser exibir o histórico de conversas, monitorar o desempenho do agente ou executar avaliações completas, precisará salvar suas alterações.

O controle de versão do agente fornece os seguintes recursos para gerenciar configurações e iterações do agente. Esse sistema garante que todas as alterações sejam controladas, testáveis e comparáveis entre versões.

  • Imutabilidade de versão: cada versão de um agente é imutável depois que você a salva. Todas as modificações em uma versão existente exigem salvar e criar uma nova versão. Esse requisito ajuda a garantir a integridade da versão e impede substituições acidentais.

  • Gerenciamento de estado de rascunho: você pode realizar testes de agentes em um estado não salvo para experimentação. Você perderá alterações não salvas se sair do portal do Foundry, portanto, salve com frequência para preservar modificações importantes.

  • Operações de controle de versão: você pode direcionar solicitações para versões específicas do agente para habilitar recursos de implantação e reversão controlados.

  • Navegação no histórico de versões: acesse o histórico de versões de qualquer agente, acesse qualquer versão específica e execute as seguintes comparações:

    Comparação de tipo DESCRIÇÃO
    Configuração do agente Comparar as configurações entre versões usando a lista suspensa de versão
    Saída do chat Analisar diferenças de resposta entre versões do agente usando entradas idênticas
    Definição de YAML Examinar as diferenças nas definições do agente

Adicionar ferramentas

Torne seu agente mais poderoso fornecendo-lhe conhecimento (arquivos ou índices específicos) ou permitindo que ele execute ações (chamando APIs externas). As ferramentas estão disponíveis para a maioria dos casos de uso, desde uploads de arquivos simples até conexões de servidor mcp (protocolo de contexto de modelo) personalizadas. Para ferramentas mais complicadas, talvez seja necessário configurar a autenticação ou adicionar conexões como parte da anexação a um agente.

Para salvar um agente com uma ferramenta anexada, você deve configurar a ferramenta com êxito. Reutilize as ferramentas configuradas entre agentes. Para obter informações sobre as ferramentas disponíveis, consulte o catálogo de ferramentas.

Depurar e validar usando o rastreamento (versão prévia)

À medida que você adiciona ferramentas e itera em prompts, use o rastreamento para validar o comportamento de ponta a ponta:

  • Confirme se as ferramentas esperadas foram utilizadas pelo agente.
  • Inspecione as entradas e saídas da ferramenta.
  • Identifique hotspots de latência entre chamadas de modelo e ferramenta.

Para obter mais informações, consulte a visão geral do rastreamento do agente.

Avaliar qualidade e segurança (versão prévia)

Antes de publicar seu agente (e depois de qualquer alteração significativa), execute avaliações para detectar regressões e medir a qualidade de forma consistente nas diferentes versões.

Monitorar após a publicação

Depois de publicar um aplicativo de agente, trate-o como um software de produção:

  • Monitore sinais de qualidade e segurança.
  • Examine os rastreamentos quando o comportamento for alterado.
  • Atualize e republice após corrigir problemas ou implementar melhorias.

Para obter diretrizes, consulte Qualidade e segurança do Monitor.

Planejar a identidade e as permissões

Ferramentas e recursos downstream geralmente exigem autenticação. Quando você publica um agente, sua identidade e seu modelo de permissão pode mudar. Garanta que o agente publicado tenha apenas o acesso necessário.

Para obter detalhes, consulte os conceitos de identidade do Agente no Microsoft Foundry.

Segurança e acesso

Trate a configuração do agente como o código do aplicativo. Proteja segredos e permissões durante todo o ciclo de vida:

Publicar seu agente ou fluxo de trabalho

Depois de criar um agente ou uma versão de fluxo de trabalho com a qual você está satisfeito, publique-o como um aplicativo de agente. Você obtém um ponto de extremidade estável que pode abrir e testar no navegador, compartilhar com outras pessoas ou inserir em seus aplicativos existentes. Você e seus colaboradores podem validar o desempenho e identificar o que precisa de refinamento. Faça as atualizações necessárias e republice uma nova versão a qualquer momento.

Importante

As permissões atribuídas à identidade do projeto não são transferidas automaticamente para o agente publicado. Após a publicação, reatribua os privilégios necessários à identidade do aplicativo agente.

Armadilhas comuns de desenvolvimento de agente

  • As alterações não salvas são temporárias: se você quiser comparar versões, exibir histórico ou executar avaliações completas, salve as alterações como uma versão.
  • As ferramentas devem ser configuradas antes de salvar: se uma ferramenta exigir autenticação ou uma conexão, conclua a instalação antes de salvar.
  • A publicação pode exigir atualizações de permissão: após a publicação, verifique novamente o acesso de recursos para a identidade do agente publicado e remova qualquer acesso que o agente não precise mais.

Conteúdo relacionado

Saiba mais sobre os tipos de agente:

Configurar e estender agentes:

Publicar e monitorar agentes:

Depurar e avaliar:

  • Last updated on