Buenas prácticas y diagnóstico

Un agente que nadie lee no sirve de nada, y un agente que se porta mal se diagnostica casi siempre en el mismo sitio: su registro de ejecución.

Dónde llegan los resultados

Cuatro canales, combinables entre sí:

El chatter de Odoo es el canal más infravalorado: la nota llega a la factura o al presupuesto afectado, justo donde la verá quien debe actuar.

Un resumen diario reúne además la actividad de todos tus agentes en un único mensaje matutino.

El widget dentro de Odoo

Tus equipos pueden consultar sus agentes sin salir de Odoo: aparece una burbuja abajo a la derecha de tu Odoo de producción que muestra, para cada usuario, los agentes que tiene asignados y su historial.

La asignación se hace por login de Odoo, en la configuración del agente. Un comercial ve sus agentes, no los de contabilidad.

Al abrir un agente aparece su historial, igual que en el panel: los informes de sus ejecuciones y tus intercambios con él en un mismo hilo. La flecha de retroceso vuelve a la lista y el contador de créditos queda a la vista.

La misma burbuja puede alojar también un chat de Aidoo AI, alternativa a Claude o ChatGPT para los usuarios que prefieren no salir de Odoo. Ambas funciones se activan de forma independiente desde la página de Claves API.

Síntomas y causas

El agente se ha pausado solo

Es un comportamiento previsto, no una avería. Tres causas posibles:

1. Fallos consecutivos. Se ha alcanzado el umbral configurado. Abre el registro de la última ejecución: la causa está ahí.
2. Odoo inaccesible. La comprobación previa ha fallado varias veces seguidas. Revisa tu conexión con Odoo.
3. Identidad de Odoo no válida. El miembro cuyos permisos toma prestados el agente ya no tiene una clave de Odoo válida, o ha caducado.

Corrige la causa y reactiva el agente desde su página.

Consume mucho más de lo previsto

Mira en este orden:

1. Las herramientas externas. Una aplicación conectada sin restricción recarga todo su catálogo en cada turno. Es la causa más frecuente.
2. El volumen tratado. Si tu base ha crecido, una misión sin techo trata ahora diez veces más registros.
3. El número de idas y vueltas. El registro muestra cada llamada de herramienta. Un agente que relee diez veces el mismo registro tiene una misión mal formulada.
4. El modelo. Comprueba que nadie lo haya subido de escalón.

Los resultados varían de una ejecución a otra

La misión deja demasiado margen. Un agente no es determinista: con una instrucción imprecisa, el resultado varía.

Reescribe la misión y fija lo que deba fijarse: el filtro exacto, el número máximo de elementos, el formato del resumen esperado. «Haz el balance de los impagados» y «lista las facturas vencidas hace más de 30 días, como máximo 20, ordenadas por antigüedad, y termina con el total» no producen la misma estabilidad.

No encuentra nada aunque los datos existen

Casi siempre es un problema de permisos de Odoo, no de reglas de Aidoo. Inicia sesión en Odoo con la cuenta cuya identidad toma prestada el agente y busca los mismos registros. Si no aparecen, la causa está ahí.

Comprueba después las reglas multiempresa: el registro puede pertenecer a una empresa que esa cuenta no ve.

Un agente por eventos no se dispara

Tres comprobaciones:

1. El primer arranque no repite el pasado. El agente solo trata los registros creados o modificados después de su activación.
2. Las condiciones pueden ser demasiado estrictas. Prueba el mismo filtro en Odoo para ver si devuelve registros.
3. La frecuencia de vigilancia depende de tu nivel. En Starter, la comprobación se hace como máximo una vez por hora: un evento no se trata al instante.

«Créditos agotados»

Las ejecuciones están en cola, no se han perdido. Recarga con un pack, espera la renovación mensual o libera presupuesto espaciando un agente. Consulta Créditos y consumo.

Un agente ha hecho algo inesperado en Odoo

Abre su registro de ejecución: cada llamada aparece con sus parámetros. Sabrás exactamente qué se modificó y en qué momento.

Después, aprieta las tuercas: añade una condición de valor a la regla afectada, baja el techo de escrituras, o pasa el agente al modo solo flujos de trabajo mientras revisas su configuración.

Cinco hábitos que evitan disgustos

Un agente, una misión. Un agente que reclama impagados y cualifica leads y vigila el stock es ingobernable. Tres agentes separados se configuran, se diagnostican y se pausan de forma independiente.

Haz una prueba en seco tras cada cambio de misión. La prueba simula las escrituras: cuesta unos créditos y evita correcciones en Odoo.

Mantén ajustado el techo de escrituras. Cinco por ejecución encaja con la mayoría de las misiones. Un agente que choca contra el techo te enseña algo sobre su misión.

Lee el registro la primera semana. Después, el resumen diario basta.

Elige la licencia de Odoo según el alcance deseado. Un agente toma prestada cualquier cuenta de Odoo existente: la que designes ya acota lo que puede ver y modificar, antes incluso de las reglas de Aidoo.

Siguiente paso

• Reglas y permisos: estrechar el ámbito
• Créditos y consumo: controlar el coste