Partager via

Bonnes pratiques pour la configuration de votre manifeste

Cet article répertorie les meilleures pratiques pour la configuration de votre manifeste YAML. Pour les partenaires qui publient sur le Magasin de sécurité, consultez Publier dans le Windows Store.

  1. Il ne peut y en avoir qu’un AgentDefinition seul dans le fichier yaml du manifeste de l’agent.

  2. FetchSkill et ProcessSkill doivent être espace de noms par ensemble de compétences. Ils doivent suivre le format Skillset name.Skill name. Consultez FetchSkill et ProcessSkill.

  3. Quelques pointeurs sur ChildSkills:

  • Si une compétence est définie dans le même manifeste YAML, elle doit être référencée sous ChildSkills. Dans l’exemple suivant, SkillA est une GPT compétence définie dans le manifeste et ajoutée à la compétence enfant.

  • ChildSkills peut être défini dans un manifeste de spécification OpenAPI. Par exemple, SkillB doit avoir été défini dans le manifeste de spécification OpenAPI. Pour plus d’informations, consultez Exemple d’outil API.

  • Il peut faire partie d’un plug-in existant qui se trouve dans Requiredskillsets le Agentdefinition. Par exemple, si SkillC est défini dans un autre manifeste YAML, il doit être référencé sous 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. Le nom de l’ensemble de compétences, qui est le Descriptor.name doit correspondre à la RequiredSkillsets valeur Par exemple, à partir de l’exempleContoso.SecurityOperations.Samples-090925Descriptor.name=de manifeste YAML, qui doit être ajouté à RequiredSkillsets.

  2. Le manifeste de l’agent ne prend en charge qu’un seul schéma d’authentification par agent. Pour plus d’informations, consultez Authentification.

  • Last updated on