Saltar al contenido

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.

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.

Las habilidades se muestran en dos grupos:

GrupoQué contieneQué puedes hacer
MíasLas habilidades que escribisteEditarlas, compartirlas o eliminarlas
Compartidas por tu equipoHabilidades que otras personas del espacio de trabajo compartieronCopiar 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ú /.

Nueva habilidad abre una página propia, con un solo Guardar en su encabezado:

SecciónQué contiene
DetallesEl 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
InstruccionesEl texto en sí, hasta 10,000 caracteres. {word} se convierte en un espacio en blanco
ScriptsCó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
HistorialAparece 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.

  • 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.

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.

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:

HabilidadQuién puede editarla ahíLos demás
Una de las habilidades propias de este agenteCualquiera que pueda editar el agenteLa ven en solo lectura
Una habilidad del espacio de trabajo concedida al agenteQuien pueda editar esa habilidad: la persona que la escribió y quienes tienen Puede editarLa 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.

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.

HabilidadQué hace
aptiveai_tasksDecir 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_automationsCrear, cambiar, pausar, reanudar, ejecutar o eliminar una automatización, o listarlas, desde una conversación
aptiveai_create_agentConvertir la conversación en un agente nuevo tuyo, cuando lo pides
aptiveai_build_skillGuardar como habilidad lo que se hizo en la tarea, cuando lo pides
aptiveai_docsResponder 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.

AcciónQuién
Escribir una habilidadTodos en el espacio de trabajo
Editar una habilidadLa persona que la escribió y quienes tienen Puede editar
Eliminar una habilidadLa persona que la escribió
Compartir una habilidad con personasLa persona que la escribió y quienes tienen Puede editar
Compartirla con Todos en el espacio de trabajoPropietarios y administradores
Copiar una habilidad como propiaTodos los que pueden usarla
Editar, desactivar o eliminar una habilidad propia de un agenteCualquiera que pueda editar el agente
Compartir con el espacio de trabajo una habilidad propia de un agenteCualquiera que pueda editar el agente y sea propietario o administrador de su espacio de trabajo
Eliminar una versiónCualquiera que pueda editar la habilidad; nunca una versión de una habilidad propia de un agente, ni una bloqueada o la actual