Compartilhar via

Melhores práticas para configurar o manifesto

Este artigo lista as melhores práticas para configurar o seu manifesto YAML. Para parceiros que publicam na Loja de Segurança, consulte Publicar na Loja.

  1. Só pode existir um AgentDefinition no yaml do manifesto do Agente.

  2. FetchSkill e ProcessSkill tem de ter nomes espaçados por conjunto de competências. Têm de seguir o formato Skillset name.Skill name. Veja FetchSkill e ProcessSkill.

  3. Alguns ponteiros em ChildSkills:

  • Se uma competência for definida no mesmo MANIFESTO YAML, tem de ser referenciada em ChildSkills. No exemplo seguinte, SkillA encontra-se uma GPT competência definida no manifesto e adicionada à competência subordinada.

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

  • Pode fazer parte de um plug-in existente que está no RequiredskillsetsAgentdefinition. Por exemplo, se SkillC estiver definido noutro YAML de manifesto, tem de ser referenciado Requiredskillsetsem .

    
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 competências, que corresponde ao Descriptor.nameRequiredSkillsets valor Por exemplo, do exemplo YAMLDescriptor.name=Contoso.SecurityOperations.Samples-090925 do 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, veja Autenticação.

  • Last updated on