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-<nom-de-l-agent>.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, choisissez les utilisateurs Odoo qui verront l'agent dans le widget, relisez chaque étape, puis Créer l'agent le crée et l'active, comme n'importe quel autre agent. Un fichier invalide est refusé avec le champ en cause.

Si le fichier ne précise pas permissions.learning (et que l'agent n'est pas en mode workflowsOnly), il démarre en mode apprentissage et les règles du fichier servent de règles de départ.

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, ni fichiers du Drive : ils appartiennent à l'espace ; réattachez-les après l'import ;
• ni groupe d'agents : le groupe est propre à l'espace ; rangez l'agent dans un groupe après l'import ;
• ni connexion aux apps externes : le fichier garde le nom de chaque app et les outils retenus, pas le compte connecté ; connectez l'app dans Intégrations de l'espace de destination ;
• 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. Les allowedWorkflowIds désignent eux aussi des workflows de l'espace d'origine : resélectionnez-les à l'étape Permissions. Les chemins de drive.folders sont repris tels quels : vérifiez que ces dossiers existent dans le Drive de destination.

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,
      "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": "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, l'accès au Drive 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