Поделиться через


Рекомендации по настройке манифеста

В этой статье перечислены рекомендации по настройке YAML манифеста. Сведения о партнерах, публикующих в Хранилище безопасности, см. в разделе Публикация в Store.

  1. В yaml манифеста агента может быть только один AgentDefinition .

  2. FetchSkill и ProcessSkill должны быть пространством имен в наборе навыков. Они должны соответствовать формату Skillset name.Skill name. См . FetchSkill и ProcessSkill.

  3. Несколько указателей на ChildSkills:

  • Если навык определен в том же манифесте YAML, на него необходимо ссылаться в разделе ChildSkills. В следующем примере — это навык, SkillA определенный GPT в манифесте и добавленный к дочернему навыку.

  • ChildSkills можно определить в манифесте спецификации OpenAPI. Например, SkillB должен быть определен в манифесте спецификации OpenAPI. Дополнительные сведения см. в разделе Пример средства API.

  • Он может быть частью существующего подключаемого модуля, который находится в RequiredskillsetsAgentdefinition. Например, если SkillC определен в другом манифесте YAML, на него необходимо ссылаться в разделе 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 Например, из примераDescriptor.name=Contoso.SecurityOperations.Samples-090925 YAML манифеста, который должен быть добавлен в RequiredSkillsets.

  2. Манифест агента поддерживает только одну схему проверки подлинности для каждого агента. Дополнительные сведения см. в разделе Проверка подлинности.