Habilidades
Una habilidad es una instrucción que guardas una vez y reutilizas: cómo escribe tu equipo un resumen semanal, los pasos para revisar el portal de un proveedor, el formato que debe seguir un informe. En lugar de pegar el mismo párrafo en cada tarea, lo guardas como habilidad y lo agregas con una sola tecla.
Una habilidad llega a un agente de dos maneras:
- Tú la agregas a un mensaje. Escribe
/en el cuadro de mensajes y elígela. El agente recibe tu mensaje más el texto de la habilidad. - El agente la abre por su cuenta. Un agente ve el nombre y la descripción de las habilidades que puede usar, y carga el texto completo cuando sus instrucciones o la tarea lo piden. La transcripción muestra Cargando la habilidad … y luego Habilidad … cargada.
Abre Habilidades desde la barra lateral para verlas y escribirlas.
Agregar una habilidad a un mensaje
Sección titulada «Agregar una habilidad a un mensaje»En cualquier cuadro de mensajes —la página Nueva tarea o una tarea que ya
está en marcha— escribe / para abrir Agentes y habilidades, y elige una.
Queda sobre el mensaje como una etiqueta hasta que lo envías; después, la
transcripción registra Se agregó la habilidad … a esta tarea.
Una habilidad puede contener espacios en blanco: pon una palabra de sus
instrucciones entre llaves, como {customer}, y se convierte en un espacio en
blanco. La página Habilidades muestra los espacios en blanco de cada
habilidad, para que veas qué espera una habilidad antes de usarla.
La página Habilidades
Sección titulada «La página Habilidades»Las habilidades se muestran en dos grupos:
| Grupo | Qué contiene | Qué puedes hacer |
|---|---|---|
| Mías | Las habilidades que escribiste | Editarlas, compartirlas o eliminarlas |
| Compartidas por tu equipo | Habilidades que otras personas del espacio de trabajo compartieron | Copiar a las mías: haz tu propia copia editable |
Cada fila muestra el Nombre de la habilidad, sus Espacios en blanco, su Alcance y si está Compartida o es Privada. Eliminar una habilidad la quita para todos; las tareas que ya la usaron conservan el texto que recibieron.
Si estás en más de un espacio de trabajo, cada fila también indica su Espacio de trabajo, y un filtro Espacio de trabajo acota la lista a uno.
Las herramientas de un flujo de navegador
también son habilidades, pero pertenecen a su conector: no aparecen en esta
lista ni en el menú /.
Escribir una habilidad
Sección titulada «Escribir una habilidad»Nueva habilidad abre una página propia, con un solo Guardar en su encabezado:
| Sección | Qué contiene |
|---|---|
| Detalles | El Nombre (hasta 120 caracteres); la Descripción (hasta 500 — se muestra junto al nombre cuando alguien escribe /, y es lo que lee un agente para decidir si la abre); el Alcance, Toda la organización o un agente concreto; y, solo si estás en más de un espacio de trabajo, el Espacio de trabajo al que pertenece — el principal, salvo que elijas otro |
| Instrucciones | El texto en sí, hasta 10,000 caracteres. {word} se convierte en un espacio en blanco |
| Scripts | Código que los pasos ejecutan en la computadora del agente, siempre igual. Agregar script le da una ruta como scripts/check.py y su contenido; los scripts se guardan en carpetas y cada uno se puede editar, renombrar o eliminar. Cuando un agente carga la habilidad, sus scripts se colocan en la computadora. Un archivo dentro de calls/, como calls/close_ticket.json, es una llamada al sitio: una solicitud que el agente envía desde su navegador con la sesión iniciada en lugar de hacer clic en la página |
| Historial | Aparece tras el primer guardado. Cada vez que guardas se crea una versión: Ver qué cambió compara dos, y Restaurar devuelve una anterior como una versión nueva (el nombre no cambia). Bloquear esta versión la conserva: una versión bloqueada muestra Bloqueada y no se puede eliminar hasta que se desbloquea. Eliminar quita de forma permanente una versión desbloqueada anterior a la actual; confirmas escribiendo su nombre, como Versión 3 |
Quien puede usar una habilidad pero no cambiarla la ve en solo lectura — Puedes usar esta habilidad, pero no cambiarla. Cópiala para tener la tuya. — y tiene Copiar a las mías, que abre una habilidad nueva ya rellenada; no se guarda nada hasta Guardar. Salir de una página con cambios sin guardar pregunta antes.
Alcance
Sección titulada «Alcance»- Limitada a un agente, una habilidad pertenece a ese agente: se ofrece en las tareas de ese agente. Solo puedes limitar una habilidad a un agente que puedas ver.
- De toda la organización, una habilidad se ofrece en las tareas sin agente y a cualquier agente al que se le conceda en el constructor de agentes.
Compartir
Sección titulada «Compartir»Una habilidad es tuya hasta que la compartes. Elige Quién puede usarla en el menú de su fila, o el chip de su editor, para abrir el cuadro para compartir: añade personas con Puede usar (la ven y pueden concederla a un agente que editan) o Puede editar, o activa Todos en ‹espacio de trabajo› (un propietario o administrador). Solo quien la creó la elimina. Consulta Compartir.
Una habilidad se puede conceder a un agente en el constructor cuando es de toda la organización y puedes usarla.
Habilidades que aprende un agente
Sección titulada «Habilidades que aprende un agente»También puedes hacer que se escriba una habilidad enseñándole el trabajo al agente. En una sesión de entrenamiento el agente redacta habilidades a partir de lo que le cuentas, adjuntas y muestras —nuevas, o mejoras de habilidades que ya tiene, con sus scripts y sus llamadas al sitio— y anota cada una en Aprendido hasta ahora. Puede probar una habilidad en su computadora antes de que la guardes. Cuando pulsas Guardar · N, la tarjeta muestra cada habilidad completa, con una casilla, y puedes editar una habilidad en la tarjeta antes de aprobarla. Aprobar guarda en el agente, como suyas, las habilidades marcadas, junto con los demás cambios marcados, como una versión nueva del agente.
Una habilidad guardada así pertenece a ese agente: cualquier tarea del agente puede cargarla, también las que inicia una automatización. Se queda con ese agente hasta que se comparte; consulta Compartir. El constructor de agentes muestra estas habilidades en Habilidades de este agente. Como es una habilidad corriente, puedes leerla, editarla y ver sus versiones como cualquier otra, con algunas diferencias:
- La edita quien puede editar el agente, no quien la escribió. Los demás la ven en solo lectura.
- Su nombre no se puede cambiar y no tiene Alcance: pertenece al agente.
- Al guardarla se escribe una versión nueva de la habilidad y una versión nueva del agente, así que las Versiones del agente también la registran.
- Su Historial no tiene Eliminar. Puedes ver qué cambió, restaurar y bloquear sus versiones, pero no eliminar ninguna: las versiones del propio agente registran qué versión de cada habilidad usaron, así que ninguna se quita nunca.
- Desactivar hace que ninguna tarea la cargue hasta que se vuelva a activar, y Eliminar la quita del agente; una tarea que ya está en marcha conserva lo que cargó.
Se ve igual dondequiera que la abras: en su página dentro de Habilidades o desde el constructor de agentes.
Abrir una habilidad desde el constructor de agentes
Sección titulada «Abrir una habilidad desde el constructor de agentes»En el constructor de un agente, Leer en una habilidad —en Habilidades o en Habilidades de este agente, dentro de Configurar— la abre en un panel lateral junto al constructor. El panel muestra exactamente lo mismo que la página de la habilidad: Detalles, Instrucciones, Scripts (también sus llamadas al sitio) e Historial, con las acciones de la página —Guardar, Desactivar, Compartir, Eliminar, las que puedas usar— al pie. En un teléfono el panel ocupa la pantalla y se ve como la página de la habilidad en un teléfono.
Solo hay una habilidad abierta a la vez. Cerrar el panel, o abrir otra habilidad, con cambios sin guardar pregunta antes.
Lo que puedes cambiar depende de la habilidad, y el panel sigue las mismas reglas que la página de la habilidad:
| Habilidad | Quién puede editarla ahí | Los demás |
|---|---|---|
| Una de las habilidades propias de este agente | Cualquiera que pueda editar el agente | La ven en solo lectura |
| Una habilidad del espacio de trabajo concedida al agente | Quien pueda editar esa habilidad: la persona que la escribió y quienes tienen Puede editar | La ven en solo lectura, con la nota Una habilidad del espacio de trabajo que se dio a este agente. Se cambia donde se guarda, en la página Habilidades. y Abrirla en la página Habilidades |
Una habilidad concedida de un espacio de trabajo en el que no estás se muestra en solo lectura, sin su Historial. El Historial de un panel en solo lectura muestra las versiones y Ver qué cambió, sin Restaurar, Bloquear ni Eliminar. Para trabajar a partir de una habilidad que no puedes cambiar, ábrela en la página Habilidades y usa Copiar a las mías.
Habilidades integradas
Sección titulada «Habilidades integradas»Algunas habilidades vienen con AptiveAI Agents y se ofrecen a todos los
agentes, junto a las de tu espacio de trabajo. No aparecen en la página
Habilidades, y su texto nunca se muestra: la transcripción solo registra que
se cargó la habilidad. Todos sus nombres empiezan por aptiveai_, así que no
ocupan un nombre que tus propias habilidades puedan usar.
| Habilidad | Qué hace |
|---|---|
aptiveai_tasks | Decir cómo va una tarea y dar su enlace, o iniciar una tarea nueva — consulta Lo que un agente puede hacer con tus tareas |
aptiveai_automations | Crear, cambiar, pausar, reanudar, ejecutar o eliminar una automatización, o listarlas, desde una conversación |
aptiveai_create_agent | Convertir la conversación en un agente nuevo tuyo, cuando lo pides |
aptiveai_build_skill | Guardar como habilidad lo que se hizo en la tarea, cuando lo pides |
aptiveai_docs | Responder una pregunta sobre cómo funciona AptiveAI Agents a partir de esta documentación, con un enlace a la página que leyó |
Una habilidad integrada puede traer herramientas consigo, algo que una
habilidad del espacio de trabajo no puede: aptiveai_tasks le da al agente
herramientas para buscar e iniciar tareas, aptiveai_automations, una
herramienta para gestionar automatizaciones, y aptiveai_docs, una herramienta
para leer este sitio.
Hay una habilidad integrada más, aptiveai_site_calls, que se usa mientras se crea
una llamada al sitio —en el
entrenamiento, Generar con el agente y el
constructor de agentes— y en una tarea en la que participa una persona, para
averiguar por qué falló una llamada al sitio y corregirla. No se ofrece a una
tarea sin computadora, a una tarea de una automatización en la que nadie ha
escrito ni en un espacio de trabajo que guarda datos regulados.
Quién puede hacer qué
Sección titulada «Quién puede hacer qué»| Acción | Quién |
|---|---|
| Escribir una habilidad | Todos en el espacio de trabajo |
| Editar una habilidad | La persona que la escribió y quienes tienen Puede editar |
| Eliminar una habilidad | La persona que la escribió |
| Compartir una habilidad con personas | La persona que la escribió y quienes tienen Puede editar |
| Compartirla con Todos en el espacio de trabajo | Propietarios y administradores |
| Copiar una habilidad como propia | Todos los que pueden usarla |
| Editar, desactivar o eliminar una habilidad propia de un agente | Cualquiera que pueda editar el agente |
| Compartir con el espacio de trabajo una habilidad propia de un agente | Cualquiera que pueda editar el agente y sea propietario o administrador de su espacio de trabajo |
| Eliminar una versión | Cualquiera que pueda editar la habilidad; nunca una versión de una habilidad propia de un agente, ni una bloqueada o la actual |