Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Importante
Os itens assinalados como (pré-visualização) neste artigo estão atualmente em pré-visualização pública. Esta pré-visualização é fornecida sem um acordo de nível de serviço, e não a recomendamos para trabalhos em produção. Certas funcionalidades podem não ser suportadas ou podem ter capacidades limitadas. Para mais informações, consulte Termos Suplementares de Utilização para Microsoft Azure Previews.
As extensões Azure Developer CLI (azd) ai permitem-lhe construir, implementar, avaliar e operar agentes de IA no Microsoft Foundry a partir do seu terminal. Neste artigo, instala as extensões, verifica a instalação e autentica-se no Azure.
Pré-requisitos
- Uma assinatura do Azure. Crie um gratuitamente.
- Azure Developer CLI (
azd) versão 1.25.2 ou posterior. Instale azd. - Python 3.10 ou posterior, ou .NET 8 ou posterior, dependendo do framework de agentes que planeias usar.
Permissões do Azure
Precisa das seguintes funções na sua subscrição do Azure.
| Função | Purpose |
|---|---|
| Contributor | Providenciar e gerir recursos do Azure. |
| Proprietário da Fundição | Só é obrigatório se criares novos projetos Foundry. |
Importante
As funções RBAC do Foundry foram recentemente renomeadas. Foundry User, Foundry Owner, Foundry Account Owner e Foundry Project Manager foram anteriormente nomeados Azure AI User, Azure AI Owner, Azure AI Account Owner e Azure AI Project Manager. Poderá ainda ver os nomes anteriores em alguns locais enquanto esta alteração de nome está a ser implementada. Os IDs das funções e as permissões principais não são alterados por esta mudança de nome.
Compreenda como as extensões são empacotadas
O azd ai namespace é composto por múltiplas extensões independentes azd . Cada um adiciona um grupo de comandos de nível superior em azd ai.
| ID da extensão | Grupo de comando | O que faz |
|---|---|---|
microsoft.foundry |
Meta-pacote | Inclui todas as extensões do Foundry numa única instalação. |
azure.ai.agents |
azd ai agent |
Envia agentes com a Foundry a partir do teu terminal. |
azure.ai.connections |
azd ai connection |
Gerir as ligações do projeto Foundry. |
azure.ai.inspector |
azd ai inspector |
Interface de inspeção baseada no navegador para agentes em execução local. |
azure.ai.projects |
azd ai project |
Gerir contexto do projeto Foundry (set, unset, show). |
azure.ai.routines |
azd ai routine |
Gerir rotinas do Foundry (temporizadores, agendas, gatilhos de eventos). |
azure.ai.skills |
azd ai skill |
Gerir capacidades da Foundry (orientações comportamentais reutilizáveis para agentes). |
azure.ai.toolboxes |
azd ai toolbox |
Gerir as caixas de ferramentas da Foundry (coleções de ferramentas versionadas). |
O microsoft.foundry pacote é um meta-pacote fraco que não contribui com os seus próprios comandos. Ao instalá-lo, são instaladas todas as extensões individuais, o que constitui o ponto de partida recomendado. Instalar azure.ai.agents por si só também instala automaticamente azure.ai.inspector, porque a extensão do agente depende dele.
Instale o pacote completo
Instale todas as extensões do Foundry num só passo através do meta-pacote:
azd ext install microsoft.foundry
Para atualizar mais tarde:
azd ext upgrade microsoft.foundry
Instale ou atualize uma extensão individual
Também pode gerir cada extensão isoladamente:
# 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 versões independentes, por isso podes fixar ou atualizar uma de cada vez.
Verifique a instalação
Liste as extensões instaladas:
azd ext list
Deves ver microsoft.foundry e cada extensão individual. 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
Inicie sessão no Azure para que a CLI possa provisionar e gerir recursos em seu nome:
azd auth login
Este comando abre uma janela do navegador para autenticação interativa. Depois de iniciar sessão, a CLI armazena as suas credenciais localmente para comandos subsequentes.