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

A extensão Azure Developer CLI (azd) do agente Microsoft Foundry apoia, provisiona e implementa agentes no Microsoft Foundry a partir do seu terminal ou editor. Combina as capacidades do agente Foundry com comandos azd de ciclo de vida para um fluxo de trabalho consistente do ambiente local para a cloud. Podes passar de um agente de exemplo para um endpoint implementado e chamável com alguns comandos.

Este artigo apresenta a extensão. Para orientações completas passo a passo, consulte a documentação dos agentes hospedados pelo Microsoft Foundry.

Principais características

Feature Description
Projeto andaimes Configura projetos completos de agentes, incluindo modelos de infraestrutura como código, definições de agentes e configurações, para que possas começar a iterar imediatamente.
Configuração declarativa Define serviços, recursos e implementações de modelos num azure.yaml ficheiro para ambientes consistentes.
Provisionamento e implementação unificados Executa azd up para construir containers, enviar imagens, criar recursos, implementar modelos e publicar o agente numa só etapa.
Gestão da definição de agentes Importa definições de agentes de catálogos, GitHub ou caminhos locais, e mapeia parâmetros necessários para variáveis de ambiente.
Seguro por predefinição Configura automaticamente identidades geridas e segurança básica sem gerir as credenciais manualmente.
Provisão escalável de modelos Especifica nomes de modelos, versões e capacidade, e implementa-os de forma consistente em vários ambientes.

Explore o fluxo de trabalho

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

  1. Andaime: Inicializar um projeto de agente de exemplo, incluindo infraestrutura como código, definição de agente e configuração.
  2. Aprovisionar e implementar: Crie a conta e o projeto do Foundry, implemente os modelos, crie e envie o contentor do agente e publique o agente.
  3. Executar localmente: Faça iterações no agente na sua máquina local enquanto está ligado a recursos remotos do Azure.
  4. Invocar e monitorizar: Envie pedidos ao agente implantado e acompanhe os registos em direto.
  5. Desmontar: Remove todos os recursos provisionados quando terminares.

Experimente

Tenta implementar um agente de amostra com o fluxo de trabalho mínimo. Este exemplo utiliza o exemplo básico do Agent Framework da documentação do Microsoft Foundry.

  1. Organize um projeto de agente de exemplo numa 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. Disponibilize recursos e implemente o agente num só passo:

    azd up

    Sugestão

    Também podes dividir este passo em azd provision e azd deploy para mais controlo sobre cada fase.

  3. Remova todos os recursos provisionados quando terminar:

    azd down

    Advertência

    azd down apaga permanentemente todos os recursos do grupo de recursos. Utilize-o com cuidado em ambientes partilhados ou de produção.

Para pré-requisitos, seleção de modelos, testes locais e resolução de problemas, veja Quickstart: Implemente o seu primeiro agente alojado.

Quando usar a extensão do agente

O Microsoft Foundry suporta várias formas de construir e implementar agentes alojados, incluindo o Python SDK, o Visual Studio Code e o portal. A azd extensão do agente é a melhor opção quando queres:

  • Trabalhar principalmente a partir do terminal ou editor com um fluxo de trabalho scriptável e repetível.
  • Gerir a infraestrutura e os agentes em conjunto usando ficheiros declarativos azure.yaml e Bicep sob controlo de versão.
  • Move consistentemente do local para a cloud usando os mesmos azd comandos de ciclo de vida (azd init, azd up, azd down) que já usas para outras aplicações do Azure.
  • Padronizar implementações em ambientes (desenvolvimento, teste e produção) e automatizá-las em CI/CD.

Para uma experiência guiada no portal ou para criar agentes com o SDK Python, comece pela documentação dos agentes alojados no Microsoft Foundry.

Recursos adicionais

  • Last updated on