Assistant via API Expérimental

Le mode API connecte l'assistant intégré d'Ordicab à un fournisseur IA cloud via une clé API. Vous bénéficiez de la puissance des grands modèles avec une grande flexibilité de choix, et une option de pseudonymisation pour minimiser l'exposition des données personnelles.

Principe

À la différence du mode Cowork qui utilise un agent autonome, le mode API propose un chat intégré directement dans Ordicab. L'assistant connaît le contexte de votre dossier actif et peut exécuter des opérations structurées (mise à jour de contacts, extraction de dates…) via des outils spécialisés.

La clé API est stockée localement sur votre machine et n'est jamais transmise à Ordicab. Ordicab l'utilise directement pour appeler le fournisseur IA de votre choix.

Fournisseurs supportés

Infomaniak — la solution souveraine

Infomaniak est un hébergeur suisse qui propose une API IA compatible avec le standard OpenAI. C'est une alternative sérieuse pour les professionnels soucieux de la localisation de leurs données :

• Données hébergées en Suisse, soumises au droit suisse
• Tarification à la consommation, sans abonnement minimum
• Modèles open source de qualité (Llama, Mixtral…)
• Compatible RGPD européen

Pour Infomaniak, une référence projet / workspace est requise en plus de la clé API — vous la trouverez dans votre espace Infomaniak.

Configuration

1. Obtenez une clé API auprès du fournisseur de votre choix et notez l'URL de l'endpoint API.
2. Dans Ordicab, ouvrez Paramètres → Configuration IA et sélectionnez API externe (clé API).
3. Renseignez l'URL du fournisseur (ex. https://api.openai.com/v1), votre clé API et le nom du modèle à utiliser.
4. Pour Infomaniak, renseignez également la référence projet.
5. Cliquez sur Vérifier la connexion. Ordicab teste l'accès et confirme que le fournisseur est joignable.
6. Enregistrez la configuration. L'assistant IA est maintenant actif dans l'interface.

Pseudonymisation des données Expérimental

Le mode API propose une option de pseudonymisation automatique des données personnelles avant leur envoi au fournisseur. Lorsqu'elle est activée, Ordicab remplace les noms, adresses, numéros et autres informations identifiantes par des alias fictifs et cohérents — puis restitue les données réelles dans la réponse finale.

Avertissement confidentialité

Même avec la pseudonymisation activée, la substance de vos échanges (nature du dossier, questions posées, extraits de documents non identifiants) est transmise au fournisseur IA. Évaluez la compatibilité de ce mode avec vos obligations professionnelles.

Ordicab vous rappelle cet avertissement lors de la première activation du mode API et vous demande de confirmer.

Référence technique — outils disponibles

L'assistant API dispose d'un ensemble d'outils structurés qu'il peut invoquer pour lire et modifier les données Ordicab. Ces outils sont passés au modèle IA via le protocole de function calling standard.

Lecture de données

• dossier_get — Charge les métadonnées complètes du dossier actif : statut, type, information, dates clés, références clés.
• contact_lookup — Liste tous les contacts du dossier avec leur UUID et leur rôle.
• contact_get — Récupère le détail complet d'un contact (coordonnées, dates, champs gérés) à partir de son UUID.
• managed_fields_get — Charge les rôles de contacts configurés et les champs personnalisés définis dans le profil de l'entité.
• template_list — Liste les modèles de documents disponibles (identifiant, nom, description).
• document_list — Liste les documents présents dans le dossier avec leurs métadonnées (nom, type, annotation).
• document_get — Récupère les détails complets d'un document.
• document_search — Recherche en langage naturel dans le texte pré-extrait de tous les documents du dossier.
• document_analyze — Lit le texte pré-extrait d'un document précis pour en analyser le contenu.

Actions sur les contacts

• contact_upsert — Crée ou met à jour un contact dans le dossier.
• contact_delete — Supprime un contact du dossier.

Actions sur le dossier

• dossier_select — Définit un dossier comme contexte actif de la session.
• dossier_upsert_key_date — Ajoute ou met à jour une date clé (audience, échéance, délai…).
• dossier_delete_key_date — Supprime une date clé.
• dossier_upsert_key_reference — Ajoute ou met à jour une référence clé (numéro de rôle, référence client…).
• dossier_delete_key_reference — Supprime une référence clé.

Actions sur les documents et modèles

• template_select — Sélectionne un modèle de document par nom pour l'étape de génération.
• field_populate — Prépare le remplissage des champs d'un modèle à partir des données d'un contact.
• document_generate — Génère un document final à partir d'un modèle et des données du dossier.
• document_metadata_save — Enregistre ou met à jour la description et les tags d'un document.
• document_relocate — Met à jour le lien de métadonnées d'un document après un déplacement de fichier.

Actions générales

• text_generate — Demande à l'IA de rédiger un texte libre (email, courrier, analyse, résumé) sans générer de document Ordicab.
• clarification_request — Permet à l'IA de poser une question de clarification structurée avant d'agir.