Skill Registry funciona como un repositorio seguro, privado y de baja latencia para administrar las habilidades de los agentes. Cada habilidad es un paquete independiente que incluye instrucciones estructurales, código ejecutable y documentación, diseñado para ampliar las capacidades de un agente.
Al centralizar estas habilidades, Skill Registry permite que los agentes descubran y carguen de forma dinámica las capacidades más relevantes según la intención del usuario, lo que optimiza el rendimiento y garantiza un entorno de ejecución seguro.
Conceptos clave
Skill Registry presenta dos entidades de API estándar y de nivel superior para administrar el ciclo de vida y el control de versiones:
| Concepto | Descripción |
|---|---|
| Habilidad |
Es una entidad mutable de nivel superior que contiene metadatos (como el nombre visible, las marcas de tiempo de creación y actualización, y las etiquetas), la revisión predeterminada y el contenido de la skill.
Para ver ejemplos de la estructura de habilidad esperada, consulta los archivos SKILL.md en el repositorio de Google Cloud Skills.
|
| Revisión de habilidades | Es una instantánea inmutable de una versión específica de la skill. Incluye un nombre, una descripción y una referencia inmutable al recurso de habilidad principal. |
Validación de la carga útil de la skill
Para garantizar que los agentes puedan usar contenido de habilidades válido, el sistema verifica automáticamente todas las cargas útiles de habilidades durante la creación o las actualizaciones. Estas validaciones se realizan de forma asíncrona.
La operación asíncrona falla con un error de validación si el sistema detecta cualquiera de los siguientes casos:
- El archivo no es un archivo zip adecuado o le falta información clave.
- El archivo ZIP está vacío.
- El archivo ZIP contiene más de 10,000 elementos.
- Los nombres de los archivos o las carpetas en el archivo ZIP contienen
..o comienzan con/o\\. - El archivo ZIP contiene vínculos simbólicos.
- Hay nombres de archivos o carpetas duplicados en el archivo ZIP.
- El tamaño total de todos los archivos dentro del archivo ZIP supera los 500 MB cuando se descomprime.
- El archivo está demasiado comprimido, con una relación de compresión superior a 100.
- Las carpetas dentro del archivo ZIP tienen más de 8 niveles de profundidad.
- El archivo ZIP no contiene un archivo
SKILL.md. - El archivo
SKILL.mdtiene los siguientes problemas:- Falta el material de referencia de YAML obligatorio o el contenido de Markdown esperado en el archivo
SKILL.md. - Falta el campo name en el encabezado YAML, supera los 64 caracteres, comienza o termina con un guion, o contiene caracteres que no son letras minúsculas, números ni guiones.
- Falta el campo de descripción en los metadatos iniciales de YAML o supera los 1,024 caracteres.
- El campo de licencia en el encabezado YAML supera los 1,024 caracteres.
- Las instrucciones del archivo
SKILL.mdsuperan los 500,000 caracteres.
- Falta el material de referencia de YAML obligatorio o el contenido de Markdown esperado en el archivo
- El archivo comprimido tiene un tamaño superior a 10 MB.
Habilidades integradas
Skill Registry incluye una habilidad gcp-skill-registry integrada. Esta habilidad permite que los agentes interactúen con el Registro de habilidades para crear, buscar y administrar las habilidades disponibles, lo que les permite registrar nuevas funciones o descubrir capacidades existentes. Google administra el ciclo de vida, el lanzamiento y el control de versiones de esta habilidad integrada, lo que garantiza la funcionalidad lista para usar.
¿Qué sigue?
Crear y administrar habilidades
Aprende a crear, actualizar, buscar y borrar habilidades en el Registro de habilidades.