중요
Microsoft 에이전트 365에 대한 초기 액세스를 얻으려면 프론티어 미리 보기 프로그램의 일부여야 합니다. 프론티어는 Microsoft의 최신 AI 혁신과 직접 연결합니다. 프론티어 미리 보기에는 고객 계약의 기존 미리 보기 조건이 적용됩니다. 이러한 기능은 아직 개발 중이므로 가용성 및 기능은 시간이 지남에 따라 변경 될 수 있습니다.
에이전트 365 CLI는 Azure에서 에이전트 365 애플리케이션을 배포하고 관리하기 위한 플랫폼 간 명령줄 도구입니다.
에이전트 365 CLI 설치
다음 단계를 사용하여 운영 체제에 에이전트 365 CLI를 전역적으로 설치합니다.
필수 구성 요소
가 설치되어 있어야 합니다. (.NET 8.0을 사용하는 것이 좋습니다.)
dotnet tool install
다음 명령을 사용하여 게스트 에이전트를 설치합니다.
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
오류가 발생하면 microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json 이 패키지에 --prerelease 여전히 시험판으로 태그가 지정될 수 있으므로 매개 변수를 사용합니다.
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli --prerelease
최신 지침 및 사용 가능한 버전은 공식 NuGet 페이지인 Microsoft.Agents.A365.DevTools.Cli on NuGet.org
설치 확인
에이전트 365 CLI를 설치한 후 다음을 실행하여 제대로 설치되었는지 확인합니다.
a365 -h
이 명령은 도움말 정보를 표시하고 CLI를 사용할 준비가 됨을 확인합니다.
엽데이트
dotnet 도구 업데이트 명령을 사용하여 에이전트 365 CLI를 업데이트 합니다.
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
참고
에이전트 365 CLI에 대한 모든 업데이트에서는 최신 Nuget 패키지인 Microsoft.Agents.A365.DevTools.Cli에 액세스하려면 인터넷 연결이 필요합니다.
제거
dotnet tool uninstall 명령을 사용하여 에이전트 365 CLI를 제거 합니다.
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
파일 위치
도구 이진 파일의 기본 위치는 운영 체제에 따라 달라집니다.
| OS | 경로 |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
이 위치는 SDK를 처음 실행할 때 사용자의 경로에 추가됩니다. 따라서 전역 도구는 도구 위치를 지정하지 않고 모든 디렉터리에서 호출할 수 있습니다.
도구 액세스는 컴퓨터 전역이 아닌 사용자별로 적용됩니다. 전역 도구는 도구를 설치한 사용자만 사용할 수 있습니다.
사용 가능한 명령
사용 가능한 명령의 전체 목록은 명령을 사용 --help 하거나 에이전트 365 CLI 참조를 참조 하세요.
문제 해결
이 섹션에는 에이전트 365 CLI를 사용하여 오류를 해결하는 방법에 대한 정보가 포함되어 있습니다.
CLI 설치, 업데이트 또는 제거 실패 Not found in NuGet feeds
오류가 발생하면 microsoft.agents.a365.devtools.cli is not found in NuGet feeds https://api.nuget.org/v3/index.json 이 패키지에 시험판으로 태그가 --prerelease 지정될 수 있으므로 매개 변수를 사용하세요.
최신 지침 및 사용 가능한 버전은 공식 NuGet 페이지인 Microsoft.Agents.A365.DevTools.Cli on NuGet.org
오류와 함께 Authorization_RequestDenied 설치 실패
명령을 실행할 setup 때 오류가 발생하면 Authorization_RequestDenied Microsoft Entra 환경의 사용 권한 문제를 나타냅니다.
일반적인 원인
이 문제는 일반적으로 다음과 같은 경우에 발생합니다.
- 계정에 필요한 권한이 없습니다.
- Microsoft Graph 명령줄 도구 앱에는 관리자 동의가 필요합니다.
- 사용자 환경에 충돌하거나 권한이 과도하게 부여된 권한이 있습니다.
해결 단계
내 계정에 Reader 역할이 있는지 확인하세요
다음 역할 중 하나가 있는 계정으로 로그인했는지 확인합니다.
- 에이전트 ID 개발자
- 에이전트 ID 관리자
- 전역 관리자
Microsoft Graph 명령줄 도구에 대한 관리자 동의 검토 및 부여
a365 설치 명령은 충돌하는 권한이 있을 수 있는 Microsoft Graph 명령줄 도구 앱을 사용합니다.
검토하고 수정하려면 다음을 수행합니다.
Microsoft Graph 명령줄 도구를 검색하거나 앱 ID를 검색합니다.
14d82eec-204b-4c2f-b7e8-296a70dab67e탐색 영역에서 보안>권한을 선택합니다.
사용 권한 찾기
Directory.AccessAsUser.All- 이 높은 권한의 권한은 청사진 생성을 방해합니다.
- 있는 경우 제거하거나 최소 권한 대안(예: )으로 바꾸는 것이 좋습니다.
Directory.Read.All
경고
사용자 환경의 다른 도구 또는 스크립트에서 필요하지 않다고 확신하는 경우에만 이 권한을 제거합니다.
관리자 동의가 아직 부여되지 않은 경우 [테넌트]에 대한 관리자 동의 부여를 선택합니다.
변경한 후 다시 실행
a365 setup
추가 리소스
이 알려진 문제에 대한 자세한 내용은 Microsoft Entra 에이전트 ID 알려진 문제 - Directory.AccessAsUser.All을 참조 하세요. 다른 권한은 무시됩니다.