Partilhar via

Ciclo de vida do desenvolvimento do agente

O ciclo de vida do desenvolvimento dos agentes no Microsoft Foundry abrange desde a criação inicial até à monitorização da produção. Seguir este ciclo de vida ajuda-o a construir agentes fiáveis, detetar problemas cedo e enviar com confiança. Use o portal ou código Foundry para construir, personalizar e testar o comportamento do seu agente. Depois, itere com rastreio, avaliação e monitorização para melhorar a qualidade e fiabilidade. Quando estiver pronto, publica a tua aplicação de agente para partilhar e integrar nas tuas aplicações.

Este artigo destina-se a programadores que querem construir, testar e enviar agentes prontos para produção.

Pré-requisitos

Ciclo de vida num olhar

Use este ciclo de vida como uma lista de verificação prática enquanto constrói e envia um agente.

  1. Escolha um tipo de agente: Comece com um agente baseado em prompts, um fluxo de trabalho ou um agente hospedado.
  2. Crie o seu agente e comece a testar: Itere no playground ou em código.
  3. Adicione ferramentas e dados: Anexe ferramentas para recuperação e ações, e valide a configuração antes de guardar.
  4. Guardar as alterações como versões: Registar marcos significativos e comparar versões.
  5. Depurar com rastreamento: Use o rastreio para confirmar chamadas de ferramenta, latência e comportamento de ponta a ponta. Para mais detalhes, veja Visão geral do rastreio de agentes.
  6. Avalie a qualidade e a segurança: Realize avaliações repetíveis para detetar regressões antes de publicar. Para orientações conceptuais, veja Avaliadores de Agentes.
  7. Publique e integre: Publique um endpoint estável e integre-o na sua aplicação. Para os passos, consulte Publicar e partilhar agentes no Microsoft Foundry.
  8. Monitorizar e iterar: Acompanhar o desempenho e a qualidade em produção, depois atualizar e republicar conforme necessário. Para orientações, consulte Monitorizar qualidade e segurança.

Tipos de agentes no Microsoft Foundry

Existem três tipos de agentes:

  • Baseado em prompts: Um agente baseado em prompts é um agente único definido declarativamente que combina configuração do modelo, instruções, ferramentas e prompts em linguagem natural para impulsionar o comportamento. Estende-o anexando ferramentas para conhecimento e memória. Editar, versionar, testar, avaliar, monitorizar e publicar agentes baseados em prompts a partir do playground de Agentes no portal Foundry.

  • Fluxo de trabalho: Use fluxos de trabalho para construir um fluxo de trabalho mais avançado que orquestre uma sequência de ações ou coordene múltiplos agentes. Os fluxos de trabalho têm a sua própria interface no portal, mas aplica-se o mesmo ciclo de vida. Para mais detalhes, consulte Construir um fluxo de trabalho no Microsoft Foundry.

  • Hospedado (pré-visualização): Os agentes alojados são agentes containerizados que se constrói em código usando frameworks suportados ou código personalizado. O Foundry Agent Service implementa e gere estes agentes. Não editas agentes alojados na interface de construção de agentes, mas ainda podes invocá-los, avaliá-los, monitorizá-los e publicá-los. Para mais detalhes, veja O que são agentes alojados?

Crie agentes e fluxos de trabalho baseados em prompts no portal Foundry ou no seu próprio ambiente de desenvolvimento, utilizando a CLI, SDK ou API REST. Para obter mais informações, consulte o guia de início rápido.

Criando um agente baseado em prompt

Se já sabe que tipo de agente quer criar, nomeie-o e depois comece a configurar as instruções e ferramentas do modelo.

Observação

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

Desenvolver agentes em código

Se preferes trabalhar em código, usa métodos suportados para trazer o teu código de agente para um ambiente de desenvolvimento a partir do qual possas testar localmente e depois implementar no Azure.

A partir do separador de Código no painel de chat do playground do agente, pode obter um excerto de código que referencia o seu agente a um Código Visual Studio dedicado para o ambiente web cloud. O snippet vem pré-configurado com os pacotes e extensões de que precisa, juntamente com instruções para desenvolver e implementar eficientemente o seu agente Foundry no Azure. Você também pode copiar o trecho de código diretamente para seu ambiente de desenvolvimento preferido. Para mais detalhes, consulte a documentação do parque infantil.

Capacidades essenciais para o ciclo de vida do desenvolvimento do agente

A experiência de construção de agentes oferece experiências integradas para cada etapa central do ciclo de vida de desenvolvimento do agente. Use estas capacidades essenciais ao desenvolver a sua aplicação de agente pronta para produção. Cada funcionalidade tem documentação detalhada onde pode aprender mais.

Guardar as alterações como versões

Depois de criares a primeira versão de um agente baseado em prompts ou um fluxo de trabalho, guarda as alterações subsequentes como novas versões. Podes testar alterações não guardadas na área de testes do agente. Mas se quiser ver o histórico de conversas, monitorizar o desempenho do seu agente ou fazer avaliações completas, precisa de guardar as suas alterações.

A versionagem de agentes fornece as seguintes capacidades para gerir configurações e iterações de agentes. Este sistema garante que todas as alterações são acompanhadas, testáveis e comparáveis entre versões.

  • Imutabilidade de versão: Cada versão de um agente é imutável depois de a salvar. Quaisquer modificações em uma versão existente exigem salvar e criar uma nova versão. Este requisito ajuda a garantir a integridade da versão e previne sobrescrições acidentais.

  • Gestão do estado de rascunho: Podes testar agentes num estado não guardado para experimentação. Perdes as alterações não guardadas se saíres do portal da Fundição, por isso guarda frequentemente para preservar as modificações importantes.

  • Operações de controlo de versões: Pode encaminhar pedidos para versões específicas do agente para permitir capacidades controladas de implementação e rollback.

  • Navegação pelo histórico de versões: Aceda ao histórico de versões de qualquer agente, aceda a uma versão específica e realize as seguintes comparações:

    Tipo de comparação Description
    Configuração do agente Compare as definições de configuração entre versões usando a lista suspensa de seleção de versões
    Saída de chat Analisar diferenças de resposta entre versões de agentes usando entradas idênticas
    Definição YAML Rever diferenças nas definições de agentes

Adicionar ferramentas

Torna o teu agente mais poderoso dando-lhe conhecimento (ficheiros ou índices específicos) ou permitindo que ele tome ações (chamando APIs externas). As ferramentas estão disponíveis para a maioria dos casos de uso, desde simples carregamentos de ficheiros até ligações personalizadas ao servidor Model Context Protocol (MCP). Para ferramentas mais complexas, pode ser necessário configurar a autenticação ou adicionar conexões como parte de as ligar a um agente.

Para salvar um agente com uma ferramenta anexada, deve configurar com sucesso a ferramenta. Reutilizar ferramentas configuradas nos vários agentes. Para informações sobre as ferramentas disponíveis, consulte o catálogo de ferramentas.

Depurar e validar usando traçado (pré-visualização)

À medida que adicionas ferramentas e iteras sobre prompts, usa o traçado para validar o comportamento de ponta a ponta:

  • Confirma se o agente utilizou as ferramentas que esperava.
  • Inspecionar as entradas e saídas das ferramentas.
  • Identificar pontos críticos de latência em chamadas de modelos e ferramentas.

Para mais informações, consulte Visão Geral do Rastreio de Agentes.

Avaliar a qualidade e segurança (antevisão)

Antes de publicares o teu agente (e após qualquer alteração significativa), faz avaliações para detetar regressões e medir a qualidade de forma consistente entre as versões.

Monitorizar após a publicação

Depois de publicar uma aplicação de agente, trate-a como um software de produção:

  • Monitorizar sinais de qualidade e segurança.
  • Reveja os vestígios quando o comportamento muda.
  • Atualiza e republica quando corrigires problemas ou fizeres melhorias.

Para orientações, consulte Monitorizar qualidade e segurança.

Plano de identidade e permissões

Ferramentas e recursos a jusante frequentemente requerem autenticação. Quando publicas um agente, a sua identidade e modelo de permissões podem mudar. Certifique-se de que o seu agente publicado tem apenas o acesso necessário.

Para mais detalhes, consulte Conceitos de identidade de agente no Microsoft Foundry.

Segurança e acesso

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

Publique o seu agente ou fluxo de trabalho

Depois de criares uma versão de agente ou de workflow com a qual estás satisfeito, publica-a como uma aplicação de agente. Tens um endpoint estável que podes abrir e testar no navegador, partilhar com outros ou incorporar nas tuas aplicações existentes. Tu e os teus colaboradores podem validar o desempenho e identificar o que precisa de ser refinado. Faça as atualizações necessárias e republique 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, reatribuir os privilégios necessários à identidade da aplicação agente.

Armadilhas comuns no desenvolvimento de agentes

  • As alterações não guardadas são temporárias: Se quiseres comparar versões, ver o histórico ou fazer avaliações completas, guarda as tuas alterações como uma versão.
  • As ferramentas devem ser configuradas antes de guardar: Se uma ferramenta precisar de autenticação ou de ligação, complete a configuração antes de guardar.
  • A publicação pode exigir atualizações de permissões: Após a publicação, verifique novamente o acesso a recursos para a identidade do agente publicado e remova qualquer acesso que o agente já não precise.

Conteúdo relacionado

Saiba mais sobre os tipos de agentes:

Configurar e estender agentes:

Publicar e monitorizar agentes:

Depurar e avaliar:

  • Last updated on