Importar y exportar un agente

Un agente Aidoo se describe por completo en un archivo JSON. Puedes exportarlo desde su ficha, releerlo, modificarlo en un editor de texto, versionarlo con tu código o entregárselo a un compañero, y luego importarlo en otro espacio de trabajo. El archivo sigue el formato aidoo-agent/v1.

Tres usos habituales:

• Duplicar entre espacios: un agente ajustado en un primer Odoo se reinstala en un minuto para otro cliente u otra empresa.
• Conservar un historial: un archivo por agente en un repositorio Git, y cada cambio de misión o de regla se convierte en una revisión legible.
• Escribir un agente fuera de la interfaz: un integrador, un script o un asistente de IA puede producir el archivo; Aidoo lo valida al importar y lo muestra en el asistente de creación antes de guardar nada.

Exportar

Abre la ficha del agente y pulsa el botón JSON (icono de descarga) en la cabecera. El navegador descarga agent-<nombre-del-agente>.json. La exportación está reservada a propietarios y administradores del espacio.

Importar

En Agentes > Nuevo agente, elige Importar un archivo JSON (aidoo-agent/v1). Aidoo comprueba el archivo y abre el asistente de creación ya rellenado. En ese momento no se guarda nada: designas la identidad Odoo, eliges los usuarios Odoo que verán el agente en el widget, revisas cada paso y Crear el agente lo crea y lo activa, igual que cualquier otro agente. Un archivo inválido se rechaza indicando el campo en cuestión.

Si el archivo no precisa permissions.learning (y el agente no está en modo workflowsOnly), empieza en modo aprendizaje y las reglas del archivo sirven de reglas de partida.

El archivo

{
  "schema": "aidoo-agent/v1",
  "exportedAt": "2026-09-16T10:00:00.000Z",
  "source": { "agentId": "64a1b2c3d4e5f6789012345a", "workspace": "ACME" },
  "agent": { "...": "la configuración, detallada más abajo" }
}

Un archivo escrito a mano solo necesita schema y agent.

Lo que la exportación nunca contiene

El archivo es una configuración portable, no una caja fuerte. No contiene:

• ninguna identidad Odoo: al importar, vuelves a elegir el miembro cuyos derechos usa el agente;
• ninguna clave API, token ni credencial de conexión;
• ninguna competencia, fuente de conocimiento ni archivo del Drive: pertenecen al espacio; vuelve a adjuntarlos tras la importación;
• ningún grupo de agentes: el grupo es propio del espacio; coloca el agente en un grupo tras la importación;
• ninguna conexión a las apps externas: el archivo conserva el nombre de cada app y las herramientas elegidas, no la cuenta conectada; conecta la app en Integraciones del espacio de destino;
• ningún estado de ejecución: historial de misión, observaciones del modo aprendizaje, contadores de errores, cursores de eventos.

Dos campos merecen un vistazo antes de compartir un archivo: notifications.email.recipients (direcciones de correo) y assignedOdooLogins (identificadores Odoo de los usuarios que ven el agente en el widget). Vacíalos si el archivo cambia de empresa. Los collaborators son identificadores de agentes del espacio de origen: al importar en otro espacio, los que no existen se ignoran sin más. Los allowedWorkflowIds también designan workflows del espacio de origen: vuelve a seleccionarlos en el paso Permisos. Las rutas de drive.folders se conservan tal cual: comprueba que esas carpetas existen en el Drive de destino.

Ejemplo completo

El agente «Seguimiento de facturas vencidas» de la galería, tal como se exporta:

{
  "schema": "aidoo-agent/v1",
  "agent": {
    "name": "Seguimiento de facturas vencidas",
    "avatar": { "seed": "finance-relance-impayes" },
    "mode": "scheduled",
    "instructions": "Cada mañana, lista las facturas de cliente (account.move, move_type='out_invoice') validadas, no pagadas y con fecha de vencimiento superada. Para cada una, añade una nota en el chatter resumiendo el retraso (días, importe) y planifica una actividad de seguimiento para el comercial responsable. Termina con un resumen: número de facturas vencidas, importe total, los 5 clientes más afectados.",
    "style": { "preset": "descriptive" },
    "model": { "provider": "auto", "modelId": "auto" },
    "environment": "production",
    "timezone": "Europe/Madrid",
    "trigger": { "cron": "0 8 * * 1-5" },
    "permissions": {
      "workflowsOnly": false,
      "webAccess": false,
      "requireApproval": false,
      "email": false,
      "emailMode": "propose",
      "document": false,
      "askUser": false,
      "rules": [
        { "scope": { "groupKey": "facturation" }, "operations": ["query", "read"] },
        { "scope": { "models": ["mail.activity"] }, "operations": ["query", "read", "create"] },
        {
          "scope": { "models": ["account.move"] },
          "operations": ["query", "read", "write"],
          "valueConditions": [{ "field": "move_type", "operator": "=", "value": "out_invoice" }]
        }
      ],
      "learning": { "active": true }
    },
    "limits": { "timeoutSecondsPerRun": 300, "maxAutoEmailsPerRun": 10 },
    "autoPause": { "enabled": true, "maxConsecutiveErrors": 3 },
    "activeHours": { "enabled": false, "days": [1, 2, 3, 4, 5], "start": "08:00", "end": "18:00" },
    "notifications": {
      "email": { "enabled": false, "recipients": [], "frequency": "onlyOnError" },
      "odooChatter": { "enabled": false },
      "odooDiscuss": { "enabled": false },
      "questions": { "widget": true, "email": false }
    },
    "assignedOdooLogins": [],
    "commands": [
      {
        "id": "seguimiento-cliente",
        "label": "Reclamar a un cliente",
        "prompt": "Reclama todas las facturas vencidas de este cliente y resume lo que has hecho.",
        "variables": [{ "name": "Cliente", "required": true }]
      }
    ]
  }
}

Referencia de campos

Los valores marcados «por defecto» pueden omitirse: Aidoo los completa al importar.

Identidad y misión

Modelo y entorno

Disparador (trigger)

Permisos (permissions)

Salvo en modo workflowsOnly, un agente necesita al menos una regla, una app externa, el acceso web, el acceso al Drive o el modo aprendizaje.

Cada regla:

Límites y pausa automática

Franjas horarias, notificaciones, visibilidad, comandos

Compatibilidad

• Los campos desconocidos se ignoran al importar: un archivo producido por una versión más reciente de Aidoo se importa, sin los ajustes que esa versión añadió.
• Los campos ausentes toman su valor por defecto.
• Un archivo cuyo schema no sea aidoo-agent/v1 se rechaza. Solo se introducirá un nuevo número de versión para un cambio incompatible, con una pasarela desde los archivos v1.
• La exportación pasa por la misma validación que la importación: un archivo exportado siempre se vuelve a importar.

Siguiente paso

• Crear un agente: los otros caminos de creación
• Reglas y permisos: construir reglas seguras