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-<id>.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, revisas cada paso, y el agente se crea como borrador igual que cualquier otro. Un archivo inválido se rechaza indicando el campo en cuestión.

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 ni fuente de conocimiento: pertenecen al espacio; vuelve a adjuntarlas tras la importación;
• 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.

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,
      "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" }]
        }
      ]
    },
    "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 }
    },
    "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 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