Construye tu agente
Habilidades
Agrega capacidades avanzadas basadas en código a tu agente con habilidades de la comunidad y personalizadas
Una habilidad es como un especialista al que tu agente puede llamar cuando una tarea requiere un talento particular — alguien que hace cálculos, traduce o pone orden. Las herramientas permiten a tu agente comunicarse con otros servicios, y los proyectos le dan material de referencia para leer, pero las habilidades le dan la capacidad de ejecutar una pieza de lógica personalizada — transformar datos, recorrer un proceso de varios pasos o hacer un cálculo especializado — y usar el resultado en su respuesta.
Por qué importa
Algunas solicitudes necesitan más que una búsqueda o una respuesta sacada de un documento. Necesitan que se haga algo de trabajo: dar formato a una lista desordenada, convertir un archivo de un formato a otro, ejecutar un cálculo que sigue reglas específicas cada vez.
Las habilidades permiten a tu agente manejar exactamente esas tareas sin que tengas que conectar un servicio externo. Agregas la habilidad una vez y, a partir de ahí, el agente recurre a ella cada vez que una solicitud lo amerite — por ejemplo, convertir un bloque de texto en un resumen claro, o reorganizar una hoja de cálculo de datos en otro formato.
Cómo funciona
Una habilidad es un paquete de lógica autocontenido que tu agente puede ejecutar cuando necesita esa capacidad específica. Cuando la solicitud de un usuario coincide con lo que hace una habilidad, el agente la ejecuta e incorpora el resultado en su respuesta.
Las habilidades vienen en tres tipos, según de dónde provengan:
| Tipo | De dónde viene | ¿Puedes eliminarla? |
|---|---|---|
| Nativa | Integrada en cada agente. Maneja tareas comunes sin configuración. | No — las habilidades nativas siempre están disponibles |
| Comunidad | Compartida por la comunidad de Nirvai para que cualquiera la instale. | Sí |
| Personalizada | Creada por ti para las necesidades específicas de tu agente. | Sí |
Instalar una habilidad de la comunidad
- En el constructor, elige Habilidades en el menú de la izquierda
- Cambia a la pestaña Comunidad para explorar lo que hay disponible
- Usa la barra de búsqueda o filtra por categoría para encontrar lo que necesitas
- Haz clic en Instalar en cualquier habilidad para agregarla a tu agente
Habilidades
Rutinas guardadas que este agente puede ejecutar cuando lo necesites, como crear un informe o un diseño.
- · Las habilidades permiten a tu agente realizar tareas específicas como generar reportes o analizar datos. Créalas en el Modo Desarrollador.
- · Los cambios aquí se aplican de inmediato: no hay nada que guardar.
Reutilizar una habilidad de otro agente
Si ya construiste o instalaste una habilidad en uno de tus agentes, no tienes que rehacerla desde cero en el siguiente — puedes copiarla. Es como fotocopiar el manual de un compañero ya entrenado para otro compañero: el nuevo agente recibe su propia copia, así que editar o eliminar la habilidad en un agente nunca afecta al otro.
En la pestaña Mis Habilidades, debajo de las habilidades propias de este agente, una lista de "Disponibles de tus otros agentes" muestra las habilidades que viven en tus otros agentes y que puedes copiar aquí.
Cada una muestra de qué agente viene; haz clic en Agregar para copiarla aquí.
Algunas cosas a tener en cuenta:
- Solo muestra tus propios agentes. Esto sirve para reutilizar habilidades entre los agentes que posees — no se comparte nada con otras personas.
- Las herramientas de la habilidad vienen incluidas. Una habilidad suele depender de herramientas (por ejemplo, una herramienta que envía correos). Al copiar la habilidad, las herramientas que necesita se agregan a este agente automáticamente.
- Cada copia es independiente. La habilidad copiada es un elemento aparte con sus propios archivos. Cambiarla después en un agente no la cambiará en el otro.
Agregar una habilidad de otro agente
- Abre tu agente y ve a la sección Habilidades.
- En la pestaña Mis Habilidades, baja hasta "Disponibles de tus otros agentes".
- Cada habilidad muestra el agente del que proviene y las herramientas que incluye, directamente en la tarjeta.
- Haz clic en Agregar, opcionalmente dale un nombre nuevo a la copia, y confirma.
La habilidad — y cualquier herramienta nueva que necesite — se copia en este agente y aparece en tu lista de habilidades de inmediato.
Las copias son independientes. Si quieres el mismo cambio en ambos agentes, tienes que hacerlo en cada uno por separado — edita la habilidad en el chat de cada agente (ver mejorar tu agente conversando).
Para ver y gestionar todas las habilidades de todos tus agentes en un solo lugar — y copiar cualquiera a otro agente — abre tu Biblioteca de habilidades.
Gestionar tus habilidades instaladas
La pestaña Mis Habilidades lista todas las habilidades instaladas en el agente seleccionado. Cada una aparece como una tarjeta que puedes expandir al hacer clic:
- La vista colapsada muestra el nombre de la habilidad, una descripción corta, su estado (activa o inactiva) y una insignia de origen (nativa, comunidad o personalizada).
- La vista expandida muestra la descripción completa, las entradas que acepta la habilidad, su origen y versión, un interruptor de habilitar/deshabilitar y un botón de eliminar para habilidades de la comunidad y personalizadas.
Cambia el interruptor de habilitar/deshabilitar para activar o desactivar una habilidad sin eliminarla — una habilidad deshabilitada permanece en tu lista, lista para reactivarla. Para desinstalar una habilidad de la comunidad o personalizada, haz clic en Eliminar en su vista expandida. Las habilidades nativas no se pueden eliminar.
Ejemplos
Habilidades de la comunidad que podrías instalar
| Habilidad de ejemplo | Qué hace |
|---|---|
| Formateador de datos | Convierte datos entre formatos (CSV, JSON, tablas) |
| Calculadora | Realiza cálculos matemáticos complejos |
| Resumidor | Condensa texto largo en un resumen estructurado |
| Traductor | Traduce texto entre idiomas |
| Ejecutor de código | Ejecuta fragmentos de código y devuelve el resultado |
Un resumidor en acción
Un cliente pega tres párrafos de comentarios en el chat. Tu agente reconoce que un resumen ayudaría, ejecuta la habilidad Resumidor y responde con un resumen limpio de tres viñetas en lugar del muro de texto.
Errores comunes
| Error | Por qué es un problema | Mejor enfoque |
|---|---|---|
| Recurrir a una habilidad para comunicarse con un servicio externo | Las habilidades ejecutan lógica del lado de Nirvai — no inician sesión en tu calendario ni en tu CRM | Usa una herramienta para interactuar con un servicio externo, y una habilidad para la lógica de procesamiento |
| Dejar instaladas todas las habilidades de la comunidad "por si acaso" | Las habilidades de más generan desorden y pueden confundir cuál elige el agente | Instala solo las habilidades que coincidan con lo que tu agente realmente hace, y deshabilita el resto |
| Esperar habilidades personalizadas sin configuración | Las habilidades personalizadas se escriben como paquetes de código | Pídele al agente que la cree en el chat con Aprende de tus correcciones activado, o quédate con las nativas y de la comunidad |
| Esperar que una habilidad copiada se actualice cuando cambias la original | Las copias de otro agente son independientes — cada agente conserva su propia versión | Edita la habilidad en el chat de cada agente, o mantén la lógica compartida en un solo agente |
Habilidades frente a herramientas de un vistazo
| Habilidades | Herramientas | |
|---|---|---|
| Qué son | Código que ejecuta lógica | Conexiones a servicios externos |
| Dónde se ejecutan | En los servidores de Nirvai | En el servicio externo |
| Qué necesitan | Un paquete de código | Datos de inicio de sesión del servicio |
| Ideal para | Lógica personalizada, procesamiento de datos, cálculos | Trabajar con servicios externos (calendarios, CRMs, bases de datos) |
| Creadas por | La comunidad o tú | Tú, o configuradas a través de un conector |
Crear habilidades personalizadas
Activa Aprende de tus correcciones y describe la rutina en el chat del agente — por ejemplo, "convierte el reporte de ventas del lunes en una habilidad". El agente responde con una habilidad sugerida que puedes aplicar u omitir. Una habilidad personalizada define su nombre y descripción (cómo el agente sabe cuándo usarla), las entradas que espera, la lógica que se ejecuta cuando se llama, y cualquier herramienta que use en el proceso.
Qué sigue
- Capacidades nativas — habilidades integradas que activas.