중요합니다
이 문서에 표시된 항목(미리 보기)은 현재 퍼블릭 미리 보기에서 확인할 수 있습니다. 이 미리 보기는 서비스 수준 계약 없이 제공되며 프로덕션 워크로드에는 권장되지 않습니다. 특정 기능이 지원되지 않거나 기능이 제한될 수 있습니다. 자세한 내용은 Microsoft Azure Preview에 대한 추가 사용 약관을 참조하세요.
Azure 개발자 CLI(azd) ai 확장을 사용하면 터미널에서 Microsoft Foundry에서 AI 에이전트를 빌드, 배포, 평가 및 운영할 수 있습니다. 이 문서에서는 확장을 설치하고, 설치를 확인하고, Azure 인증합니다.
사전 요구 사항
- Azure 구독입니다. 체험 계정 만들기
- Azure 개발자 CLI(
azd) 버전 1.25.2 이상. azd를 설치합니다. - 사용하려는 에이전트 프레임워크에 따라 Python 3.10 이상 또는 .NET 8 이상.
Azure 접근 권한
Azure 구독에서 다음 역할이 필요합니다.
| 역할 | 목적 |
|---|---|
| Contributor | Azure 리소스를 프로비전하고 관리합니다. |
| Foundry 소유자 | 새 Foundry 프로젝트를 만드는 경우에만 필요합니다. |
중요합니다
Foundry RBAC 역할의 이름이 최근에 바뀌었습니다. Foundry User, Foundry OwnerFoundry 계정 소유자 및 Foundry Project Manager는 이전에 Azure AI 사용자, Azure AI 소유자, Azure AI 계정 소유자 및 Azure AI Project Manager로 이름이 지정되었습니다. 이름 바꾸기가 롤아웃되는 동안 일부 위치에서는 이전 이름이 계속 표시될 수 있습니다. 역할 ID 및 핵심 권한은 이름 바꾸기에 의해 변경되지 않습니다.
확장이 패키지되는 방법 이해
azd ai 네임스페이스는 여러 개의 독립적인 azd 확장으로 구성됩니다. 각각은 아래 azd ai의 최상위 명령 그룹에 기여합니다.
| 확장 ID | 명령 그룹 | 용도 |
|---|---|---|
microsoft.foundry |
메타 패키지 | 단일 설치에 대한 모든 Foundry 확장을 번들로 묶습니다. |
azure.ai.agents |
azd ai agent |
터미널에서 Foundry를 사용하여 에이전트를 배송합니다. |
azure.ai.connections |
azd ai connection |
Foundry 프로젝트 연결을 관리합니다. |
azure.ai.inspector |
azd ai inspector |
로컬로 실행되는 에이전트에 대한 브라우저 기반 검사기 UI입니다. |
azure.ai.projects |
azd ai project |
Foundry 프로젝트 컨텍스트(set, unset, show)를 관리합니다. |
azure.ai.routines |
azd ai routine |
Foundry 루틴(타이머, 일정, 이벤트 트리거)을 관리합니다. |
azure.ai.skills |
azd ai skill |
Foundry 기술(재사용 가능한 에이전트 동작 지침)을 관리합니다. |
azure.ai.toolboxes |
azd ai toolbox |
Foundry 도구 상자(버전이 지정된 도구 컬렉션)를 관리합니다. |
microsoft.foundry 패키지는 자체 명령어를 제공하지 않는 가벼운 메타 패키지입니다. 이것을 설치하면 모든 개별 확장 기능이 함께 설치되며, 이는 권장되는 시작점입니다.
azure.ai.agents만 단독으로 설치해도 에이전트 확장이 azure.ai.inspector에 종속되어 있으므로 azure.ai.inspector도 자동으로 함께 설치됩니다.
전체 번들 설치
메타 패키지를 통해 한 단계에서 모든 Foundry 확장을 설치합니다.
azd ext install microsoft.foundry
나중에 업데이트하려면 다음을 수행합니다.
azd ext upgrade microsoft.foundry
개별 확장 설치 또는 업그레이드
각 확장을 자체적으로 관리할 수도 있습니다.
# 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
개별 확장은 독립적으로 버전이 지정되므로 한 번에 하나씩 고정하거나 업그레이드할 수 있습니다.
설치 확인
설치된 확장의 목록을 생성합니다.
azd ext list
microsoft.foundry와 각 개별 확장이 표시되어야 합니다. 각 확장은 하위 명령도 노출합니다 version .
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
CLI가 사용자를 대신하여 리소스를 프로비전하고 관리할 수 있도록 Azure 로그인합니다.
azd auth login
이 명령은 대화형 인증을 위한 브라우저 창을 엽니다. 로그인한 후 CLI는 후속 명령을 위해 자격 증명을 로컬로 캐시합니다.