O Registro de habilidades serve como um repositório seguro, particular 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 estender os recursos 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 exemplos da estrutura de habilidades esperada, consulte os arquivos SKILL.md no repositório de habilidades do Google Cloud.
|
| Revisão de habilidades | Um snapshot imutável de uma versão específica de habilidade. Ele inclui um nome, uma descrição e uma referência imutável ao recurso de habilidade pai. |
Validação de payload de habilidades
Para garantir que os agentes possam usar conteúdo de habilidades válido, o sistema verifica automaticamente todos os payloads de habilidades 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 qualquer um dos seguintes:
- O arquivo não é um arquivo ZIP adequado ou está faltando informações importantes.
- O arquivo ZIP está vazio.
- O arquivo ZIP tem mais de 10.000 itens dentro.
- 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.mdtem os seguintes problemas:- O arquivo
SKILL.mdnão tem o front-matter YAML necessário ou o conteúdo Markdown esperado. - O campo de nome no front-matter YAML está ausente, excede 64 caracteres, começa ou termina com um hífen ou contém caracteres diferentes de letras minúsculas, números e hífens.
- O campo de descrição no front-matter YAML está ausente ou excede 1.024 caracteres.
- O campo de licença no front-matter 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 de tamanho.
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 habilidades disponíveis, permitindo que eles registrem novas funcionalidades ou descubram recursos atuais. O Google gerencia o ciclo de vida, o lançamento e o controle de versões dessa habilidade integrada, garantindo a funcionalidade pronta para uso.
A seguir
Criar e gerenciar habilidades
Saiba como criar, atualizar, pesquisar e excluir habilidades no Registro de habilidades.