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 extender 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 pertinentes según la intención del usuario, lo que optimiza el rendimiento y garantiza un entorno de ejecución seguro.
Conceptos clave
El registro de habilidades presenta dos entidades de API estándar 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 habilidad.
Para ver ejemplos de la estructura de habilidades esperada, consulta los archivos SKILL.md en el repositorio de habilidades de Google Cloud.
|
| Revisión de habilidades | Es una instantánea inmutable de una versión específica de una habilidad. Incluye un nombre, una descripción y una referencia inmutable al recurso de habilidad superior. |
Validación de la carga útil de la habilidad
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 alguno de los siguientes problemas:
- El archivo no es un archivo ZIP adecuado o le falta información clave.
- El archivo ZIP está vacío.
- El archivo ZIP tiene más de 10,000 elementos.
- Los nombres de los archivos o las carpetas del 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:- Al archivo
SKILL.mdle falta el material de referencia de YAML obligatorio o el contenido de Markdown esperado. - Falta el campo de nombre en la materia preliminar de YAML, supera los 64 caracteres, comienza o termina con un guion, o contiene caracteres que no son letras minúsculas, números y 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.
- Al archivo
- El archivo ZIP supera los 10 MB.
Habilidades integradas
El registro de habilidades incluye una habilidad de 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
las capacidades existentes. Google administra el ciclo de vida, el lanzamiento y el control de versiones de
esta habilidad integrada, lo que garantiza una funcionalidad lista para usar.
¿Qué sigue?
Crea y administra habilidades
Aprende a crear, actualizar, buscar y borrar habilidades en el Registro de habilidades.