Visão geral do Skill Registry

O registro de habilidades serve como um repositório seguro, privado e de baixa latência para gerenciar as habilidades do agente. Cada habilidade é um pacote independente, incluindo instruções estruturais, código executável e documentação, projetado para ampliar as capacidades de um agente.

Ao centralizar essas habilidades, o Registro de Habilidades permite que os agentes descubram e carreguem dinamicamente os recursos mais relevantes com base na intenção do usuário, otimizando o desempenho e garantindo um ambiente de execução seguro.

Principais conceitos

O registro de habilidades apresenta duas entidades de API padrão de nível superior para gerenciar o ciclo de vida e o controle de versões:

Conceito Descrição
Habilidade Uma entidade mutável de nível superior que contém metadados (como nome de exibição, carimbos de data/hora de criação e atualização e rótulos), a revisão padrão e o conteúdo da habilidade.

Para ver exemplos da estrutura de habilidade esperada, consulte os arquivos SKILL.md no repositório de habilidades do Google Cloud.
Revisão de habilidade Um snapshot imutável de uma versão específica da habilidade. Ele inclui um nome, uma descrição e uma referência imutável ao recurso de habilidade pai.

Validação do payload de habilidade

Para garantir que os agentes possam usar conteúdo de habilidade válido, o sistema verifica automaticamente todos os payloads de habilidade durante a criação ou atualização. Essas validações são realizadas de forma assíncrona.

A operação assíncrona falhará com um erro de validação se o sistema detectar qualquer um dos seguintes:

  • O arquivo não é um arquivo ZIP adequado ou não tem informações importantes.
  • O arquivo ZIP está vazio.
  • O arquivo ZIP tem mais de 10.000 itens.
  • Os nomes de arquivos ou pastas no ZIP contêm .. ou começam com / ou \\.
  • O arquivo ZIP contém links simbólicos.
  • Há nomes de arquivos ou pastas duplicados no arquivo ZIP.
  • O tamanho total de todos os arquivos dentro do ZIP é maior que 500 MB quando descompactado.
  • O arquivo está muito compactado, com uma taxa de compactação acima de 100.
  • As pastas dentro do ZIP têm mais de 8 níveis de profundidade.
  • O arquivo ZIP não contém um arquivo SKILL.md.
  • O arquivo SKILL.md tem os seguintes problemas:
    • O arquivo SKILL.md não tem o front matter YAML obrigatório ou o conteúdo Markdown esperado.
    • O campo de nome no front matter do YAML está ausente, excede 64 caracteres, começa ou termina com um hífen ou contém caracteres que não são letras minúsculas, números e hifens.
    • O campo de descrição no front matter do YAML está ausente ou excede 1.024 caracteres.
    • O campo de licença no front matter do YAML excede 1.024 caracteres.
    • As instruções no arquivo SKILL.md excedem 500.000 caracteres.
  • O arquivo ZIP tem mais de 10 MB.

Habilidades integradas

O Registro de Habilidades inclui uma habilidade gcp-skill-registry integrada. Essa habilidade permite que os agentes interajam com o registro de habilidades para criar, pesquisar e gerenciar as habilidades disponíveis, permitindo que eles registrem novas funcionalidades ou descubram recursos existentes. O Google gerencia o ciclo de vida, o lançamento e o controle de versões dessa habilidade integrada, garantindo a funcionalidade imediata.

A seguir

Guia

Saiba como criar, atualizar, pesquisar e excluir habilidades no Registro de Habilidades.