次の方法で共有

マニフェストを構成するためのベスト プラクティス

この記事では、マニフェスト YAML を構成するためのベスト プラクティスの一覧を示します。 セキュリティ ストアに発行するパートナーについては、「ストア に発行する」を参照してください。

  1. エージェント マニフェスト yaml には 1 つの AgentDefinition しか存在できません。

  2. FetchSkill と ProcessSkill はスキルセットによって名前空間化する必要があります。 形式 Skillset name.Skill nameに従う必要があります。 「FetchSkill」および「ProcessSkill」を参照してください。

  3. ChildSkills上のいくつかのポインター:

  • スキルが同じマニフェスト YAML で定義されている場合は、 ChildSkillsで参照する必要があります。 次の例から、 SkillA はマニフェストで定義され、子スキルに追加された GPT スキルです。

  • ChildSkills は、OpenAPI 仕様マニフェストで定義できます。 たとえば、 SkillB は OpenAPI 仕様マニフェストで定義されている必要があります。 詳細については、「 API ツールのサンプル」を参照してください。

  • これは、AgentdefinitionのRequiredskillsetsにある既存のプラグインの一部である可能性があります。 たとえば、 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-090925RequiredSkillsetsに追加する必要があります。

  2. エージェント マニフェストでは、エージェントごとに 1 つの認証スキームのみがサポートされます。 詳細については、「 認証」を参照してください。

  • Last updated on