Práticas recomendadas para configurar seu manifesto YAML

Este artigo lista as práticas recomendadas para configurar seu YAML de manifesto. Para parceiros que publicam no Security Store, consulte Publicar na Store.

  1. Só pode haver um AgentDefinition no yaml de manifesto do agente.

  2. FetchSkill e ProcessSkill deve ser nomeado por conjunto de habilidades. Eles devem seguir o formato Skillset name.Skill name. Veja, FetchSkill e ProcessSkill.

  3. Algumas dicas sobre ChildSkills:

  • Se uma habilidade for definida no mesmo YAML de manifesto, ela deverá ser referenciada em ChildSkills. No exemplo a seguir, SkillA é uma GPT habilidade definida no manifesto e adicionada à habilidade filho.

  • ChildSkills pode ser definido em um manifesto de especificação OpenAPI. Por exemplo, SkillB deveria ter sido definido no manifesto de especificação OpenAPI. Para obter mais informações, consulte Exemplo de ferramenta de API.

  • Ele pode fazer parte de um plug-in existente que está no RequiredskillsetsAgentdefinition. Por exemplo, if SkillC for definido em outro YAML de manifesto, ele deverá ser referenciado em 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. O nome do conjunto de habilidades, que é o Descriptor.name deve corresponder ao RequiredSkillsets valor Por exemplo, do exemploDescriptor.name=Contoso.SecurityOperations.Samples-090925 YAML de manifesto, que deve ser adicionado a RequiredSkillsets.

  2. O manifesto do Agente suporta apenas um esquema de autenticação por Agente. Para obter mais informações, consulte Autenticação.

  • Last updated on