通过

配置清单的最佳做法

本文列出了配置清单 YAML 的最佳做法。 对于发布到安全存储的合作伙伴，请参阅 发布到应用商店。

  1. 代理清单 yaml 中只能有一个 AgentDefinition 。

  2. FetchSkill 和 ProcessSkill 必须由技能组命名空间。 它们必须遵循 格式 Skillset name.Skill name。 请参阅 FetchSkill 和 ProcessSkill。

  3. 上的 ChildSkills几个指针：

  • 如果技能在同一清单 YAML 中定义，则必须在 下 ChildSkills引用它。 在以下示例中， SkillA 是在 GPT 清单中定义的技能，并添加到子技能中。

  • ChildSkills 可以在 OpenAPI 规范清单中定义。 例如， SkillB 应在 OpenAPI 规范清单中定义。 有关详细信息，请参阅 API 工具示例。

  • 它可以是 中的 Requiredskillsets 现有插件的一 Agentdefinition部分。 例如，如果在 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 ，例如，清单 YAML 示例中Descriptor.name=Contoso.SecurityOperations.Samples-090925的值应添加到 RequiredSkillsets。

  2. 代理清单仅支持每个代理一个身份验证方案。 有关详细信息，请参阅 身份验证。

  • Last updated on