Agent 365 CLI는 Azure에 Agent 365 애플리케이션을 배포하고 관리할 수 있는 플랫폼 간 명령줄 도구입니다.
CLI를 수동으로 설치할 필요는 없습니다. AI 가이드 설정은 CLI를 검사하고, 자동으로 설치하거나 업데이트하며, 필요한 모든 명령을 대신 실행합니다. 이 페이지는 CI/CD 자동화 구축, 특정 단계의 문제 해결, 또는 AI 코딩 에이전트 없이 작업할 때 등, CLI를 직접 설치하거나 사용해야 하는 개발자를 위한 참고 자료입니다.
참고
완전한 개발자 워크플로(예: AI 가이드 설정, 역할 안내, 배포 후 단계 포함)는 Agent 365 개발 시작하기에 포함되어 있습니다. 이 페이지는 CLI 참조 자료로, 설치, 업데이트, 제거, 사용 가능한 명령어 및 문제 해결 내용을 다룹니다.
필수 구성 요소
CLI를 사용하려면 .NET 8.0 이상이 필요합니다. 기타 필수 조건(예: Azure 구독, 필요한 Entra 역할, 맞춤형 클라이언트 앱 등록)에 대해서는 AI 가이드 설정을 참고하세요.
Agent 365 CLI 설치
운영 체제에서 Agent 365 CLI를 전역적으로 설치하려면 다음 단계를 따르세요.
필수 구성 요소
.NET가 설치되어 있어야 합니다. (.NET 8.0을 권장합니다.)
dotnet tool install 명령어 사용
다음 명령을 사용하여 Agent 365 CLI를 설치하십시오.
dotnet tool install --global Microsoft.Agents.A365.DevTools.Cli
최신 지침과 사용 가능한 버전은 공식 NuGet 페이지 Microsoft.Agents.A365.DevTools.Cli on NuGet.org를 방문하세요
설치 확인
Agent 365 CLI를 설치한 후, --help 명령어를 실행하여 제대로 설치되었는지 확인하세요.
a365 -h
이 명령어는 도움말 정보를 표시하고 CLI가 정상적으로 사용할 수 있는 상태임을 확인해줍니다.
업데이트
dotnet tool update 명령어를 사용하여 Agent 365 CLI를 업데이트하세요.
dotnet tool update --global Microsoft.Agents.A365.DevTools.Cli
참고
Agent 365 CLI를 업데이트하려면 최신 NuGet 패키지 Microsoft.Agents.A365.DevTools.Cli에 액세스할 수 있도록 인터넷 연결이 필요합니다.
제거
dotnet tool uninstall 명령어를 사용하여 Agent 365 CLI를 제거하세요.
dotnet tool uninstall --global Microsoft.Agents.A365.DevTools.Cli
파일 위치
도구 실행 파일의 기본 위치는 운영 체제에 따라 다릅니다.
| OS | 경로 |
|---|---|
| Linux/macOS | $HOME/.dotnet/tools |
| Windows | %USERPROFILE%\.dotnet\tools |
SDK는 처음 실행할 때 이 위치를 경로에 추가합니다. 따라서 도구 위치를 지정하지 않고 모든 디렉터리에서 전역 도구를 호출할 수 있습니다.
도구 액세스는 컴퓨터 전역이 아닌 사용자별로 적용됩니다. 전역 도구는 도구를 설치한 사용자만 사용할 수 있습니다.
사용 가능한 명령
사용 가능한 모든 명령어 목록을 확인하려면 --help 명령어를 사용하거나 Agent 365 CLI 참조 자료를 참조하세요.
팁
CLI 명령을 수동으로 실행할 필요가 없습니다. AI 가이드 설정은 AI 코딩 에이전트를 사용하여 CLI 설치, 구성, 블루프린트 설정, 배포, 게시 등 전체 워크플로를 자동화합니다. CI/CD 자동화를 구축하거나, 특정 단계를 문제 해결하거나, AI 코딩 에이전트 없이 작업하는 경우에는 이곳의 CLI 문서를 사용하세요.
CLI를 사용하여 Agent 365 에이전트를 설정하는 전체 안내는 Agent 365 개발 시작하기를 참고하세요.
문제 해결
이 섹션에서는 Agent 365 CLI 오류 해결 방법을 안내합니다.
팁
Agent 365 문제 해결 가이드에는 고급 문제 해결 권장 사항, 모범 사례, 그리고 Agent 365 개발 라이프사이클의 각 단계별 문제 해결 콘텐츠에 대한 링크가 포함되어 있습니다.
이 섹션에서 다루는 CLI 관련 문제:
에이전트가 Teams에 표시되지 않음
에이전트 인스턴스 생성 문제 해결: 에이전트가 Teams에 나타나지 않음