다음을 통해 공유


매니페스트를 구성하기 위한 모범 사례

이 문서에서는 매니페스트 YAML을 구성하기 위한 모범 사례를 나열합니다. Security Store에 게시하는 파트너는 스토어에 게시를 참조하세요.

  1. 에이전트 매니페스트 yaml에는 하나 AgentDefinition 만 있을 수 있습니다.

  2. FetchSkillProcessSkill 은 기술 세트로 이름을 지정해야 합니다. 형식 Skillset name.Skill name을 따라야 합니다. FetchSkill 및 ProcessSkill을 참조하세요.

  3. 에 대한 ChildSkills몇 가지 포인터입니다.

  • 기술이 동일한 매니페스트 YAML에 정의된 경우 에서 ChildSkills참조해야 합니다. 다음 예제 SkillA 에서 은 매니페스트에 정의되고 자식 기술에 추가된 기술입니다 GPT .

  • ChildSkills 는 OpenAPI 사양 매니페스트에서 정의할 수 있습니다. 예를 들어 는 SkillB OpenAPI 사양 매니페스트에 정의되어 있어야 합니다. 자세한 내용은 API 도구 샘플을 참조하세요.

  • 에 있는 기존 플러그 인 RequiredskillsetsAgentdefinition의 일부일 수 있습니다. 예를 들어 가 다른 매니페스트 YAML에 정의된 경우 SkillC 에서 Requiredskillsets참조해야 합니다.

    
    SkillGroups:
    
     - Format: Agent
        - Name:
          Settings:
          ChildSkills:
           - SkillA # part of the current manifest (plugin) yaml
           - SkillB # this should be part of the API OpenAPI skill group
           - SkillC # if it is in another manifest, the manifest must be included in the RequiredSkillSets of the AgentDefinition
      - Format: GPT
        - Name: SkillA
          template:
      - Format: API
        Settings:
          openApispecUrl: https://raw.githubusercontent.com/microsoftgraph/msgraph-metadata/main/v1.0/swagger.json
     AgentDefinitions:
      - Name: AgentDefinitionSample
       Description: This skill provides access to Microsoft Graph API functionalities.
       RequiredSkillSets:
        - MicrosoftGraphAPI # has SkillC
    
    
  1. 기술 세트 이름( 이)은 Descriptor.name 에 추가RequiredSkillsets되어야 하는 매니페스트 YAML 샘플Descriptor.name=Contoso.SecurityOperations.Samples-090925의 값과 일치 RequiredSkillsets 해야 합니다.

  2. 에이전트 매니페스트는 에이전트당 하나의 인증 체계만 지원합니다. 자세한 내용은 인증을 참조 하세요.