Copilot Studio에서 사용할 기술 구현
적용 대상: SDK v4
기술은 다른 봇에서 사용할 수 있는 봇입니다. 이러한 방식으로 단일 사용자 연결 봇을 만들고 하나 이상의 기술로 확장할 수 있습니다. 기술 개요의 일반적인 기술과 기술 구현에서 기술을 빌드하는 방법에 대해 자세히 알아볼 수 있습니다. 또는 가상 도우미 템플릿에는 처음부터 빌드하는 대신 사용자 지정하고 배포할 수 있는 미리 빌드된 기술 집합이 포함되어 있습니다.
당신의 기술이 Copilot Studio 부조종사에서 사용될 것으로 예상하는 경우, 당신이 고려해야 할 기술에 몇 가지 다른 제한이 있습니다.
매니페스트 제한
Copilot Studio는 기술 매니페스트에서 선언할 수 있는 항목에 제한을 줍니다.
- 100개 이하의 작업만 선언할 수 있습니다.
- 각 작업은 25개 이하의 입력 또는 출력으로 제한됩니다.
- 입력 또는 출력에는 배열 형식을 사용할 수 없습니다.
동일한 테넌트 제한
Copilot Studio 내에서 사용하기 위해 등록되는 사용자 지정 기술의 규정 준수 및 적절한 거버넌스를 보장하려면 기술 봇이 Microsoft Entra ID에 등록된 애플리케이션이어야 합니다. 기술을 추가하면 기술의 애플리케이션 ID가 로그인한 사용자의 테넌트에 있고 기술 엔드포인트가 등록된 애플리케이션의 Home Page URL테넌트와 일치하는지 확인합니다.
Copilot Studio 내에서 봇을 기술로 등록하려면 먼저 봇 의 경우 Azure Portal 의 홈페이지가 봇의 기술 매니페스트 URL로 설정되어 있는지 확인해야 합니다.
기술을 등록하는 동안 수행된 유효성 검사
최종 사용자가 자신의 부조종사에서 기술에 연결하려고 하면 먼저 Copilot Studio로 기술을 가져와야 합니다. 기술은 일련의 유효성 검사를 거치게 됩니다. 이러한 검사 중 하나가 실패하면 이 표에 설명된 대로 오류 메시지가 표시될 수 있습니다.
| 유효성 검사 단계 | 오류 코드 | 오류 메시지 | 설명 또는 완화 |
|---|---|---|---|
| 매니페스트 URL이 유효합니다. |
URL_MALFORMED, URL_NOT_HTTPS |
링크가 잘못되었습니다. 링크는 https:// 시작해야 합니다. | 링크를 보안 URL로 다시 입력합니다. |
| 매니페스트를 검색할 수 있습니다. | MANIFEST_FETCH_FAILED |
기술 매니페스트를 가져오는 데 문제가 발생했습니다. | 매니페스트 URL이 매니페스트에 대한 링크인지 확인합니다. 웹 브라우저에서 매니페스트 URL을 열어 보세요. URL이 10초 내에 페이지를 렌더링하면 기술을 다시 등록하십시오. |
| 매니페스트를 읽을 수 있습니다. | MANIFEST_TOO_LARGE |
매니페스트가 너무 큽합니다. | 매니페스트는 500KB 이하여야 합니다. |
| 매니페스트를 읽을 수 있습니다. | MANIFEST_MALFORMED |
매니페스트가 호환되지 않습니다. | 매니페스트가 유효한 JSON 파일인지 확인합니다. 매니페스트에 필요한 속성(예: name등 msaAppId)이 포함되어 있는지 확인합니다. 자세한 내용은 매니페스트 제한을 참조하세요. |
| 기술이 아직 등록되지 않았습니다. | MANIFEST_ALREADY_IMPORTED |
이 기술은 이미 봇에 추가되었습니다. | 기술을 삭제하고 다시 등록합니다. |
| 매니페스트 엔드포인트 및 홈페이지 도메인 일치 | MANIFEST_ENDPOINT_ORIGIN_MISMATCH |
기술 엔드포인트가 일치하지 않습니다. | Microsoft Entra ID 앱의 홈페이지 URL 도메인 및 매니페스트 URL 도메인이 일치해야 합니다. 동일한 테넌트 제한 참조 |
| 기술은 로그인한 사용자의 테넌트에서 호스트됩니다. | APPID_NOT_IN_TENANT |
기술을 추가하려면 먼저 등록해야 합니다. | 관리자는 로그인한 사용자의 조직에 기술을 등록해야 합니다. |
| 작업이 제한됩니다. | LIMITS_TOO_MANY_ACTIONS |
100개의 작업에만 사용할 수 있게 제한된 기술입니다. | 기술 매니페스트에 정의된 기술 작업이 너무 많습니다. 작업을 제거하고 다시 시도하십시오. |
| 작업 입력 매개 변수가 제한됨 | LIMITS_TOO_MANY_INPUTS |
작업은 25개 입력으로 제한됩니다. | 기술 작업 입력 매개 변수가 너무 많습니다. 매개 변수를 제거하고 다시 시도하십시오. |
| 작업 출력 매개 변수가 제한됨 | LIMITS_TOO_MANY_OUTPUTS |
작업은 25개 출력으로 제한됩니다. | 기술 작업 출력 매개 변수가 너무 많습니다. 매개 변수를 제거하고 다시 시도합니다. |
| 기술 수가 제한됩니다. | LIMITS_TOO_MANY_SKILLS |
봇은 최대 25개 기술을 가질 수 있습니다. | 봇에 너무 많은 기술이 추가되었습니다. 기존 기술을 제거하고 다시 시도하십시오. |
| 보안 토큰이 유효합니다. | AADERROR_OTHER |
뭔가 잘못 된 것 같습니다. | 기술을 트리거하기 위해 보안 토큰을 획득하는 동안 일시적인 오류가 발생할 수 있습니다. 기술 가져오기를 다시 시도합니다. |
| 기술이 정상입니다. |
ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED |
기술을 검사하는 동안 문제가 발생했습니다. | Copilot Studio는 기술로 활동을 보낼 EndOfConversation 때 알 수 없는 응답을 받았습니다. 기술이 실행 중이고 올바르게 응답하는지 확인합니다. |
| 기술 권한이 부여됨 | ENDPOINT_HEALTHCHECK_UNAUTHORIZED |
이 기술은 봇을 허용 목록에 추가하지 않았습니다. | 봇이 기술의 허용 목록에 있는지 확인합니다. 자세한 내용은 기술 구성 방법을 Copilot Studio를 참조하세요. |