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.

Cuando un agente espera algo de ti (una operación que validar, la respuesta a una pregunta), lo indica en Aidoo y, según su configuración de notificaciones, en la burbuja de Odoo o por correo.

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: desde la creación, en el paso Notificaciones y acceso, y después en cualquier momento 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. Las operaciones que validar, los correos propuestos y las preguntas del agente también se gestionan ahí, sin pasar por Aidoo.

La ficha abierta acompaña tus mensajes. Cuando escribes a un agente desde una ficha de Odoo (un presupuesto, un lead, una factura), esa ficha se adjunta al mensaje: una etiqueta encima del campo de texto la recuerda. Viene marcada por defecto; un clic la desmarca, y esa elección se recuerda en tu navegador. El agente solo lee la ficha si tu petición la concierne, y siempre dentro de sus reglas.

Varios agentes a la vez. En ordenador, la chincheta junto a un agente (Fijar en una ventana) lo abre en su propia ventana en la parte inferior de la pantalla de Odoo, hasta tres a la vez. Un clic simple sigue abriendo el agente en el panel.

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. El motivo aparece en el aviso «Agente puesto en pausa automáticamente» de su ficha. Cuatro causas posibles:

1. Fallos consecutivos. Se ha alcanzado el umbral configurado (3 por defecto). 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.
4. Techo de escrituras superado. Si has rellenado Escrituras máx. / ejecución, una ejecución que lo supere pausa al agente.

Corrige la causa y haz clic en Reanudar desde su ficha.

Ya no se ejecuta a la hora prevista

Su estado no indica ninguna pausa, pero sus ejecuciones programadas ya no salen. Causa más frecuente: una operación espera tu validación. El último informe termina indicando que una operación espera tu validación y que el agente está en pausa. Mientras no se resuelva, las ejecuciones programadas se omiten, sin consumir nada. Apruébala o recházala: el agente se reanuda enseguida con tu decisión. Consulta la validación humana.

Otras causas que comprobar: un horario de actividad que excluye la hora prevista, el presupuesto mensual del agente agotado, el fondo de créditos vacío o el interruptor general activado.

La ejecución se detiene antes de terminar

El informe siempre indica por qué. Los motivos más habituales:

Todos estos límites se configuran en Límites y seguridad, al crear el agente o desde su ficha.

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.
5. Los documentos leídos. Cada documento nuevo leído cuesta 1 crédito por cada tramo de 20 páginas; un agente que abre todos los adjuntos de un lote grande lo nota.

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.

Para un disparador por fecha, Aidoo detecta los vencimientos próximos al menos cada 10 minutos: un registro creado o desplazado menos de 10 minutos antes de su vencimiento puede salir con retraso, o incluso perderse.

«Créditos agotados»

No sale ninguna ejecución mientras el fondo esté vacío, y no se factura nada. Las ejecuciones previstas entretanto se omiten; el agente recupera su ritmo en cuanto vuelven los créditos. Contrata una recarga, espera la renovación mensual o libera presupuesto espaciando un agente. Consulta Créditos y consumo.

Si el mensaje indica que has alcanzado tu límite mensual de créditos IA, es tu techo personal el que se ha alcanzado, no el fondo: solo un propietario o un administrador puede subirlo, desde la página Equipo.

Un agente ha hecho algo inesperado en Odoo

Si la ejecución sigue en curso, haz clic en Detener en la burbuja «Ejecución en curso» de su hilo: la herramienta en curso termina y después no sale nada más.

Abre luego 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, fija un techo de escrituras, marca Validación humana 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. El botón Probar (dry run) simula las escrituras: cuesta unos créditos y evita correcciones en Odoo.

Fija un techo de escrituras ajustado. El campo está vacío (ilimitado) por defecto; cinco por ejecución encaja con la mayoría de las misiones que empiezan. 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