에이전트를 빌드하고 테스트한 후 다음 단계는 이미 작동하는 표면에서 다른 사용자와 공유하는 경우가 많습니다. Microsoft 365 Copilot 및 Teams에 Foundry 에이전트를 게시하면 사용자와 다른 사용자가 Microsoft 365 Copilot 및 Teams UI를 통해 에이전트와 상호 작용하고 에이전트를 검색할 수 있습니다. 게시되는 항목은 에이전트의 안정적인 엔드포인트이므로 엔드포인트를 통해 트래픽을 수신하는 새 에이전트 버전을 원활하게 롤아웃하는 동안 최종 사용자는 항상 일관된 에이전트 엔터티와 상호 작용합니다. Foundry 포털에서 M365/Teams에 게시합니다.
중요
Microsoft 365 Copilot 및 Microsoft Teams용 게시 에이전트는 "얼리 엑세스 프리뷰"에 해당하며, Azure 구독의 일부로 귀하에게 라이선스가 부여됩니다. 이는 Microsoft Azure 프리뷰 추가 이용 약관 및 Microsoft 제품 및 서비스 데이터 보호 부록 ("DPA")에 명시된 "프리뷰" 및 "얼리 엑세스 프리뷰"에 적용되는 사용 약관에 따릅니다.
Azure AI Foundry Agent Service 사용하여 타사 서버 또는 에이전트와 함께 작동하는 에이전트를 호스트하는 것은 사용자 고유의 위험에 처해 있습니다. 타사 서버 또는 에이전트와 공유되는 모든 데이터를 검토하고 데이터의 보존 및 위치에 대한 타사 사례를 인식할 것을 권장합니다.
Azure AI Foundry Agent Service 상호 작용하는 외부 도구 또는 서비스(Azure AI Foundry 외부의 Microsoft 도구 및 서비스 포함)는 자체 데이터 처리 약관의 적용을 받습니다. Copilot 또는 Teams에 게시된 에이전트에는 지원 약관 적용됩니다.
데이터가 조직의 Azure 규정 준수 및 지리적 경계와 관련된 의미를 벗어나는지 여부를 관리하는 것은 사용자의 책임입니다.
참고
이전 게시 모델에서 마이그레이션하는 경우 에이전트 애플리케이션에서 새 에이전트 모델로 마이그레이션을 참조하세요.
필수 구성 요소
Microsoft Foundry 포털 에 액세스하십시오Foundary 프로젝트 로 테스트하고 게시하려는 에이전트 버전이 있는
다음 역할 할당:
- Foundry 프로젝트 범위에서 에이전트를 생성, 관리 및 게시하는 Azure AI 사용자 역할입니다.
- 자세한 내용은 Foundry 포털에서 역할 기반 액세스 제어를 참조하세요.
Azure Bot Service 리소스를 만들 수 있는 Azure 구독
게시하기 전에 Foundry 포털에서 에이전트를 철저히 테스트합니다. 올바르게 응답하고 모든 도구가 예상대로 작동하는지 확인합니다.
Microsoft 365 Teams에서 소비자가 상호 작용할 활성 에이전트 버전을 선택합니다.
필요한 Azure 리소스 공급자가 구독에 등록되어 있는지 확인합니다. 게시 프로세스는
Microsoft.BotService공급자가 필요한 Azure Bot Service 리소스를 만듭니다.Azure CLI 사용하는 경우 공급자를 다음으로 등록할 수 있습니다.
az provider register --namespace Microsoft.BotService
Foundry UI에서 활성 에이전트 버전 선택
활성 에이전트 버전을 선택하고 다른 에이전트 설정을 구성하는 방법에 대한 자세한 내용은 에이전트 게시 및 공유를 참조하세요.
Microsoft Foundry 포털에서 공개 선택합니다.
예상 결과: 엔드포인트 URL, 활성 버전 및 Teams와 Microsoft 365 Copilot에 게시할 링크를 보여주는 게시 드롭다운 메뉴가 열립니다.
활성 버전 오른쪽에 있는 화살표 아이콘을 선택합니다.
예상 결과: 항상 최신 버전을 사용하거나 특정 버전을 선택하는 옵션이 포함된 팝업이 열립니다.
에이전트의 안정적인 엔드포인트에서 트래픽을 수신하려는 활성 버전을 선택합니다.
예상 결과: 게시 드롭다운이 닫히면 게시 단추에 성공을 나타내는 확인 표시가 표시됩니다. ::image type="content" source=".. /media/success-select-version.png" alt-text="버전이 성공적으로 선택되었음을 나타내는 확인 표시가 있는 게시 단추의 스크린샷.":::
Microsoft 365 및 Teams에 게시
Microsoft Foundry 포털에서 공개를 선택한 다음 Teams에 게시하고 Microsoft 365 Copilot 선택합니다.
기대 결과: 팀즈 및 Microsoft 365에 게시 대화 상자가 열립니다.
Azure Bot Service 리소스가 이미 있는 경우 자동으로 생성되거나 읽기 전용으로 표시됩니다.
필요한 메타데이터를 완료합니다.
필드 설명 이름 에이전트 이름(에이전트 스토어에 표시됨) 버전 게시 세 부분으로 구성된 버전 번호(major.minor.patch) 간단한 설명 에이전트가 수행하는 일에 대한 한 문장 설명 설명 에이전트의 책임 및 수행할 수 있는 작업에 대한 더 긴 설명 개발자 사용자 이름 또는 조직 이름( 작성자 아래) 선택적 메타데이터를 추가하려면 자세히 를 확장하고 다음 필드를 완료합니다.
필드 설명 개발자 웹 사이트 웹 사이트에 대한 URL(HTTPS 필요) 사용 약관 사용 약관에 대한 URL(HTTPS 필요) 개인정보취급방침 개인 정보 취급 방침 URL(HTTPS 필요) 경고
메타데이터 필드에 비밀, API 키 또는 중요한 정보를 포함하지 마세요. 이러한 필드는 사용자에게 표시됩니다.
다음: 게시 옵션을 선택합니다.
게시 방법을 선택합니다. Foundry에서 직접 에이전트를 게시하거나 에이전트 매니페스트를 다운로드하여 사용자 지정한 다음 Teams에서 수동으로 테스트용으로 로드할 수 있습니다.
직접 게시
게시 옵션 단계에서 직접 게시 탭을 선택합니다.
예상 결과: 이 에이전트를 사용할 수 있는 사용자 선택 섹션이 표시됩니다.
이 에이전트를 사용할 수 있는 사용자 선택에서 범위를 선택합니다.
옵션 동작 관리자 승인 적합한 대상 그냥 당신 즉시 사용할 수 있습니다. 에이전트가 에이전트 저장소 당신의 에이전트 아래에 표시됩니다. 에이전트 링크를 전송하여 다른 사용자와 공유합니다. 필요하지 않음 개인 테스트, 소규모 팀, 조종사 조직의 사용자 에이전트가 관리자 승인을 위해 제출됩니다. Microsoft 365 관리자는 요청을 검토하고 액세스를 할당합니다. 승인되면 에이전트는 모든 테넌트 사용자를 위해 조직에서 빌드한 아래에 표시됩니다. 필수 조직 전체 배포, 프로덕션 배포 오직 당신만
- 게시 직후 사용할 수 있습니다. 관리자 승인이 필요하지 않습니다.
- 처음에는 당신의 에이전트에서 에이전트 저장소를 오직 당신만 볼 수 있습니다.
- 에이전트 링크를 전송하여 특정 사용자와 공유합니다.
조직의 사용자:
게시 후 Microsoft 365 관리자는 Microsoft 365 관리 센터 요청을 검토하고 승인해야 합니다.
승인이 완료되면, 모든 테넌트 사용자에 대해 에이전트 저장소의 조직에서 빌드함에 에이전트가 표시됩니다.
테넌트에서 앱 정책은 에이전트에 액세스할 수 있는 사용자를 제어합니다.
승인 상태를 확인하려면 Microsoft 365 관리 센터 이동하여 Requests 아래에서 에이전트를 찾습니다.
게시를 선택합니다.
예상 결과: 게시 성공 대화 상자는 에이전트가 성공적으로 게시되었는지 확인합니다.
다운로드 및 사용자 지정
배포하기 전에 에이전트 매니페스트를 사용자 지정하려는 경우:
게시 옵션 단계에서 다운로드 및 사용자 지정 탭을 선택합니다.
예상 결과: 다운로드 후 탭에 대한 지침과 ZIP 다운로드 단추가 표시됩니다.
ZIP 다운로드를 선택합니다.
예상 결과:
.zip에이전트 매니페스트가 포함된 파일이 로컬 컴퓨터에 다운로드됩니다.필요에 따라 다운로드한 패키지에서 매니페스트를 사용자 지정합니다.
Microsoft Teams 다운로드한 패키지를 업로드합니다.
- 앱관리>앱>으로 이동 앱 업로드
-
사용자 지정 앱 업로드를 선택하거나 조직에 앱을 제출하고 다운로드한
.zip파일을 선택합니다.
M365/Teams에서 게시된 에이전트 업데이트
활성 에이전트 버전 업데이트
새 에이전트 버전을 롤아웃하려면 Foundry 포털에서 에이전트의 버전 선택기를 업데이트합니다. 안정적인 엔드포인트 URL은 동일하게 유지됩니다. M365/Teams에 다시 게시할 필요가 없습니다.
M365/Teams에서 최종 사용자 메타데이터 업데이트
Teams 및 M365(표시 이름, 설명, URL)에 표시되는 메타데이터를 업데이트하려면 Pblish 드롭다운에서 에이전트 Teams를 업데이트하고 Microsoft 365 Copilot 표시 속성을 선택합니다. 업데이트된 필드는 기존 값을 덮어씁 수 있습니다. 변경되지 않은 필드는 앞으로 전달됩니다. 수동으로 증가하지 않으면 버전이 자동으로 증가합니다.
제한
| 제한 | 설명 |
|---|---|
| Microsoft 365 파일 업로드 및 이미지 생성 | Microsoft 365 게시된 에이전트에는 작동하지 않습니다. 그들은 Microsoft Teams 일합니다. |
| 비공개 링크 | Teams 또는 Azure Bot Service 통합에는 지원되지 않습니다. |
| 스트리밍 및 인용 | 게시된 에이전트는 스트리밍 응답 또는 인용을 지원하지 않습니다. |
문제 해결
| 문제 | 원인 | 해결 방법 |
|---|---|---|
| 에이전트를 게시하는 동안 오류가 발생했습니다. | 잘못된 메타데이터 또는 버전 | 에이전트에 고유 ID(agent.identity null이 아님)가 있는지 확인합니다. 개발자 이름이 32자 이하인지 확인합니다. |
| Azure Bot Service 만들기 실패 | 누락된 권한 또는 등록되지 않은 공급자 | 리소스를 만들 수 있는 권한이 있는지 확인합니다. 필요한 경우 Microsoft.BotService 등록합니다. |
Azure 봇 서비스 필드에는 403 AuthorizationFailed 대한 Microsoft.BotService/botServices/write 오류가 표시됩니다. |
ID에 대상 리소스 그룹에서 Azure Bot Service 리소스를 만들거나 업데이트할 수 있는 권한이 없습니다. | bot service 포함된 리소스 그룹에 Azure Bot Service 기여자 역할을 할당한 다음 자격 증명을 새로 고치고 게시 흐름을 다시 엽니다. |
| 조직 범위 에이전트가 표시되지 않음 | 관리자 승인 보류 중 | M365 관리 센터에서 승인된 관리자를 확인합니다. 앱 정책을 확인합니다. |
| 에이전트는 Foundry에서 작동하지만 게시 후 실패합니다. | 에이전트 ID의 권한이 누락되었습니다. | 액세스하는 모든 Azure 리소스에 대한 에이전트 ID에 RBAC 역할을 할당합니다. |
| ID 오류로 게시 실패 | 에이전트에 고유 ID가 없습니다(agent.identity null). |
이 문제를 해결하는 단계는 마이그레이션 가이드 를 참조하세요. |
| 사용자가 에이전트를 찾을 수 없습니다. | 잘못된 범위 또는 승인 보류됨 | 개별 범위의 경우 직접 링크를 공유합니다. 조직 범위의 경우 관리자 승인을 확인합니다. |
Faq
조직 범위를 선택하면 에이전트를 승인할 위치는 어디인가요?
Microsoft 365 관리자 센터. 승인되면 에이전트가 에이전트 저장소의 빌드한 조직 아래에 표시됩니다.
에이전트를 개별 범위(이전에는 공유 범위라고 함)에 게시하는 경우 조직의 다른 사용자와 공유하려면 어떻게 해야 하나요?
에이전트는 Microsoft 365 Copilot의 에이전트 저장소에서 사용자의 에이전트 아래에 표시됩니다. 조직에서 선택한 사용자에게 에이전트 링크를 전송하여 공유할 수 있습니다.
내 에이전트가 M365에 게시된 경우 새 에이전트 버전을 만들면 어떻게 되나요?
버전 선택기가 "항상 최신 버전 사용"(기본값)으로 설정된 경우 새 버전은 M365/Teams에서 자동으로 제공됩니다. 특정 버전에 고정된 경우 새 버전을 제공하도록 버전 선택기를 업데이트해야 합니다.