Microsoft 관리 센터에 에이전트 게시

a365 publish 명령어를 사용하여 에이전트를 패키징한 후, 패키지를 Microsoft 365 관리 센터에 업로드하세요. 게시 후에는 조직 내에서 에이전트 인스턴스를 생성하고 에이전트를 관리할 수 있습니다.

필수 구성 요소

시작하기 전에 다음 항목을 확인하십시오.

필요한 계정 및 사용 권한

Microsoft 365 테넌트가 다음 역할 중 하나를 가지고 있어야 합니다 (관리 센터 업로드 단계에 필요):
- 전역 관리자

필요한 도구

A365 CLI 설치 (Agent 365 CLI)

필수 설정 단계

게시 전에 다음 단계를 완료하세요:

에이전트 블루프린트 생성 - 설정 단계를 따라 에이전트 블루프린트를 생성하세요.
에이전트를 로컬에서 테스트 - Agents Playground를 사용하여 에이전트가 정상적으로 작동하는지 확인하세요 (자세한 내용은 "에이전트 로컬 테스트"를 참조하세요).
구성 파일 준비 - a365.config.json와 a365.generated.config.json가 최신 상태인지 확인하세요.

게시 명령

a365 publish 명령을 실행합니다.

a365 publish

참고

a365 publish -h 명령어를 실행하면 이 명령어가 지원하는 모든 옵션을 확인할 수 있습니다.

이 명령이 하는 일:

업데이트 매니페스트 - manifest.json을 에이전트 청사진 ID로 업데이트합니다.
패키지 생성 - 패키지 manifest.json와 아이콘을 manifest.zip로.
지침 표시 - Microsoft 365 관리 센터를 통해 업로드하는 단계별 지침을 표시합니다.

참고

a365 publish 명령은 에이전트와 AI 팀원 모두에 적용됩니다. --agent-name(config-free)로 프로비저닝된 에이전트의 경우, a365 publish 명령어를 실행하기 전에 작업 디렉터리에 a365.generated.config.json가 반드시 존재해야 합니다. 명령어는 이 파일에서 블루프린트 ID를 읽어옵니다.

관리 센터로 업로드

a365 publish이(가) 완료된 후, 표시된 안내에 따라 에이전트를 업로드하세요:

Microsoft 365 관리 센터로 이동합니다.
에이전트> > 모든 에이전트로 이동하세요.
사용자 지정 에이전트 업로드를 선택합니다.
프로젝트의 manifest 폴더에 있는 manifest.zip 파일을 업로드합니다.

더 자세한 정보를 원하시면 Microsoft 365 관리 센터에 에이전트 업로드를 참조하세요.

게시 성공 확인

다음 체크리스트를 사용하여 에이전트가 성공적으로 게시되었는지 확인하세요:

✅ CLI 게시 성공
✅ manifest 폴더가 manifest.json 및 manifest.zip로 생성됨
✅ 에이전트가 Microsoft 관리 센터에 나타납니다

CLI 출력

publish 명령이 성공하면 다음과 같은 출력 메시지를 볼 수 있습니다:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ 단계별 업로드 지침 출력됨

명령어가 실패하면 오류 메시지를 검토하고 설계도 설정이 완료되었는지 확인하세요.

가능한 오류:

오류	해결을 위한 단계
`Agent blueprint ID not found`	설계도 설정을 완료하려면 `a365 setup`를 실행하세요.
`Permissions missing`	`a365 setup permissions` 명령어로 설정을 다시 실행하세요.

게시가 실패할 때는 다음 단계를 따르세요.

매니페스트 파일

manifest 폴더에 있는 다음 파일들을 Test-Path PowerShell 명령어를 사용하여 검사할 수 있습니다.

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

참고

이 파일들이 보이지 않는 경우, a365 publish 명령어를 다시 실행해 보세요.

에이전트가 관리 센터에 나타납니다

참고

업로드 후 에이전트가 관리 센터와 Teams에 나타나기까지 5-10분이 걸릴 수 있습니다. 이 지연은 정상입니다.

다음 단계를 사용하여 에이전트가 존재하는지 확인하세요:

Microsoft 365 관리 센터로 이동합니다.
에이전트> > 모든 에이전트로 이동하세요.
에이전트가 목록에 표시됩니다.

다음 표는 확인할 수 있는 세부 정보를 보여줍니다:

필드	확인할 사항
이름	에이전트 이름 (`manifest.json`에서)
버전	버전 번호 (예: 1.0.0)
게시자	조직 이름
가용성	사용 가능/모든 사용자

참조

다음 단계

에이전트를 게시한 후, 테넌트에서 구성하고 사용할 수 있도록 인스턴스를 생성하세요.

에이전트 인스턴스 생성

문제 해결

Microsoft 365 관리 센터에 에이전트를 게시할 때 발생할 수 있는 일반적인 문제.

팁

Agent 365 문제 해결 가이드에는 고급 문제 해결 권장 사항, 모범 사례, 그리고 Agent 365 개발 라이프사이클의 각 단계별 문제 해결 콘텐츠에 대한 링크가 포함되어 있습니다.

게시 명령 실패

증상:

a365 publish 중 오류
manifest.zip 생성되지 않음

근본 원인:

설정이 완료되지 않았음
매니페스트 유효성 검사 오류
권한의 부족

해결 방법:

설정이 완료되었는지 확인합니다.

Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId

publish 명령을 실행하고 프롬프트를 따릅니다.

관리 센터에서 업로드 실패