Visão geral da extensão do agente do Microsoft Foundry

A extensão de agente do Microsoft Foundry para a CLI para Desenvolvedores do Azure (azd) gera a estrutura, provisiona e implanta agentes no Microsoft Foundry a partir do seu terminal ou editor. Combina as capacidades de agente do Foundry com azd comandos de ciclo de vida para um fluxo de trabalho consistente do ambiente local para a nuvem. Você pode passar de um agente de exemplo para um endpoint implantado e invocável com alguns comandos.

Este artigo apresenta a extensão. Para obter diretrizes passo a passo completas, consulte a documentação de agentes hospedados Microsoft Foundry.

Características principais

Característica Descrição
Estrutura do Projeto Configura projetos de agente completos, incluindo infraestrutura como modelos de código, definições de agente e configuração, para que você possa começar a iterar imediatamente.
Configuração declarativa Define serviços, recursos e implantações de modelo em um azure.yaml arquivo para ambientes consistentes.
Provisionamento e implantação unificados Execute azd up para criar contêineres, enviar imagens, criar recursos, implantar modelos e publicar o agente em uma única etapa.
Gerenciamento de definição de agente Importa definições de agente de catálogos, GitHub ou caminhos locais e mapeia parâmetros necessários para variáveis de ambiente.
Segurança por padrão Configura identidades gerenciadas e segurança de linha de base automaticamente sem manipular credenciais manualmente.
Provisionamento de modelo escalonável Especifica nomes de modelo, versões e capacidade e os implanta consistentemente entre ambientes.

Explorar o fluxo de trabalho

A extensão segue um azd ciclo de vida conhecido, desde a estrutura inicial até um agente ativo:

  1. Scaffold: inicialize um projeto de agente de exemplo, incluindo infraestrutura como código, definição de agente e configuração.
  2. Provisionar e implantar: criar a conta e o projeto do Foundry, implantar modelos, compilar e enviar por push o contêiner do agente e publicar o agente.
  3. Executar localmente: itere com o agente na sua máquina local enquanto estiver conectado a recursos remotos do Azure.
  4. Invocar e monitorar: Envie prompts para o agente implantado e acompanhe os logs em tempo real.
  5. Desativar: remova todos os recursos provisionados quando terminar.

Experimente

Tente implantar um agente de exemplo com o fluxo de trabalho mínimo. Este exemplo usa o exemplo básico do Agent Framework da documentação do Microsoft Foundry.

  1. Crie a estrutura inicial de um projeto de exemplo de agente em uma pasta vazia:

    azd ai agent init -m https://github.com/microsoft-foundry/foundry-samples/blob/main/samples/python/hosted-agents/agent-framework/responses/01-basic/azure.yaml

  2. Provisione recursos e implante o agente em uma etapa:

    azd up

    Tip

    Você também pode dividir esta etapa em azd provision e azd deploy para obter mais controle sobre cada estágio.

  3. Remova todos os recursos provisionados quando terminar:

    azd down

    Aviso

    azd down exclui permanentemente todos os recursos do grupo de recursos. Use-o com cuidado em ambientes compartilhados ou de produção.

Para pré-requisitos, seleção de modelo, teste local e solução de problemas, consulte Início Rápido: Implantar seu primeiro agente hospedado.

Quando usar a extensão do agente

Microsoft Foundry dá suporte a várias maneiras de criar e implantar agentes hospedados, incluindo o SDK Python, Visual Studio Code e o portal. A extensão do agente azd é a mais indicada quando você deseja:

  • Trabalhe principalmente no terminal ou editor com um fluxo de trabalho repetível por script.
  • Gerencie a infraestrutura e os agentes em conjunto usando arquivos declarativos azure.yaml e arquivos Bicep no controle de versão.
  • Mova-se consistentemente de local para nuvem usando os mesmos azd comandos de ciclo de vida (azd init, azd up, azd down) que você já usa para outros aplicativos Azure.
  • Padronizar implantações em ambientes (desenvolvimento, teste e produção) e automatizá-las em CI/CD.

Para obter uma experiência de portal guiada ou para criar agentes com o SDK do Python, comece com a documentação de agentes hospedados do Microsoft Foundry.

Recursos adicionais

  • Last updated on