Habilidades y memoria¶

Habilidades¶

Una habilidad (ai.skill) es un paquete de instrucciones reutilizable que el asistente puede cargar a mitad de una tarea, de forma similar a la divulgación progresiva de los agentes de programación modernos.

Menú: IA ‣ Configuración ‣ Comportamiento ‣ Habilidades

Campos¶

Campo	Finalidad
Nombre	Etiqueta corta de interfaz o catálogo
Código	Id técnico para `use_skill` (`^[a-z][a-z0-9_]*$`)
Descripción	Cuándo usarla (en inglés; se muestra al modelo)
Cuerpo	Instrucciones completas cuando está activa (en inglés)
Modo de activación	Bajo demanda (catálogo + `use_skill` / palabras clave) o Siempre (en cada turno — utilícelo con moderación)
Palabras clave de activación	Palabras clave separadas por comas en el último mensaje del usuario para la carga automática
Activo / secuencia	Visibilidad y orden
Procedencia	De fábrica / personalizada (y modificada de fábrica)

Comportamiento en tiempo de ejecución¶

El CRUD está reservado a Administrador de IA.
En tiempo de ejecución, todos los usuarios de IA ven las mismas habilidades activas (no hay un interruptor de habilidad por usuario).
Las herramientas list_skills / use_skill requieren la capacidad ask.
Unos límites acotan el tamaño del catálogo, el número de habilidades siempre activas y la longitud del cuerpo, de modo que ninguna habilidad pueda dominar el prompt.

Habilidades de fábrica¶

El módulo incluye habilidades de fábrica (datos XML, noupdate). Algunos ejemplos son los manuales operativos para facturas de proveedor, los patrones de conciliación bancaria, los seguimientos y los campos de producto sensibles a la localización, fundamentados en las pilas de eYssen cuando corresponde.

La acción de administración Sincronizar habilidades de fábrica actualiza desde el código, en cada actualización, las filas de fábrica que siguen sin modificar.
Si edita una habilidad de fábrica, pasa a estar modificada de fábrica y no se sobrescribe automáticamente; puede restablecerla a los valores de fábrica cuando lo desee.

Factura de proveedor a partir de documentos (`vendor_bill_from_documents`)¶

Manual completo de cuentas a pagar para Odoo 18: facturas de proveedor (in_invoice) enviadas por chat en PDF o en borrador que tienen archivos adjuntos pero líneas vacías. No es una habilidad de cuentas a cobrar ni de facturas de cliente.

Para qué está diseñada:

Resolver los indicadores del contacto y reutilizar los patrones de producto, cuenta, impuesto y analítica de facturas anteriores del mismo proveedor.
Rellenar líneas de factura solo en asientos en borrador.
Programar una tarea de revisión humana en cada factura que realmente haya modificado.
Ruta gemela de la NAV húngara (antes de rellenar las líneas): muchos proveedores húngaros ya existen como facturas importadas de la NAV. Si se encuentra exactamente una coincidencia clara (a menudo ya contabilizada), la habilidad vuelve a adjuntar la imagen o el PDF del borrador vacío a esa factura existente, anota la fusión y desvincula el borrador vacío solo cuando sigue sin tener líneas relevantes — no debe duplicar el registro de la misma factura. Los proveedores no húngaros o extranjeros omiten esta ruta.

Paradas obligatorias del manual:

No contabilizar, pagar ni escribir en los campos de transmisión de la NAV.
No inventar contactos, impuestos o cuentas cuando falla la reutilización de facturas anteriores — dejarlo para la persona.
Preferir informar de una factura existente antes que crear una segunda con el mismo contacto y la misma referencia.

Combínela con la Receta D en Recetas de agente (asistente de chat o agente programado). En un agente programado, la tarea permanente explora (busca ids, queue_work_items) y cada tarea secundaria ejecuta este playbook para una factura de proveedor — consulte Elementos de trabajo por registro. Para ejecuciones desatendidas, el Modo de escritura auto de la tarea solo es apropiado porque esta habilidad mantiene las facturas en borrador; si personaliza la habilidad para que las valide, vuelva a poner la tarea en confirmar.

Redactar una buena habilidad¶

Indique los disparadores con claridad en la descripción.
Indique los pasos en orden y qué herramientas llamar primero.
Indique qué no se debe inventar (cuentas, impuestos, contactos).
Mantenga cortas las habilidades siempre activas; deje los playbooks largos para cuando se soliciten.

Memoria¶

La memoria (ai.memory) almacena datos duraderos que el asistente puede recordar entre conversaciones.

Menú: AI ‣ Memoria ‣ Memorias y Grafo de memoria.

Tipos¶

De trabajo — contexto de tarea de corta duración
Episódica — lo que ocurrió en una sesión
Semántica — datos duraderos o preferencias
Archivo — almacenamiento en frío

Ámbitos¶

Usuario (privado de forma predeterminada)
Empresa / Sistema — administrador (o promoción aprobada)
Agente / Ejecución — contexto centrado en el agente

Los usuarios pueden crear o modificar los ámbitos de usuario, agente y ejecución; los de empresa/sistema requieren aprobación de un administrador o una promoción.

Herramientas¶

Dentro de la capacidad ask: memory_search, memory_save, memory_forget, memory_link. La inyección de memorias mediante el prompt está limitada en tamaño.

Buenas prácticas¶

Guarde las preferencias estables («el usuario quiere el formato de fecha HU») como semántica/usuario.
No almacene contraseñas, claves de API ni documentos de identidad personal completos en la memoria.
Revise periódicamente las memorias de ámbito empresa; trátelas como configuración compartida.
Utilice «forget» (olvidar) cuando un dato sea incorrecto: no acumule contradicciones.

Habilidades frente a memoria¶

Habilidades	Memoria
Cómo hacer un trabajo (playbooks)	Qué es cierto para este usuario u organización (datos, preferencias)
Configuración creada por un administrador	Creada por el usuario, el agente o en tiempo de ejecución
Puede tener una versión de fábrica	Datos operativos