Power Virtual Agents에 대한 스킬 구현Implement a skill for use in Power Virtual Agents

적용 대상: SDK v4APPLIES TO: SDK v4

스킬은 다른 봇에서 사용할 수 있는 봇입니다.A skill is a bot that can be used by another bot. 이러한 방식으로 단일 사용자 지향 봇을 만들고 이를 하나 이상의 스킬로 확장할 수 있습니다.In this way you can create a single user-facing bot and extend it with one or more skills. 일반적인 스킬에 대한 자세한 내용은 스킬 개요스킬 구현하기에서 빌드하는 방법을 알아볼 수 있습니다.You can learn more about skills in general in Skills Overview, and how to build them in Implement a skill. 또는 가상 길잡이 템플릿에는 처음부터 새로 빌드하는 대신 사용자 지정 및 배포할 수 있는 미리 빌드된 스킬 세트가 포함되어 있습니다.Alternatively, the Virtual Assistant templates contain a set of pre-built skills you can customize and deploy instead of building one from scratch.

Power Virtual Agents 봇에서 기술을 사용할 것으로 예상하는 경우 고려해야 할 기술에 몇 가지 추가 제한이 있습니다.If you expect that your skill will be consumed from a Power Virtual Agents bot, there are some additional restrictions placed on your skill you'll need to account for.

매니페스트 제한 사항Manifest restrictions

Power Virtual Agents는 스킬 매니페스트에서 선언할 수 있는 항목에 대해 제한 사항을 둡니다.Power Virtual Agents places restrictions on what you may declare in your skill manifest.

  • 100개 이하의 작업만 선언할 수 있습니다.You may declare only 100 or fewer actions.
  • 각 작업은 25개 이하의 입력 또는 출력으로 제한됩니다.Each action is limited to 25 or fewer inputs or outputs.
  • 입력 또는 출력에는 배열 형식을 사용할 수 없습니다.You cannot use the array type for inputs or outputs.

동일 테넌트 제한 사항Same-tenant restriction

Power Virtual Agents 내에서 사용하기 위해 등록된 사용자 지정 스킬에 대한 규정 준수 및 적절한 거버넌스를 보장하기 위해 스킬 봇은 Azure Active Directory에서 등록된 애플리케이션이어야 합니다.In order to ensure compliance and adequate governance of custom skills being registered for use within Power Virtual Agents, your skill bot must be a registered application in Azure Active Directory. 스킬 추가 시, 스킬의 애플리케이션 ID가 로그인한 사용자의 테넌트에 있고 스킬 엔드포인트가 등록된 애플리케이션의 Home Page URL과 일치하는지 확인합니다.Upon adding a skill, we validate if the skill's application ID is the in the tenant of the signed in user and the skills endpoint matches the registered application's Home Page URL.

Power Virtual Agents 내에서 봇을 스킬으로 등록하려면 먼저 Azure Portal의 홈페이지를 봇의 스킬 매니페스트 URL로 설정해야 합니다.Before you can register your bot as a skill within Power Virtual Agents, you must ensure that for the bot, the home page in the Azure Portal is set to the bot's skill manifest URL.

스킬을 등록하는 동안 수행된 유효성 검사Validation performed during registering a Skill

최종 사용자가 Power Virtual Agent 봇에서 스킬에 연결하려고 할 때 먼저 Power Virtual Agents로 스킬을 가져와야 합니다.When an end user attempts to connect to your skill from their Power Virtual Agents bot, they'll first need to import the skill to Power Virtual Agents. 스킬이 일련의 유효성 검사를 진행합니다.Your skill will go through a series of validation checks. 이러한 검사 중 하나에 오류가 발생하면 다음 표에 설명된 오류 메시지가 표시될 수 있습니다.A failure of one of these checks may result in an error message as described in this table.

유효성 검사 단계Validation step 오류 코드Error code 오류 메시지Error message 설명 또는 완화Description or mitigation
매니페스트 URL이 유효합니다.Manifest URL is valid URL_MALFORMED, URL_NOT_HTTPSURL_MALFORMED, URL_NOT_HTTPS 링크가 잘못되었습니다. 링크는 https://로 시작해야 합니다.The link isn't valid; The link must begin with https:// 보안 URL로 링크를 다시 입력합니다.Re-enter the link as a secure URL.
매니페스트를 검색할 수 있습니다.Manifest is retrievable MANIFEST_FETCH_FAILED 스킬 매니페스트를 가져오는 동안 문제가 발생했습니다.We ran into problems getting the skill manifest. 매니페스트 URL이 매니페스트에 대한 링크인지 확인합니다. 웹 브라우저에서 매니페스트 URL을 열어 보세요.Verify your manifest URL is a link to your manifest; try opening your manifest URL in a web browser. URL이 10초 이내에 페이지를 렌더링하는 경우 기술을 다시 등록합니다.If the URL renders the page within 10 seconds, re-register your skill.
매니페스트를 읽을 수 있습니다.Manifest is readable MANIFEST_TOO_LARGE 매니페스트가 너무 큽니까.The manifest is too large. 매니페스트는 500KB 이하여야 합니다.Your manifest must be 500 KB or less.
매니페스트를 읽을 수 있습니다.Manifest is readable MANIFEST_MALFORMED 매니페스트가 호환되지 않습니다.The manifest is incompatible. 매니페스트가 유효한 JSON 파일인지 확인합니다.Check if the manifest is a valid JSON file. 매니페스트에 , 등과 같은 필수 속성이 포함되어 있는지 name msaAppId 확인합니다.Check if the manifest contains required properties, such as name, msaAppId, and so on. 자세한 내용은 매니페스트 제한을 참조하세요.See Manifest restrictions for more information.
기술이 아직 등록되지 않았습니다.Skill is not yet registered MANIFEST_ALREADY_IMPORTED 이 스킬은 이미 봇에 추가되었습니다.This skill has already been added to your bot. 기술을 삭제하고 다시 등록합니다.Delete the skill and register it again.
매니페스트 엔드포인트 및 홈페이지 도메인 일치Manifest endpoint and homepage domains match MANIFEST_ENDPOINT_ORIGIN_MISMATCH 스킬 엔드포인트가 일치하지 않습니다.There's a mismatch in your skill endpoints. Azure AD 앱의 홈페이지 URL 도메인 및 매니페스트 URL 도메인이 일치해야 합니다.You Azure AD app's homepage URL domain and manifest URL domain must match. 동일 테넌트 제한 사항을 참조하세요.See Same-tenant restriction
기술이 로그인한 사용자의 테넌트에서 호스팅됩니다.Skill is hosted in signed in user's tenant APPID_NOT_IN_TENANT 스킬을 추가하려면 먼저 등록해야 합니다.To add a skill, it must first be registered. 전역 관리자는 로그인한 사용자의 조직에 스킬을 등록해야 합니다.A global administrator must register the skill into the signed in user's organization.
작업이 제한됩니다.Actions are limited LIMITS_TOO_MANY_ACTIONS 기술은 100개 작업으로 제한됩니다.The skill is limited to 100 actions. 스킬 매니페스트에 정의된 스킬 작업이 너무 많습니다.There are too many skill actions defined in skill manifest. 작업을 제거하고 다시 시도하세요.Remove actions and try again.
작업 입력 매개 변수가 제한됩니다.Action input parameters are limited LIMITS_TOO_MANY_INPUTS 작업은 입력 25개로 제한됩니다.Actions are limited to 25 inputs. 스킬 작업 입력 매개 변수가 너무 많습니다.There are too many skill action input parameters. 매개 변수를 제거하고 다시 시도하세요.Remove parameters and try again.
작업 출력 매개 변수가 제한됩니다.Action output parameters are limited LIMITS_TOO_MANY_OUTPUTS 작업은 출력 25개로 제한됩니다.Actions are limited to 25 outputs. 스킬 작업 출력 매개 변수가 너무 많습니다.There are too many skill action output parameters. 매개 변수를 제거하고 다시 시도하세요.Remove parameter and try again.
기술 수가 제한됩니다.Skill count is limited LIMITS_TOO_MANY_SKILLS 봇의 최대 스킬 수는 25개입니다.Your bot can have a maximum of 25 skills. 봇에 추가된 스킬이 너무 많습니다.There are too many skills added into a bot. 기존 스킬을 제거한 후 다시 시도하세요.Remove an existing skill and try again.
보안 토큰이 유효합니다.Security token is valid AADERROR_OTHER 문제가 발생한 것 같습니다.It looks like something went wrong. 스킬을 트리거하기 위한 보안 토큰을 획득하는 중 일시적인 오류가 발생할 수 있습니다.There may be a transient error to acquire a security token to trigger the skill. 스킬 가져오기를 다시 시도하세요.Retry importing the skill.
기술이 정상입니다.Skill is healthy ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILEDENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED 스킬을 검사하는 동안 문제가 발생했습니다.Something went wrong while checking your skill. Power Virtual Agents 스킬에 활동을 보낼 때 알 수 없는 응답을 EndOfConversation 받았습니다.Power Virtual Agents received an unknown response when sending an EndOfConversation activity to your skill. 스킬이 실행 중이고 올바르게 응답하는지 확인하세요.Make sure your skill is running and responding correctly.
기술 권한이 부여되었습니다.Skill is authorized ENDPOINT_HEALTHCHECK_UNAUTHORIZED 이 기술은 봇을 허용 목록에 추가하지 않았습니다.This skill has not allow-listed your bot. 봇이 기술의 허용 목록에 추가되었는지 확인합니다.Check if your bot has been added to the skill's allow list. 자세한 내용은 기술 구성 방법 Power Virtual Agents 참조하세요.For more information, see the Power Virtual Agents how to Configure a Skill.