Descripción general de Skill Registry

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 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 de nivel superior para administrar el ciclo de vida y el control de versiones:

Concepto Descripción
Habilidad Una entidad mutable de nivel superior que contiene metadatos (como el nombre visible, marcas de tiempo de creación y actualización, y etiquetas), la revisión predeterminada y el contenido de la habilidad.

Para obtener ejemplos de la estructura de habilidad esperada, consulta los SKILL.md archivos en el repositorio de Google Cloud Skills.
Revisión de habilidad Una instantánea inmutable de una versión de habilidad específica. 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 habilidad 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 casos:

  • 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 en su interior.
  • Los nombres de los archivos o las carpetas en el 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 ZIP supera los 500 MB cuando se descomprime.
  • El archivo está demasiado comprimido, con una proporción de compresión superior a 100.
  • Las carpetas dentro del ZIP tienen más de 8 niveles de profundidad.
  • El archivo ZIP no contiene un archivo SKILL.md.
  • El archivo SKILL.md tiene los siguientes problemas:
    • Falta el asunto de YAML obligatorio o el contenido de Markdown esperado en el archivo SKILL.md.
    • Falta el campo de nombre en el asunto de 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 el asunto de YAML o supera los 1,024 caracteres.
    • El campo de licencia en el asunto de YAML supera los 1,024 caracteres.
    • Las instrucciones en el archivo SKILL.md superan los 500,000 caracteres.
  • El archivo comprimido tiene más de 10 MB.

Habilidades integradas

Skill Registry incluye una habilidad gcp-skill-registry integrada. Esta habilidad permite que los agentes interactúen con Skill Registry para crear, buscar y administrar las habilidades disponibles, lo que les permite registrar funciones nuevas 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?

Guía

Aprende a crear, actualizar, buscar y borrar habilidades en Skill Registry.