메모
이 글에서는 표준 하네스로 구동되는 에이전트 또는 에이전트 플로우에서 사용되는 기능에 대해 설명합니다.
[이 문서는 시험판 문서이며 변경될 수 있습니다.]
Microsoft Foundry 에이전트를 사용자 지정 에이전트에 연결하고 이 에이전트를 호출하여 사용자 또는 트리거에 응답할 수 있습니다.
Important
이 문서에는 Microsoft Copilot Studio 미리 보기 설명서가 포함되어 있으며 변경될 수 있습니다.
미리 보기 기능은 프로덕션용이 아니며 기능이 제한되었을 수 있습니다. 이러한 기능은 공식 릴리스 이전에 제공되므로 사용자가 조기에 액세스하고 피드백을 제공할 수 있습니다.
프로덕션이 가능한 에이전트를 빌드하는 경우 Microsoft Copilot Studio 개요를 참조하세요.
사전 요구 사항
Microsoft Foundry 에이전트를 Copilot Studio에 연결하기 전에, Foundry 에이전트가 Activity 프로토콜 엔드포인트를 활성화해야 합니다. 새로 생성된 Foundry 에이전트는 기본적으로 Responses 와 A2A 프로토콜 엔드포인트만 노출합니다. Activity 엔드포인트가 활성화되어 있지 않으면, 런타임에 400 오류가 발생하며 Copilot Studio와의 연결이 실패합니다. Foundry 에이전트에서 수신 A2A 사용에서 자세히 알아보세요.
현재 REST API나 Python SDK를 사용하여 프로그래밍으로만 Activity 엔드포인트를 활성화할 수 있습니다. Microsoft Foundry 포털에서는 활성화할 수 있는 옵션이 없습니다. 에이전트 구성 및 공유에서 활성화 절차에 대해 더 알아보세요.
Activity 엔드포인트를 활성화한 후에도 Foundry 포털에서 에이전트의 엔드포인트 섹션에는 응답과 A2A만 계속 표시됩니다. 이 UI 누락은 예상된 것이며, 변경이 실패했다는 의미는 아닙니다. 업데이트 적용 후에는 Copilot Studio와의 연결이 정상적으로 작동합니다.
Microsoft Foundry 에이전트에 연결하세요
주 에이전트의 에이전트 페이지로 이동하여 에이전트 추가를 선택합니다.
외부 에이전트에 연결 아래에서 사용 가능한 에이전트 유형에서 Microsoft Foundry를 선택합니다.
사용 가능한 연결 목록에서 원하는 연결을 선택하거나 Microsoft Foundry와 Copilot Studio 에이전트 간에 새 연결을 만듭니다. 새 연결을 만들려면 Foundry 프로젝트 엔드포인트 URL을 제공해야 합니다.
메모
Copilot Studio에서 Microsoft Foundry 에이전트에 연결하는 경우 새 Microsoft Foundry 포털에서 만든 에이전트에만 연결할 수 있습니다. 이전 포털에서 생성된 에이전트에 연결할 경우
404 - Version not found가 표시되는 오류가 발생합니다.연결이 만들어지면 다음을 선택합니다.
SDK 에이전트에 대한 적절한 이름 및 설명을 입력합니다. 설명은 주 에이전트가 언제 사용해야 하는지 이해할 수 있도록 Microsoft Foundry 에이전트의 목적을 설명해야 합니다. 자세한 내용은 효과적인 메타데이터 작성을 참조하세요.
연결하려는 Microsoft Foundry 에이전트의 에이전트 ID를 입력합니다.
필요하다면 설명을 조정해 주 요원에게 더 맥락에 맞게 하세요. 예를 들어 설명이 겹칠 수 있는 다른 도구 또는 에이전트가 있는 경우 설명을 보다 구체적으로 지정합니다. Copilot Studio가 이 에이전트를 언제 호출해야 하는지 이해할 수 있도록 설명을 업데이트하세요.
에이전트 추가를 선택합니다.
에이전트가 만들어지면 에이전트를 즉시 테스트할 수 있습니다. 나중에 에이전트 ID를 조정해야 하는 경우 에이전트 목록에서 에이전트를 선택하여 세부 정보 페이지에서 이 작업을 수행할 수 있습니다.
메모
만약 연결된 Foundry 에이전트에 대한 첫 테스트 호출이 "커넥터 'Azure AI Foundry Agent Service'가 코드 400과 함께 HTTP 오류를 반환했다."와 유사한 오류로 실패한다면, 내부 오류: 에이전트
<name>엔드포인트가 활동을 지원하지 않습니다. "에이전트 엔드포인트를 이 프로토콜을 지원하도록 업데이트해 주세요."라고 말하지만, Foundry 에이전트에는 Activity 프로토콜 엔드포인트가 활성화되어 있지 않습니다. 이 문서의 전제 조건을 먼저 확인한 다음, Microsoft Foundry 문서의 에이전트 구성 및 공유를 따라 Activity 엔드포인트를 활성화하세요.여러분은 특정 사용 사례에 맞게 연결된 에이전트를 신중히 검토하고 테스트하며, 모든 적절한 결정과 맞춤화를 할 책임이 있습니다. Copilot Studio 외부의 에이전트에 연결하는 경우, 해당 에이전트 사용에 대한 책임은 사용자에게 있습니다. 고려 사항에는 다음을 확인하고 보장해야 합니다:
- 데이터 흐름, 데이터 처리, 에이전트 간 데이터 공유는 귀하의 사용 사례에 적합하며 관련 요구사항과 법률을 충족합니다.
- 에이전트는 적절한 품질, 신뢰성, 보안 및 신뢰성 기준을 충족합니다.
- 사용 상황에 맞게 적절한 권한, 경계, 승인이 제공됩니다.
- 적절한 관측 가능성, 신원 및 추적성, 그리고 인간의 감독 기능이 갖춰져 있습니다.