Compartir habilidades con tu equipo

Publicar, instalar, revisar y compartir habilidades y rutinas en Cartographer, incluidos los permisos y cómo funcionan las fuentes.

Una habilidad que creas solo vivirá en tu máquina hasta que la publiques. Dado que una rutina es una habilidad marcada como invocable por el usuario, todo en esta página se aplica también a las rutinas.

Dónde se publican las habilidades: fuentes

Al publicar una habilidad, se carga en una fuente, un lugar desde el que se puede leer y escribir un paquete de habilidades. Cambias entre fuentes con el selector de origen en Descubrir habilidades:

Transmisión	Cobertura	Quién lo configura
La fuente de bibliotecas de tu tenant de Orchestrator	Todos en ese tenant	Tu propio administrador de Orchestrator: este es el destino predeterminado que tiene cada tenant
Una fuente compartida	Varias organizaciones a la vez	Configurado por UiPath por separado, fuera de Orchestrator por completo, y solo si tu organización tiene uno — consulta Compartir habilidades fuera de tu organización
Un repositorio que añades	Dondequiera que lo apuntes, como un repositorio de habilidades alojado en GitHub	Tú, desde Complementos e integraciones → Complementos — consulta Orígenes del repositorio

Nota:

Cada habilidad publicada desde Cartographer está en Orchestrator en Tenant → Paquetes → Bibliotecas → Tenant.

Consulta Referencia de habilidades para las vistas de Habilidades, Descubrir habilidades y Revisar cola que rellenan estas fuentes.

Crear una habilidad

Ya sea que la describas al agente o la escribas a mano, una habilidad necesita:

• Un desencadenador claro: ¿cuándo debe alcanzar el agente esta habilidad?
• Instrucciones claras: ¿qué debe hacer, paso a paso?

Estos se convierten en los campos Información general y Cuándo usar de la habilidad cuando la publicas.

También puedes convertir algo que hiciste en un chat en una habilidad reutilizable solicitándolo directamente, utilizando la solicitud sugerida Convertir mi tarea actual en una habilidad de automatización reutilizable o seleccionando Crear grabación para capturar los pasos realizándolos tú mismo.

De cualquier manera, el resultado es una carpeta de habilidades en tu máquina: nadie más puede verla hasta que la publiques. Encuéntralo en Complementos e integraciones → Habilidades → Descubrir habilidades, que aparece en Instalado como No publicado.

Añadir una habilidad

En Complementos e integraciones → Habilidades, selecciona Añadir habilidad y elige una de las tres opciones:

Opción	Lo que hace
Crear una nueva habilidad con Cartographer	Describa lo que quiere y deje que el agente cree la habilidad
Importar habilidad desde zip	Añadir un paquete de habilidades desde un archivo .zip
Abrir carpeta de habilidades	Abra su carpeta de habilidades locales directamente para añadir o editar archivos usted mismo

Nota:

Una carpeta de habilidades que creas a mano solo se selecciona cuando se inicia Cartographer: la opción Sincronizar habilidades no la encontrará. Reinicia Cartographer después de añadir uno de esta manera.

Antes de publicar

Deben cumplirse tres cosas o la publicación no funcionará:

1. Está conectado a Orchestrator. Si no tienes conexión, no hay nada que buscar ni ningún lugar donde publicar.
2. Su tenant acepta cargas de bibliotecas. Un administrador de Orchestrator establece esto en Tenant → Configuración → Implementación, en la tarjeta Bibliotecas : establece Fuentes en Fuentes del host y del tenant (o Solo fuente del tenant) y guarda. Si se establece en Solo fuente de host, la publicación se deshabilita en todo el tenant y la sección Descubrir habilidades pasa a ser solo de navegación e instalación.
3. Tienes el permiso Libraries.Create en Orchestrator. Sin él, el botón Publicar no se representa en absoluto: solo verás Enviar para revisión. Libraries.View es suficiente para navegar e instalar.

Roles y permisos

Aquí se aplican dos capas de permisos independientes, y controlan cosas diferentes:

Capa	Controles	Dónde
Orchestrator (Libraries.View/Libraries.Create)	Si puedes ver y utilizar la fuente: navegar e instalar con Ver, publicar con Crear	Roles de Orchestrator, establecidos por su administrador
Permisos de herramientas	Qué puede hacer una habilidad instalada en tu máquina una vez que se ejecuta: Permitir, Preguntar o Bloquear por herramienta	Configuración → Seguridad, o de forma centralizada a través de Gobernanza con Automation Ops

Mantener Libraries.Create solo significa que Orchestrator te permite publicar; no dice nada sobre lo que la habilidad en sí puede hacer en runtime. Eso está controlado completamente por los permisos de la herramienta y tu modo de aprobación, al igual que cualquier otra acción que realice Cartographer.

Antes de instalar una habilidad que no creaste tú mismo, consulta su pestaña Archivos para ver qué herramientas, conexiones y sistema de archivos o acceso a la red utiliza, y si coincide con el propósito declarado. Tenga cuidado con una habilidad que solicite herramientas no relacionadas con su propósito, acceso amplio al sistema de archivos sin justificación o una conexión a un servicio confidencial (banca, sistemas de recursos humanos) que no tiene ninguna razón obvia para necesitar.

En términos de roles, Automation User es suficiente para navegar, instalar y ejecutar habilidades. La publicación necesita un rol que lleve Libraries.Create, normalmente Automation Publisher o un rol de tenant personalizado.

Publicar una habilidad

Para publicar una habilidad que creaste, sigue los siguientes pasos:

1. En Complementos e integraciones → Habilidades → Descubrir habilidades, busca tu habilidad en Instalada. Aparece No publicado hasta que lo compartas.
2. Abre la tarjeta y consulta la pestaña Información general : esta descripción es por lo que las personas juzgarán la habilidad antes de publicarla.
3. Selecciona el icono de carga en la tarjeta o Publicar cambios locales en la página de detalles.
4. Rellena los campos obligatorios: Versión (debe ser superior a cualquier versión ya publicada para esta habilidad), Rol, Tipo y Visión general. Cambiar notas es opcional en una primera publicación. Generar con IA puede redactar los campos descriptivos del paquete por ti.
5. Selecciona Publicar para que se active de inmediato o Enviar para revisión para enviarlo primero a un revisor, lo que te ofrezca el pie de página.

Tus opciones de Rol y Tipo se convierten en propiedades del paquete resultante, tus etiquetas se convierten en etiquetas y tu Descripción general se convierte en su descripción.

Para confirmar su publicación, consulta la página de detalles: ahora aparece un nombre de tenant junto a la versión y la acción cambia de Publicar cambios locales a Volver a publicar. Para obtener una respuesta definitiva, consulta Tenant → Paquetes → Bibliotecas → Tenant en Orchestrator: esta es la lista de paquetes real.

Una vez publicada tu habilidad, tu equipo puede encontrarla en Disponible en Descubrir habilidades y seleccionar Instalar para descargarla en su propia carpeta de habilidades. Está listo para que el agente lo utilice a partir de su próxima conversación. Consulta Instalar una habilidad.

Actualizar una habilidad publicada

Edita la habilidad: en un chat o cambiando sus archivos directamente. No hay edición in situ de una versión publicada; cada cambio se envía como una nueva versión. Una vez que hayas realizado un cambio:

1. El catálogo marca la habilidad como Modificado y la pestaña Cambios vuelve a aparecer en la página de detalles que muestra lo que ha cambiado.
2. Selecciona Publicar actualización. El número de versión se rellena previamente un paso más alto que lo que se publica, y esta vez se requieren Notas de cambio : describe qué ha cambiado.
3. Selecciona Publicar actualización de nuevo para enviarla.

Las versiones solo avanzan: se rechaza la reutilización de un número de versión.

Directrices de calidad de las habilidades

Una habilidad que estás publicando para otros es más útil, y es más probable que sea de confianza, cuando cumple con estos criterios:

Criterio	Descripción
Borrar propósito	Hace una cosa bien, descrita en una frase
Bien documentado	La descripción general explica qué hace, cuándo utilizarla y qué necesita
Probado	Funciona de forma fiable en diferentes máquinas y configuraciones
Seguro	No solicita permisos innecesarios, maneja las credenciales de forma segura
Mantenible	Las instrucciones son legibles, las dependencias son mínimas
Versionado	Utiliza versiones semánticas (1.0.0, 1.1.0, etc.)

Instalar una habilidad

Para instalar una habilidad que otra persona ha publicado, sigue los siguientes pasos:

1. En Descubrir habilidades, encuéntralo en Disponible. Limita la lista con filtros de búsqueda, rol y tipo.
2. Abre la tarjeta y comprueba Información general y Archivos antes de instalar cualquier cosa que no hayas creado tú mismo.
3. Selecciona Instalar.

Resultado: la tarjeta de habilidad se mueve a la sección Instalado de Descubrir habilidades.

Instalar, habilitar o deshabilitar una habilidad solo tiene efecto en las nuevas conversaciones. Cuando se publica una versión más reciente, la tarjeta muestra Actualización disponible. Si has editado tu propia copia, la actualización te advierte primero y te ofrece mantener tus cambios o sobrescribirlos.

Para eliminar tu propia copia sin afectar al paquete publicado, utiliza Desinstalar de este dispositivo. Para eliminar el paquete por completo, para todos, utiliza Eliminar de Orchestrator en el mismo menú; consulta Publicar una habilidad.

Obtener revisión y aprobación

Si no tienes el permiso Libraries.Create , el formulario de publicación solo ofrece Enviar para revisión. Rellena los mismos campos que una publicación y envío normales: nada se activa todavía.

Realiza un seguimiento de tu envío desde Complementos e integraciones → Habilidades → Cola de revisión, en Mis envíos. Se mueve a través de algunos estados:

Estado	Significado	Qué puedes hacer
Pendiente	Esperando un revisor	Retírelo o elimínelo para liberar el paquete preparado
Publicando…	Aprobado; carga en curso	Esperar
Publicado	Activo: sale de esta lista	Confírmelo en Descubrir habilidades u Orchestrator
Rechazado	Rechazado, con un motivo adjunto	Lea el motivo, corríjalo y envíelo de nuevo
Error en la publicación	Aprobado, pero la carga en sí falló	Nada que hacer: el revisor vuelve a intentarlo

Importante:

Un envío con el estado Pendiente no tiene propietario: asignación, recordatorio, escalada ni SLA. Se queda ahí hasta que alguien comprueba la cola. Antes de confiar en la revisión para un equipo, asegúrese de que al menos una persona tenga Libraries.Create y sepa que la cola existe.

Si tienes el permiso de publicación, un segundo carril en la cola de revisión muestra los envíos que te esperan. Al abrir uno se muestra la versión, el remitente, la descripción y dónde aterrizará.

• Ejecutar revisión te ofrece una lectura automatizada del paquete (una recomendación, su razonamiento y cualquier marca de riesgo) antes de decidir; es solo de asesoramiento y nunca carga ni elimina nada por sí mismo.
• Aprobar publica el paquete en tu propia cuenta;
• El rechazo requiere un motivo, que se remonta al remitente.

Publicar e instalar habilidades desde un chat

Todo lo anterior también está disponible preguntando, en tus propias palabras:

Decir	Qué sucede
"enumerar habilidades" o "¿qué hay disponible?"	Consulta la fuente de tu tenant e imprime cada habilidad publicada con versiones y fechas
"publicar mi habilidad X"	Lo empaqueta y lo carga, determinando por sí solo si se trata de una primera publicación o de una nueva versión
"instalar X" o "descargar X"	Obtiene el paquete y lo instala
"buscar actualizaciones"	Compara la fuente con lo que has instalado

Utilice la ruta de chat cuando ya esté en una, quiera hacerlo en una frase o esté evaluando muchas habilidades a la vez. Utiliza la interfaz de usuario de Descubrir habilidades cuando quieras revisar o editar cada campo antes de que se apague, necesites Enviar para revisión (la ruta de chat publica directamente) o quieras Generar con IA para redactar una descripción.

Compartir habilidades fuera de su organización

Una fuente compartida es lo que permite que una habilidad llegue a otras organizaciones, no solo a tu propio tenant. UiPath configura las fuentes compartidas en el momento de la implementación, no el autoservicio: si tu organización no tiene una, no verás nada de esto, y publicar e instalar dentro de tu propio tenant funciona exactamente como se describe anteriormente.

Publicar en una fuente compartida

Si tu organización tiene configurada una fuente compartida, el formulario de publicación muestra una sección Compartir en fuente con una casilla de verificación por fuente junto con tu propio tenant. Marca las casillas antes de publicar: cualquiera que esté seleccionada, tu habilidad también va allí.

La publicación en varios destinos a la vez puede tener éxito en parte. Cartographer informa exactamente de cuáles han fallado, por ejemplo, "Publicado en la organización. No se pudo publicar<feed> en:." Los destinos que se publicaron correctamente permanecen publicados.

Recibir una habilidad de una fuente compartida

Alguien de otra organización que reciba tu habilidad a través de una fuente compartida puede:

• Prueba en el chat (lo ejecuta en un sandbox, no instala nada)
• Añadir a la biblioteca para copiarla en su propio tenant (si pueden publicar)
• Solicitud para añadir a Orchestrator, que pide a su administrador que la revise y la añada

Ninguna de estas opciones instala la habilidad directamente desde la fuente de otra organización. La organización receptora siempre decide: un administrador aporta una copia bajo su propio control o alguien lo prueba primero sin instalar nada.

Eliminar una habilidad

El menú del icono de la papelera en la página de detalles de la habilidad tiene dos acciones con dos resultados diferentes:

Acción	Elimina	No toca
Desinstalar de este dispositivo	Tu copia local	El paquete publicado y las copias de todos los demás
Eliminar de Orchestrator	El paquete publicado, para todo el tenant	Copias que ya han instalado

La desinstalación pide confirmación primero: "¿Está seguro de que desea desinstalar '<skill>'? Esto lo eliminará de tu máquina local."

Mejores prácticas

Para usuarios

• Revise los permisos antes de instalar: no los acepte a ciegas
• Probar primero una nueva habilidad en una tarea no crítica
• Mantén las habilidades actualizadas para las últimas correcciones y compatibilidad
• Desinstalar habilidades que no estés utilizando

Para editores

• Solicite solo los permisos que necesita: no solicite la automatización de IU si su habilidad solo lee archivos
• Gestiona los errores con gracia: explica a los usuarios qué salió mal y cómo solucionarlo
• Respetar los datos del usuario: no filtrar datos y respetar la configuración de privacidad

Próximos pasos

• Referencia de habilidades : qué es una habilidad y las vistas Habilidades/Descubrir habilidades/Cola de revisión
• Repetir trabajo con rutinas : cómo se relaciona una rutina con una habilidad
• Ampliar la funcionalidad con complementos : agrupar habilidades, servidores MCP y credenciales
• Solución de problemas : correcciones para problemas de publicación, instalación y revisión