El menú Skills permite crear y versionar instrucciones reutilizables para los agentes de Power OMNI. Las Skills se almacenan en el proyecto y se vinculan a un Toolbox, que a su vez se conecta al agente.
Una Skill le enseña al agente cómo realizar una tarea. Puede definir un proceso, reglas internas, criterios de decisión, formato de respuesta y límites que deben respetarse.
Importante:
Las Skills y las herramientas tienen propósitos diferentes. Una herramienta permite que el agente obtenga datos o ejecute una acción. Una Skill orienta cómo debe trabajar el agente en una situación específica.
Cómo funciona
El uso de una Skill en Power OMNI sigue este flujo:
-
Crear la Skill
-
Agregarla a un Toolbox
-
Conectar el Toolbox al agente
-
Usar la Skill durante una conversación
Este modelo permite reutilizar la misma orientación en varios agentes sin copiar el contenido en las instrucciones de cada agente.
Acceder al menú Skills
-
Inicie sesión en el Portal de Administración de Power OMNI.
-
Abra Artefactos
-
Seleccione Skills
Crear una Skill
-
Abrir Skills
Vaya a Artefactos > Skills.
-
Hacer clic en Crear
Haga clic en Crear en la esquina superior derecha.
-
Completar el panel lateral
Campo Descripción Proyecto Seleccione el proyecto de Microsoft Foundry donde se almacenará la Skill. Nombre Ingrese un identificador único para la Skill. El nombre no puede modificarse después de crear la Skill. Descripción Explique cuándo el agente debe utilizar la Skill. Esta información ayuda al agente a decidir si debe cargar las instrucciones. Instrucciones Use Markdown para describir el proceso y las reglas que el agente debe seguir al utilizar la Skill. -
Guardar la Skill
Después de completar los campos, haga clic en Guardar. Power OMNI creará la Skill en el proyecto seleccionado y registrará su primera versión.
Cómo definir el nombre
Use un nombre corto, estable y fácil de reconocer. Prefiera letras minúsculas, números y guiones, sin espacios ni caracteres acentuados.
Ejemplos:
billing-analysisproduct-supporthr-policy-search
Como el nombre queda bloqueado después de la creación, evite referencias temporales, fechas o nombres de personas.
Cómo redactar la descripción
La descripción debe indicar claramente cuándo debe utilizarse la Skill. Evite textos como "Skill de atención al cliente" o "Ayuda al agente", ya que estas descripciones no explican qué debe activar su uso.
Ejemplo poco claro:
Información de la empresa.Ejemplo recomendado:
Use esta Skill cuando el usuario pregunte sobre la empresa,sus productos, servicios, historia, posicionamiento o equipo.Cómo redactar las instrucciones
Las instrucciones definen cómo el agente debe responder o realizar la tarea. Organice el contenido en Markdown e incluya solo reglas relacionadas con el propósito de la Skill.
Una estructura simple suele funcionar bien:
# Skill Institucional## Cuándo usarUse esta Skill cuando el usuario pregunte sobre la empresa, sus productos,servicios, historia, posicionamiento o equipo.## Reglas- Responda solo con información institucional confirmada.- Si la información no está disponible, indique que no pudo ser confirmada.- No invente fechas, clientes, cifras ni funcionalidades.## Formato de respuesta- Use español claro y directo.- Comience con la respuesta principal.- Use una lista solo cuando mejore la legibilidad.Editar y versionar una Skill
-
Buscar la Skill en la lista
-
Abrir el editor
En la columna Acciones, haga clic en el ícono de edición.
-
Actualizar el contenido
Actualice la descripción o las instrucciones.
-
Guardar los cambios
El nombre de la Skill no puede modificarse después de su creación. Esta regla preserva el vínculo con Microsoft Foundry e impide que se rompan las referencias existentes.
Cada cambio guardado crea una nueva versión inmutable en Microsoft Foundry. La sección Versión predeterminada muestra la versión activa y la fecha en que fue creada.
Cuando una Skill está vinculada a un Toolbox sin seleccionar una versión específica, el Toolbox sigue la versión predeterminada. Esto permite que una actualización quede disponible para los agentes conectados sin recrear la Skill.
Pruebe los cambios antes de aplicarlos a agentes utilizados en producción. Una nueva instrucción puede modificar el formato, el tono o la lógica de las respuestas.
Agregar la Skill a un Toolbox
Una Skill no se conecta directamente a un agente. Primero debe agregarse a un Toolbox.
-
Abrir Toolboxes
Vaya a Artefactos > Toolboxes.
-
Crear o editar un Toolbox
-
Buscar Skills
En el formulario del Toolbox, busque la sección Skills.
-
Agregar la Skill
Seleccione la Skill que desea agregar.
-
Guardar los cambios
Un Toolbox puede contener herramientas, conectores y Skills. Esto brinda al agente acceso a las capacidades necesarias y a la orientación de uso mediante una única conexión.
Conectar el Toolbox al agente
Después de agregar la Skill al Toolbox:
-
Vaya a Artefactos > Agentes.
-
Cree o edite un agente
-
Abra las relaciones del agente.
-
Busque Toolboxes
-
Seleccione el Toolbox que contiene la Skill.
-
Guarde los cambios
El agente puede utilizar la Skill en las conversaciones donde su descripción coincida con la solicitud del usuario.
Probar la Skill
Después de completar las conexiones, abra el chat y seleccione el agente configurado. Haga una pregunta que coincida con la descripción de la Skill.
Ejemplo:
¿Qué servicios ofrece Power Tuning y cómo se posiciona la empresa en el mercado?
Verifique si la respuesta:
- sigue las reglas definidas en las instrucciones;
- utiliza el formato solicitado;
- evita información fuera del alcance definido;
- utiliza las herramientas correctas cuando la Skill requiere una consulta o acción.
Si es necesario, actualice la descripción o las instrucciones, guarde una nueva versión y pruebe nuevamente.
¿Cuál es la diferencia entre una Skill, un Toolbox y una herramienta?
| Recurso | Propósito | Ejemplo |
| Skill | Le enseña al agente cómo realizar una tarea. | Define el flujo de trabajo de un análisis de facturación. |
| Toolbox | Agrupa las Skills y herramientas que se pondrán a disposición del agente. | Combina una Skill de análisis, el conector de Fabric y la Búsqueda en la Web. |
| Herramienta o conector | Obtiene datos o ejecuta una acción. | Busca documentos, consulta Fabric o llama a una API. |
| Instrucciones del agente | Definen el comportamiento general del agente. | Establecen el rol, el tono y las reglas permanentes del asistente. |
Use las instrucciones del agente para reglas que se aplican a todas las conversaciones. Use Skills para procesos especializados que pueden reutilizarse en varios agentes.
Eliminar una Skill
Para eliminar una Skill, búsquela en la lista y haga clic en el ícono de papelera en la columna Acciones.
Antes de eliminarla, quite la Skill de los Toolboxes que aún la utilicen. Eliminar una Skill puede afectar a todos los agentes conectados a esos Toolboxes.
Si solo necesita cambiar las instrucciones, edite la Skill y cree una nueva versión. No es necesario eliminarla.
Solución de problemas
El agente no utiliza la Skill
Verifique lo siguiente:
- que la Skill fue agregada al Toolbox;
- que el Toolbox fue conectado al agente;
- que los cambios fueron guardados;
- que la descripción explica claramente cuándo debe utilizarse la Skill;
- que la pregunta de prueba coincide con el alcance definido.
El agente carga la Skill en el momento equivocado
Haga la descripción más específica. Indique el tema, el tipo de solicitud y, cuando sea necesario, las situaciones en las que la Skill no debe utilizarse.
Las respuestas no siguen el proceso esperado
Reescriba las instrucciones usando pasos numerados, reglas claras y un formato de salida definido. Elimine orientaciones conflictivas o instrucciones que ya estén incluidas en las instrucciones generales del agente.
No se puede editar el nombre
Este comportamiento es esperado. El nombre se utiliza como identificador de la Skill en Microsoft Foundry y queda bloqueado después de la creación.