O Skill Registry serve como um repositório seguro, particular e de baixa latência para gerenciar as habilidades dos agentes. 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 Skill Registry permite que os agentes descubram e carreguem dinamicamente as funcionalidades mais relevantes com base na intenção do usuário, otimizando a performance e garantindo um ambiente de execução seguro.
Principais conceitos
O Skill Registry apresenta duas entidades de API padrão de nível superior para gerenciar ciclo de vida e 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 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 de uma habilidade. Ele inclui um nome, uma descrição e uma referência imutável ao recurso de habilidade principal. |
Validação de 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ções. Essas validações são realizadas de forma assíncrona.
A operação assíncrona falha com um erro de validação se o sistema detectar alguma das seguintes situações:
- O arquivo não é um 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 oito níveis de profundidade.
- O arquivo ZIP não contém um arquivo
SKILL.md. - O arquivo
SKILL.mdtem os seguintes problemas:- O arquivo
SKILL.mdnão tem o front-end YAML obrigatório ou o conteúdo Markdown esperado. - O campo "name" no front-matter YAML está faltando, excede 64 caracteres, começa ou termina com um hífen ou contém caracteres diferentes de letras minúsculas, números e hifens.
- O campo de descrição no frontmatter YAML está faltando ou excede 1.024 caracteres.
- O campo de licença no frontmatter YAML excede 1.024 caracteres.
- As instruções no arquivo
SKILL.mdexcedem 500.000 caracteres.
- O arquivo
- O arquivo compactado tem mais de 10 MB.
Habilidades integradas
O Skill Registry inclui uma habilidade gcp-skill-registry integrada. Com essa habilidade, os agentes podem interagir 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 skill integrada, garantindo a funcionalidade pronta para uso.
A seguir
Criar e gerenciar habilidades
Saiba como criar, atualizar, pesquisar e excluir habilidades no Skill Registry.