Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Importante
Os itens marcados (versão prévia) neste artigo estão atualmente em versão prévia pública. Essa versão prévia é fornecida sem um contrato de nível de serviço e não recomendamos isso para cargas de trabalho de produção. Alguns recursos podem não ter suporte ou podem ter restrição de recursos. Para obter mais informações, consulte Termos de Uso Complementares para Versões Prévias do Microsoft Azure.
As extensões da CLI do Desenvolvedor do Azure (azd) ai permitem que você crie, implante, avalie e opere agentes de IA no Microsoft Foundry do terminal. Neste artigo, você instala as extensões, verifica a instalação e autentica para Azure.
Pré-requisitos
- Uma assinatura do Azure. Criar um gratuitamente.
- Azure Developer CLI (
azd) versão 1.25.2 ou posterior. Instale o azd. - Python 3.10 ou posterior ou .NET 8 ou posterior, dependendo da estrutura do agente que você planeja usar.
Permissões do Azure
Você precisa das seguintes funções em sua assinatura Azure.
| Função | Purpose |
|---|---|
| Contributor | Provisione e gerencie recursos do Azure. |
| Proprietário da fundiária | Necessário somente se você criar novos projetos do Foundry. |
Importante
As funções RBAC do Foundry foram renomeadas recentemente. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager eram anteriormente chamados de Usuário do Azure AI, Proprietário do Azure AI, Proprietário da conta do Azure AI e Gerente de Projeto do Azure AI. Você ainda pode ver os nomes anteriores em alguns lugares enquanto essa mudança de nome está sendo implementada. Os IDs das funções e as permissões principais não são alterados com a mudança de nome.
Entender como as extensões são empacotadas
O azd ai namespace é composto por várias extensões independentes azd . Cada um adiciona um grupo de comandos de nível superior sob azd ai.
| ID da extensão | Grupo de comandos | O que faz |
|---|---|---|
microsoft.foundry |
metapacote | Agrupa todas as extensões do Foundry para uma única instalação. |
azure.ai.agents |
azd ai agent |
Lance agentes com o Foundry pelo seu terminal. |
azure.ai.connections |
azd ai connection |
Gerenciar conexões de projeto do Foundry. |
azure.ai.inspector |
azd ai inspector |
Interface do inspetor baseada no navegador para agentes executados localmente. |
azure.ai.projects |
azd ai project |
Gerenciar o contexto do projeto foundry (set, unset, show). |
azure.ai.routines |
azd ai routine |
Gerenciar rotinas do Foundry (temporizadores, agendamentos, gatilhos de evento). |
azure.ai.skills |
azd ai skill |
Gerenciar habilidades do Foundry (diretrizes comportamentais reutilizáveis do agente). |
azure.ai.toolboxes |
azd ai toolbox |
Gerenciar caixas de ferramentas do Foundry (coleções versionadas de ferramentas). |
O pacote microsoft.foundry é um metapacote leve que não fornece comandos próprios. Ao instalá-lo, todas as extensões individuais são instaladas, o que é o ponto de partida recomendado. Instalar azure.ai.agents por si só também instala azure.ai.inspector automaticamente, porque a extensão do agente depende dele.
Instalar o pacote completo
Instale todas as extensões do Foundry de uma só vez usando o metapacote:
azd ext install microsoft.foundry
Para atualizar mais tarde:
azd ext upgrade microsoft.foundry
Instalar ou atualizar uma extensão individual
Você também pode gerenciar cada extensão por conta própria:
# Just the agent surface
azd ext install azure.ai.agents
# Just the routine surface
azd ext install azure.ai.routines
# Upgrade one extension without touching the others
azd ext upgrade azure.ai.connections
As extensões individuais são versionadas de forma independente, portanto você pode fixar ou atualizar uma de cada vez.
Verificar a instalação
Liste as extensões instaladas:
azd ext list
Você deverá ver microsoft.foundry além de cada extensão individualmente. Cada extensão também expõe um version subcomando:
azd ai agent version
azd ai connection version
azd ai inspector version
azd ai project version
azd ai routine version
azd ai skill version
azd ai toolbox version
Authenticate
Entre no Azure para que a CLI possa provisionar e gerenciar recursos em seu nome:
azd auth login
Esse comando abre uma janela do navegador para autenticação interativa. Depois de entrar, a CLI armazena suas credenciais em cache localmente para comandos subsequentes.