Crear un agente
Los cuatro caminos de creación, la elección del modelo de IA, cómo escribir una buena misión, el disparador, los límites y la prueba en seco nada más crearlo.
12 min de lecturaActualizado el 1 de octubre de 2026
Cuatro caminos llevan al mismo resultado. Elige según lo que ya sepas de tu necesidad.
Los cuatro caminos
| Camino | Cuándo elegirlo | Tiempo |
|---|---|---|
| Partir de una plantilla | Tu necesidad se parece a un caso habitual | 2 minutos |
| Describirlo en lenguaje corriente | Sabes lo que quieres, no cómo configurarlo | 5 minutos |
| Configurarlo a mano | Quieres controlar cada regla | 15 minutos |
| Importar un archivo | Recuperas un agente exportado de otro espacio | 1 minuto |
Partir de una plantilla
La Galería de plantillas ofrece ocho agentes probados, con permisos ya reducidos a lo estrictamente necesario. Eliges, ajustas la misión y el calendario, y ya está.
Es el camino recomendado para un primer agente, aunque la plantilla no encaje exactamente: resulta más sencillo adaptar un agente acotado que configurarlo todo desde cero.
Describirlo en lenguaje corriente
Con Describir en lenguaje natural, escribes lo que el agente debe hacer y Aidoo propone una configuración completa: misión reformulada, disparador, reglas y límites. Si algo sigue sin estar claro, primero te hace algunas preguntas.
La descripción puede ser larga, hasta 40 000 caracteres: un pliego de condiciones completo cabe sin dividirlo, y Aidoo lo condensa en una misión de 20 000 caracteres como máximo. El modelo propuesto es siempre Auto; podrás elegir uno concreto después, desde la configuración del agente.
Cada lunes por la mañana, localiza los presupuestos de más de 10 000 € enviados hace más de dos semanas sin respuesta, y programa una actividad de seguimiento para el comercial correspondiente.
La propuesta siempre pasa por tu revisión
Aidoo nunca crea el agente solo a partir de la descripción. Ves la configuración propuesta, la ajustas paso a paso y luego la creas. Esta generación consume algunos créditos, como cualquier llamada a un modelo.
Configurarlo a mano
El Formulario en blanco, paso a paso: Identidad, Rol y modelo de IA, Disparador, Permisos, Límites y seguridad, Notificaciones y acceso, Resumen. Útil cuando tu caso es concreto, o cuando quieres entender exactamente qué hace cada ajuste. Los demás caminos pasan por los mismos pasos, ya rellenados.
Importar un archivo
Un agente se exporta en formato aidoo-agent/v1 y se importa en otro sitio con Importar un archivo JSON (aidoo-agent/v1). Práctico para reutilizar un agente probado en otro espacio de trabajo. La exportación no contiene ni identidad de Odoo ni secretos: designas de nuevo al miembro al importar. El formato, un ejemplo completo y la referencia de cada campo están en Importar y exportar un agente.
Escribir una buena misión
Es el ajuste que más pesa. Una misión imprecisa produce un agente impredecible.
Di qué buscar, con precisión. «Las facturas atrasadas» deja demasiado margen; «las facturas de cliente validadas, impagadas y con el vencimiento superado» no deja ninguna duda.
Di qué hacer con cada elemento. El agente debe saber si añade una nota, programa una actividad, envía un correo o se limita a contar.
Di cómo concluir. «Termina con un resumen: número de facturas atrasadas, importe total y los cinco primeros clientes afectados.» Sin esa frase, la rendición de cuentas varía de una ejecución a otra.
Acota el volumen. «Trata como máximo las 20 más antiguas» evita que una ejecución se lance sobre 400 registros el día en que tu base crezca.
La misión admite hasta 20 000 caracteres: suficiente para un pliego de condiciones detallado, con sus reglas, sus casos particulares y el formato de salida esperado.
La prueba de la lectura ajena
Haz que lea la misión alguien que no conozca la necesidad. Si te hace una pregunta, el agente se encontrará con la misma duda, y la resolverá solo, a su manera.
Elegir el modelo de IA
Por defecto, el modelo es Auto: Aidoo elige un modelo económico adaptado a los agentes y lo mantiene al día, sin que tengas que ajustar nada. Es la opción adecuada para la mayoría de las misiones.
Si tu misión lo requiere, elige un modelo concreto. Cada uno muestra tres indicadores: Coste, Velocidad, Potencia. El coste se traduce directamente en créditos consumidos.
| Tipo de misión | Modelo recomendado |
|---|---|
| Listar, contar, resumir una lista | Un modelo económico |
| Redactar un mensaje adaptado al contexto | Un modelo intermedio |
| Analizar, comparar, decidir entre varias opciones | El modelo más capaz |
Empieza con Auto o un modelo económico. Si los resultados son aproximados, sube un escalón: sale más rentable que pagar un modelo potente para contar facturas.
Durante la prueba gratuita
Solo están disponibles los modelos económicos, y la prueba está limitada a 500 créditos o 30 días, lo que ocurra antes.
El disparador
Tres modos: Programado, Por eventos o Conversacional.
Programado: un ritmo listo para usar («Cada mañana laborable (8h)», «Cada hora»…) o un ritmo Personalizado: frecuencia, días, hora. El ritmo personalizado admite hasta 5 franjas para horarios distintos según el día, por ejemplo de lunes a jueves a las 15 h y el viernes a las 13 h (Añadir una franja). Ningún nivel acota esa frecuencia: el agente sigue exactamente el calendario que le das, en su propia zona horaria, con al menos 5 minutos entre dos ejecuciones. El Horario de funcionamiento limita de forma opcional las ejecuciones automáticas a ciertos días y franjas.
Por eventos: eliges un modelo de Odoo, el tipo de evento (creación o modificación) y condiciones opcionales. Aidoo vigila ese modelo a un ritmo fijado por tu nivel: una hora en Starter, un cuarto de hora en Pro, cinco minutos en Business. Es el retardo de reacción máximo del agente.
Por ejemplo: modelo crm.lead, en la creación, sin condición, para cualificar cada lead nuevo. O modelo sale.order, en la modificación, con la condición state = sale, para reaccionar a los pedidos confirmados.
Por eventos, en una fecha: con En una fecha del registro, el agente se ejecuta en el momento exacto en que vence un campo de fecha del registro, adelantado o retrasado los minutos que elijas (3 puntos de disparo como máximo, una semana de desfase como máximo). Por ejemplo: modelo calendar.event, 30 minutos antes de start para preparar un briefing.
Conversacional: ningún disparador. El agente responde cuando se le habla, desde Aidoo o desde la burbuja de Odoo.
La identidad de Odoo
En el paso Identidad, el campo Cuenta Odoo del agente designa la cuenta cuyos permisos tomará prestados el agente. Solo los propietarios y administradores pueden hacer esta elección. Solo se pueden seleccionar las cuentas cuyo miembro ha guardado su token personal de Odoo en Aidoo: las demás aparecen en gris.
Ninguna licencia de Odoo adicional
Un agente se apoya en cualquier licencia de Odoo existente: toma prestada la cuenta de un miembro que ya está en el sistema, sin usuario adicional que crear ni licencia que pagar. Esa cuenta fija su alcance, así que elígela en función de lo que el agente deba poder tocar.
Los permisos: aprendizaje por defecto
No hace falta rellenar la matriz de reglas al crear el agente. La casilla Modo aprendizaje viene marcada de serie: durante 48 horas, el agente descubre por sí mismo lo que necesita.
- Lee todo lo que ve su cuenta de Odoo.
- Una escritura sobre un modelo que ninguna regla cubre queda en espera: la apruebas o la rechazas, desde Aidoo o desde la burbuja de Odoo. Nada se escribe sin ti.
- Cada acceso realmente ejecutado se anota en la lista de accesos observados, visible en la ficha del agente.
- Al cabo de 48 horas, los permisos se congelan: los accesos observados se convierten en reglas normales, que puedes retocar. También puedes congelar antes, con un clic.
Las reglas de una plantilla de la galería, de una generación por prompt o de un archivo importado se mantienen como reglas de partida: sus escrituras pasan sin validación, el aprendizaje completa el resto. Una vez congelados los permisos, un propietario o un administrador puede Relanzar el aprendizaje desde la ficha del agente para una nueva ventana de 48 horas.
Desmarca la casilla para recuperar el editor de reglas clásico, descrito en Reglas y permisos.
Ponlo a trabajar durante la ventana
Un agente que no ha observado nada se queda sin ningún permiso al congelar. Ejecútalo, conversa con él, déjale tratar algunos casos reales: lo que hace durante esas 48 horas fija lo que podrá hacer después.
El mismo paso ofrece capacidades opcionales, todas desactivadas por defecto:
- Acceso web: buscar en la web y leer páginas públicas.
- Validación humana de escrituras: cada creación, modificación o acción en Odoo espera tu aprobación.
- Proponer correos (envío validado): el agente prepara correos de Odoo y tú los revisas antes del envío. El envío automático se activa después de la creación, desde la ficha del agente.
- Lectura de documentos: leer los PDF e imágenes adjuntos a los registros, escaneos incluidos.
- Puede hacer una pregunta a una persona: en ejecución autónoma, el agente se detiene en una pregunta y retoma con tu respuesta.
- Drive Aidoo: leer y escribir archivos en el espacio de archivos del espacio de trabajo.
Las apps externas (Slack, Gmail…) se describen en Integraciones.
Notificaciones y acceso
El penúltimo paso fija dónde rinde cuentas el agente: correo, chatter de Odoo, canal de Discuss. También designa, desde la creación, a los usuarios de Odoo que verán el agente en la burbuja de Aidoo de su Odoo: tu propia cuenta viene marcada si está vinculada, y Seleccionar todo marca a todo el equipo. Un agente conversacional solo pueden usarlo en Odoo los usuarios marcados aquí. La lista se puede cambiar después desde la ficha del agente.
Los límites de seguridad
El paso Límites y seguridad reúne las salvaguardas, ajustables por agente:
| Límite | Función | Por defecto |
|---|---|---|
| Acciones máx. / ejecución | Impide que un bucle consuma sin fin | Ilimitado (campo vacío) |
| Créditos máx. / ejecución | Pone techo al coste de una ejecución | 100 créditos, también el mínimo |
| Tiempo máx. (segundos) | Interrumpe una ejecución que se alarga | 300 s, hasta 4 500 s |
| Escrituras máx. / ejecución | Bloquea al agente más allá de N escrituras | Ilimitado (campo vacío) |
Una escritura cuenta una llamada, no un registro: modificar 50 tickets en una sola llamada agrupada cuenta como 1. El techo de escrituras sigue siendo el más útil al principio: fijado en 5, te permite comprobar qué modifica el agente antes de soltarle las riendas.
La Pausa automática detiene al agente tras varios fallos seguidos (3 por defecto). También puedes fijar un Presupuesto mensual del agente (créditos), además del fondo común del espacio de trabajo, y, si el agente envía sus propios correos, un número máximo de correos automáticos por ejecución (10 por defecto).
Crear el agente
El Resumen termina con un único botón, Crear el agente: el agente se crea y se activa de inmediato. Recibe su propia clave API, cuyos permisos derivan exactamente de sus reglas: ni más, ni menos. Durante la ventana de aprendizaje esa clave lleva todas las operaciones, y el motor de reglas decide llamada a llamada; se ajusta al congelar.
Si la activación se rechaza (sin suscripción Agents, nivel insuficiente, límite de agentes activos alcanzado), el agente se queda en Borrador: su ficha muestra el motivo y el botón Activar.
Probar sin riesgo
Haz una prueba en seco nada más crearlo
No se lanza ninguna prueba automáticamente. Desde la ficha del agente, Probar (dry run) ejecuta la misión de verdad, pero simula las escrituras: el agente te muestra lo que habría creado o modificado, sin cambiar nada en Odoo. Es la única forma de ver cómo interpreta tu misión antes de que produzca efectos. Si quieres probarlo antes de su primera franja, o retocar antes su misión, ponlo en pausa (Pausar) mientras haces las pruebas.
Cada ejecución deja su informe en el hilo de conversación del agente: lo que ha constatado, lo que ha escrito realmente y las cifras que resumen su paso. Es lo primero que hay que leer después de una prueba.
Para el detalle, el icono de depuración de una burbuja de ejecución abre la traza completa: cada llamada de herramienta, con sus parámetros, su resultado, su estado y su duración. Si el agente lee diez veces el mismo registro o se va a un modelo inesperado, hay que reformular la misión.
Una ejecución que va por mal camino, real o simulada, se interrumpe con Detener: la herramienta en curso termina y luego el agente se detiene.
La primera ejecución real merece una lectura atenta. A partir de ahí, el resumen diario basta.
Después de la creación
Todo se gestiona después desde la ficha del agente:
- Renombrar: haz clic en su nombre.
- Pausar, Reanudar, Ejecutar bajo demanda.
- Duplicar: una copia en borrador, con la misma configuración y sus fuentes de conocimiento.
- Archivar: el agente se desactiva y su clave API se revoca. Lo encuentras de nuevo con Ver agentes archivados en la lista: Desarchivar lo devuelve a pausa con su clave reactivada.
- Los Comandos rápidos y los Agentes colaboradores solo se configuran en la ficha, no en el asistente de creación. Ver ¿Qué es un agente?.
Siguiente paso
- Reglas y permisos: acotar lo que el agente puede tocar
- Créditos y consumo: medir y controlar el coste
- Buenas prácticas y diagnóstico: cuando un agente se porta mal