Crea y administra habilidades

Las habilidades son instrucciones personalizadas reutilizables que ayudan al asistente de Gemini Enterprise a realizar tareas específicas, como revisar contratos legales o escribir con el tono de tu marca.

Cada habilidad es un paquete que contiene un archivo de instrucciones SKILL.md. Un paquete de habilidades también puede incluir secuencias de comandos, archivos o contexto de fondo que el asistente usa para completar una tarea. De forma predeterminada, Gemini Enterprise activa las habilidades que creas.

Ediciones compatibles

La capacidad de crear, subir o usar habilidades depende de la edición de Gemini Enterprise a la que te suscribas:

  • Estándar, Plus y Pago por uso: Puedes crear y subir habilidades personalizadas, y usar las habilidades administradas por Google y las creadas por los usuarios que se compartieron contigo.
  • Frontline: Puedes explorar, instalar y usar habilidades administradas por Google y habilidades creadas por usuarios que se compartieron contigo. No puedes crear ni subir habilidades personalizadas.

Descripción general

Estos son los aspectos clave de las habilidades:

  • Estándar abierto: Cada habilidad se basa en el estándar de habilidades abierto y se define con un archivo SKILL.md principal. Además, se puede extender con archivos o secuencias de comandos adicionales.
  • Extensión modular: Las habilidades te permiten enseñarle a un agente tareas específicas de un dominio con instrucciones y contexto personalizados.
  • Acceso dinámico: Gemini Enterprise accede a estas instrucciones especializadas automáticamente cuando son pertinentes para tu pregunta o tarea.

Crear una habilidad

Para crear una habilidad nueva en la app web de Gemini Enterprise, sigue estos pasos:

  1. Accede a la app web de Gemini Enterprise.
  2. En el menú de navegación, haz clic en Habilidades.
  3. Haz clic en el ícono agregar y, luego, en Crear habilidad con Gemini.
  4. Ingresa un nombre para tu habilidad.
  5. Ingresa una descripción. Gemini Enterprise usa la descripción para determinar si la habilidad puede ayudar con una instrucción o tarea. También puedes agregar instrucciones de activación a la descripción para ayudar a guiar a Gemini Enterprise.
  6. Proporciona las instrucciones de la habilidad con lenguaje natural en el cuadro de chat o en el campo Instrucciones. Para crear una habilidad con un archivo SKILL.md existente con Markdown personalizado o YAML, consulta Sube una habilidad.
  7. Haz clic en Guardar. Gemini Enterprise activa la nueva habilidad de forma predeterminada.

Cómo subir una habilidad

Para agregar habilidades existentes, súbelas como archivos Markdown o ZIP. Gemini Enterprise extrae automáticamente el nombre y la descripción de la habilidad del archivo SKILL.md.

Formato de archivo y estructura de directorios de Skill

Un paquete de habilidades consiste en un archivo de instrucciones SKILL.md obligatorio y subdirectorios opcionales para secuencias de comandos, documentación de referencia y recursos. Puedes subir un archivo SKILL.md independiente o un archivo ZIP con la siguiente estructura de directorios:

my-skill/
├── SKILL.md              # Required: YAML frontmatter + Markdown instructions
├── scripts/              # Optional: executable helper scripts (Python, Bash)
├── references/           # Optional: supplementary context loaded as needed
└── assets/               # Optional: templates or images used in output
Archivo o directorio Obligatorio Descripción
SKILL.md Sí Contiene los metadatos iniciales en formato YAML de la habilidad (como name y description) seguidos de instrucciones en Markdown que guían al asistente de Gemini Enterprise.
scripts/ No Secuencias de comandos auxiliares ejecutables de Python o Bash para operaciones determinísticas o repetidas.
references/ No Contexto complementario cargado a pedido, como esquemas, hojas de referencia o documentación de referencia de la API.
assets/ No Archivos que se usan en el resultado (como plantillas o imágenes) que no se cargan directamente en el contexto de la instrucción de Gemini Enterprise

Requisitos de los metadatos iniciales de YAML

El archivo SKILL.md debe comenzar con un bloque de metadatos iniciales de YAML válido encerrado entre delimitadores --- al principio del archivo, seguido del cuerpo de las instrucciones de Markdown (límite estricto de 500,000 caracteres; las cargas que superen este límite fallarán).

Los metadatos iniciales de YAML admiten los siguientes campos:

Campo Obligatorio Formato y restricciones
name Sí Es un identificador único para la habilidad (de 1 a 64 caracteres). Solo debe contener letras minúsculas (a-z), números (0-9) y guiones (-). No debe comenzar ni terminar con un guion (-) ni contener guiones consecutivos (--). Si se sube dentro de una carpeta, el valor name debe coincidir con el nombre de la carpeta superior.
description Sí Una descripción funcional (de 1 a 1,024 caracteres) que explique qué hace la habilidad y cuándo debería invocarla Gemini Enterprise. Incluye palabras clave activadoras para ayudar a Gemini Enterprise a identificar cuándo es pertinente la habilidad. Este es un límite estricto. Si la descripción supera los 1,024 caracteres, la carga de la habilidad fallará con el siguiente error: A field in your SKILL.md is too long. Shorten the name, description or the instructions.
license No Es la licencia de distribución de software o contenido que se aplica al paquete de habilidades (hasta 1,024 caracteres), como un identificador de licencia SPDX de código abierto (por ejemplo, Apache-2.0 o MIT) o Proprietary. Este campo especifica las condiciones de uso del archivo de habilidad en sí, no una licencia de suscripción de usuario o app de Gemini Enterprise. Si se especifica, el valor no debe estar vacío.
metadata No Es un mapa de pares clave-valor opcional de etiquetas, autores o parámetros de versión personalizados. Las claves deben ser cadenas escalares, y los valores deben ser cadenas escalares o listas de cadenas escalares.

Archivo SKILL.md de ejemplo

En el siguiente ejemplo, se muestra un archivo SKILL.md válido:

---
name: brand-voice-reviewer
description: Reviews marketing copy and legal contracts to ensure compliance with brand voice guidelines. Use when asked to review, edit, or draft customer-facing text.
---

# Brand Voice Reviewer

Follow these guidelines when reviewing or drafting customer-facing text:

1. Use clear, concise, and active language.
2. Avoid jargon and unverified claims.
3. Verify that terminology aligns with the company style guide.

Restricciones de los archivos ZIP

Cuando subas una habilidad como un archivo ZIP, asegúrate de que cumpla con los siguientes requisitos de validación:

  • Un solo archivo SKILL.md: Cada archivo ZIP debe contener exactamente un archivo SKILL.md ubicado en la raíz del archivo (SKILL.md) o dentro de una sola carpeta de wrapper de nivel superior (hasta 3 niveles de profundidad, como my-skill/SKILL.md).
  • Tamaño del archivo: El tamaño máximo del archivo ZIP comprimido es de 100 MB y el tamaño máximo total sin comprimir es de 100 MB.
  • Cantidad de archivos: Un máximo de 100 archivos por archivo ZIP.
  • Profundidad de anidamiento de directorios: Profundidad máxima de anidamiento de directorios de 10 niveles en relación con la raíz de la habilidad.
  • Integridad de la ruta de acceso: No se permiten las rutas de acceso de archivos duplicadas ni las referencias al directorio superior (..).

Sube una habilidad a la app web

Para subir una habilidad, sigue estos pasos:

  1. Accede a la app web de Gemini Enterprise.
  2. En el menú de navegación, haz clic en Habilidades.
  3. Haz clic en el ícono para agregar y, luego, en Subir habilidad.
  4. Arrastra o busca el archivo Markdown o ZIP, y haz clic en Importar. Gemini Enterprise activa la habilidad de forma predeterminada.

Explorar habilidades

Puedes explorar e instalar habilidades con las siguientes secciones para filtrar la lista:

Sección Descripción
Todos Tanto las habilidades administradas por Google como las creadas por el usuario.
Google Habilidades integradas proporcionadas por Google
Compartidos conmigo Habilidades de solo lectura creadas por el usuario que otros usuarios compartieron contigo.

Para explorar e instalar una habilidad, sigue estos pasos:

  1. Accede a la app web de Gemini Enterprise.
  2. En el menú de navegación, haz clic en Habilidades.
  3. Haz clic en el ícono para agregar y, luego, en Explorar habilidades.
  4. Busca la habilidad que quieres usar y haz clic en + Instalar.

Actualiza una habilidad

Para actualizar una habilidad existente, sigue estos pasos:

  1. Accede a la app web de Gemini Enterprise.
  2. En el menú de navegación, haz clic en Habilidades.
  3. Haz clic en el nombre de la habilidad que quieres actualizar.
  4. Haz clic en el ícono junto a la habilidad y, luego, en Editar.
  5. Realiza las actualizaciones necesarias en las instrucciones, el nombre o la descripción.
  6. Haz clic en Guardar.

Para volver a la página Habilidades, haz clic en Habilidades.

Cómo compartir una habilidad

Si tu administrador de Gemini Enterprise habilita el uso compartido de habilidades, puedes compartir las habilidades que crees con otros usuarios.

Para compartir una habilidad, sigue estos pasos:

  1. Accede a la app web de Gemini Enterprise.
  2. En el menú de navegación, haz clic en Habilidades.
  3. Busca la habilidad que creaste y que quieres compartir.
  4. Haz clic en el ícono de junto a la habilidad y, luego, en Compartir.
  5. En el cuadro de diálogo Compartir habilidad, ingresa las direcciones de correo electrónico separadas por comas de los usuarios con los que deseas compartir la habilidad.
  6. Haz clic en Listo.

Usa una habilidad

Puedes usar habilidades directamente en tus conversaciones de chat en la app web de Gemini Enterprise.

Prueba una habilidad desde la página Habilidades

Puedes probar una habilidad directamente desde la página Habilidades iniciando una nueva sesión de chat con esa habilidad:

  1. Accede a la app web de Gemini Enterprise.
  2. En el menú de navegación, haz clic en Habilidades.
  3. Haz clic en el ícono de junto a la habilidad y, luego, en Nuevo chat. Gemini Enterprise abre un chat nuevo que hace referencia a la habilidad seleccionada.

Invoca una habilidad en una conversación

Puedes invocar habilidades de forma dinámica durante una conversación para personalizar las respuestas del asistente.

Cuando chateas con el asistente de Gemini Enterprise, puedes usar las habilidades de las siguientes maneras:

  • Menciones manuales: Puedes invocar una habilidad de forma explícita con la función de mención @ o / en el cuadro de chat (por ejemplo, @Brand Voice o /Brand Voice). Si escribes /, se abrirá un menú que solo mostrará tus habilidades disponibles, mientras que si escribes @, se abrirá el menú de menciones generales.
  • Solicitudes directas: Si necesitas que Gemini Enterprise use una habilidad específica, puedes pedirla directamente en tu instrucción. Por ejemplo, Use the brand voice skill to review this.
  • Selección automática: Gemini Enterprise usa automáticamente una habilidad cuando es pertinente para tu tarea según la descripción de la habilidad y las instrucciones de activación.

Cómo desactivar una habilidad

Para evitar que Gemini Enterprise use una habilidad específica, desactívala. Cuando desactivas una habilidad, Gemini Enterprise no la invoca en las conversaciones.

Para desactivar una habilidad, sigue estos pasos:

  1. Accede a la app web de Gemini Enterprise.
  2. En el menú de navegación, haz clic en Habilidades.
  3. En la página Habilidades, busca la habilidad que quieras desactivar.
  4. Haz clic en el botón de activación junto a la habilidad para desactivarla.

Cómo desinstalar una habilidad

Para quitar una habilidad instalada de la página Habilidades, sigue estos pasos:

  1. Accede a la app web de Gemini Enterprise.
  2. En el menú de navegación, haz clic en Habilidades.
  3. Haz clic en el ícono junto a la habilidad y, luego, en Desinstalar.

Estados de las habilidades

Además de activar o desactivar las habilidades por tu cuenta, el administrador puede cambiar el estado de una habilidad, lo que afecta su disponibilidad:

  • Suspendida: El administrador desactiva temporalmente la habilidad. Permanece visible en la página Habilidades con un estado suspendido, pero otros usuarios no pueden invocarla en las conversaciones hasta que el administrador la vuelva a habilitar. Los propietarios de habilidades pueden actualizarlas y probarlas.
  • Inhabilitada: El administrador oculta temporalmente la habilidad a otros usuarios y la quita de su página Habilidades. La habilidad sigue siendo visible para su propietario, que puede actualizarla y probarla hasta que el administrador la vuelva a habilitar.
  • Borrada: El administrador quita la habilidad de forma permanente de la app web de Gemini Enterprise, por lo que ya no puedes usarla.

Limitaciones

En esta sección, se enumeran las limitaciones de las habilidades en Gemini Enterprise:

  • Las habilidades no están disponibles para usarse con agentes.
  • Las habilidades solo admiten la ejecución de Python y Bash.
  • El editor de la app web te permite crear habilidades ingresando instrucciones en los campos del formulario o chateando con el asistente, que genera automáticamente un solo archivoSKILL.md. Debes subir las habilidades más complejas que requieran secuencias de comandos o archivos adicionales como un archivo ZIP.
  • La creación de habilidades con lenguaje natural no usa el contexto de la conversación ni los conectores como entradas para crear una habilidad.
  • Las habilidades funcionan mejor con Canvas cuando una habilidad tiene solo un archivo SKILL.md.
  • Un archivo SKILL.md tiene límites de longitud estrictos de 64 caracteres para name, 1,024 caracteres para description y 500,000 caracteres para el cuerpo de las instrucciones de Markdown. Los archivos ZIP subidos no pueden superar los 100 MB (comprimidos o sin comprimir), los 100 archivos o los 10 niveles de anidamiento de directorios.

¿Qué sigue?