Procedimientos recomendados para configurar el manifiesto

En este artículo se enumeran los procedimientos recomendados para configurar el manifiesto YAML. Para los asociados que publican en el Almacén de seguridad, consulte Publicar en la Tienda.

1. Solo puede haber uno AgentDefinition en el manifiesto del agente yaml.

2. FetchSkill y ProcessSkill deben tener espacio de nombres en el conjunto de aptitudes. Deben seguir el formato Skillset name.Skill name. Vea , FetchSkill y ProcessSkill.

3. Algunos punteros en ChildSkills:

• Si se define una aptitud en el mismo manifiesto YAML, se debe hacer referencia a ella en ChildSkills. En el ejemplo siguiente, SkillA es una GPT aptitud definida en el manifiesto y agregada a la aptitud secundaria.

• ChildSkills se puede definir en un manifiesto de especificación de OpenAPI. Por ejemplo, SkillB se debería haber definido en el manifiesto de especificación de OpenAPI. Para obtener más información, consulte Ejemplo de herramienta de API.

• Puede formar parte de un complemento existente que se encuentra en RequiredskillsetsAgentdefinition. Por ejemplo, si SkillC se define en otro manifiesto YAML, se debe hacer referencia a él en 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
  
  

4. El nombre del conjunto de aptitudes, que es el Descriptor.name que debe coincidir con el RequiredSkillsets valor Por ejemplo, del ejemploDescriptor.name=Contoso.SecurityOperations.Samples-090925 yaML del manifiesto, que se debe agregar a RequiredSkillsets.

5. El manifiesto del agente solo admite un esquema de autenticación por agente. Para obtener más información, consulte Autenticación.