Importer et exporter un agent

Un agent Aidoo se décrit entièrement dans un fichier JSON. Vous pouvez l'exporter depuis sa fiche, le relire, le modifier dans un éditeur de texte, le versionner avec votre code ou le confier à un collègue, puis l'importer dans un autre espace de travail. Le fichier suit le format aidoo-agent/v1.

Trois usages courants :

• Dupliquer entre espaces : un agent mis au point sur un premier Odoo se réinstalle en une minute chez un autre client ou sur une autre société.
• Garder un historique : un fichier par agent dans un dépôt Git, et chaque changement de mission ou de règle devient une révision lisible.
• Écrire un agent hors de l'interface : un intégrateur, un script ou un assistant d'IA peut produire le fichier ; Aidoo le valide à l'import et vous le montre dans l'assistant de création avant toute sauvegarde.

Exporter

Ouvrez la fiche de l'agent et cliquez sur le bouton JSON (icône de téléchargement) dans l'en-tête. Le navigateur télécharge agent-<identifiant>.json. L'export est réservé aux propriétaires et administrateurs de l'espace.

Importer

Dans Agents > Nouvel agent, choisissez Importer un fichier JSON (aidoo-agent/v1). Aidoo vérifie le fichier, puis ouvre l'assistant de création prérempli. Rien n'est enregistré à ce stade : vous désignez l'identité Odoo, relisez chaque étape, et l'agent est créé en brouillon comme n'importe quel autre. Un fichier invalide est refusé avec le champ en cause.

Le fichier

{
  "schema": "aidoo-agent/v1",
  "exportedAt": "2026-09-16T10:00:00.000Z",
  "source": { "agentId": "64a1b2c3d4e5f6789012345a", "workspace": "ACME" },
  "agent": { "...": "la configuration, détaillée ci-dessous" }
}

Un fichier écrit à la main n'a besoin que de schema et agent.

Ce que l'export ne contient jamais

Le fichier est une configuration portable, pas un coffre. Il ne contient :

• ni identité Odoo : à l'import, vous choisissez à nouveau le membre dont l'agent utilise les droits ;
• ni clé API, ni jeton, ni identifiant de connexion ;
• ni compétences ni sources de connaissance : elles appartiennent à l'espace ; réattachez-les après l'import ;
• ni état d'exécution : historique de mission, observations du mode apprentissage, compteurs d'erreurs, curseurs d'événements.

Deux champs méritent un regard avant de partager un fichier : notifications.email.recipients (adresses e-mail) et assignedOdooLogins (identifiants Odoo des utilisateurs qui voient l'agent dans le widget). Videz-les si le fichier change de société. Les collaborators sont des identifiants d'agents de l'espace d'origine : à l'import dans un autre espace, ceux qui n'existent pas sont simplement ignorés.

Exemple complet

L'agent « Relance factures impayées » de la galerie, tel qu'il s'exporte :

{
  "schema": "aidoo-agent/v1",
  "agent": {
    "name": "Relance factures impayées",
    "avatar": { "seed": "finance-relance-impayes" },
    "mode": "scheduled",
    "instructions": "Chaque matin, liste les factures clients (account.move, move_type='out_invoice') validées, non payées et dont l'échéance est dépassée. Pour chacune, ajoute une note dans le chatter récapitulant le retard (jours, montant) et planifie une activité de relance pour le vendeur responsable. Termine par un résumé : nombre de factures en retard, montant total, top 5 des clients concernés.",
    "style": { "preset": "descriptive" },
    "model": { "provider": "auto", "modelId": "auto" },
    "environment": "production",
    "timezone": "Europe/Paris",
    "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": "relance-client",
        "label": "Relancer un client",
        "prompt": "Relance toutes les factures en retard de ce client et résume ce que tu as fait.",
        "variables": [{ "name": "Client", "required": true }]
      }
    ]
  }
}

Référence des champs

Les valeurs marquées « défaut » peuvent être omises : Aidoo les complète à l'import.

Identité et mission

Modèle et environnement

Déclencheur (trigger)

Permissions (permissions)

Sauf en mode workflowsOnly, un agent doit avoir au moins une règle, une app externe, l'accès web ou le mode apprentissage.

Chaque règle :

Limites et pause automatique

Plages horaires, notifications, visibilité, commandes

Compatibilité

• Les champs inconnus sont ignorés à l'import : un fichier produit par une version plus récente d'Aidoo s'importe, au prix des réglages qu'elle a ajoutés.
• Les champs absents prennent leur valeur par défaut.
• Un fichier dont schema n'est pas aidoo-agent/v1 est refusé. Un nouveau numéro de version ne sera introduit que pour un changement incompatible, avec une passerelle depuis les fichiers v1.
• L'export passe par la même validation que l'import : un fichier exporté se réimporte toujours.

Étape suivante

• Créer un agent : les autres chemins de création
• Règles et permissions : construire des règles sûres