--- title: "Travailler avec l’AI" url: https://developers.dagio.ai/fr/ai/ --- # Travailler avec l’AI ## Donner le contexte utile L’AI travaille à partir du contexte autorisé : le Workspace, la Surface ouverte, la section sélectionnée et les sources pertinentes. Vous n’avez pas à recopier une fiche entière dans chaque demande. Précisez l’objectif, les contraintes et le résultat attendu. Dans l’aperçu privé d’un Model, ce contexte décrit la destination et la fiche réellement ouvertes, pas une application ordinaire masquée. Les métadonnées de navigation et les citations de sources ne donnent pas un droit de lecture et n’incluent pas automatiquement le corps. Pour consulter le document, l’AI utilise une lecture autorisée distincte de sa version enregistrée exacte, soumise aux règles de divulgation du Model et aux contrôles d’accès aux références. Une saisie non enregistrée reste distincte de cette version ; l’aperçu ne publie pas la source privée. Si la fiche affichée est archivée ou supprimée logiquement, sa consultation distingue la version inactive courante d’une ancienne citation de source. Elle ne présente pas cette citation comme le corps à l’écran et ne donne pas le droit de restaurer la fiche. | Demande | Contexte utile | Résultat attendu | | ------------------------ | -------------------------------------- | -------------------------------------- | | Résumer le besoin | Fiche client et notes de qualification | Synthèse avec points incertains | | Préparer une proposition | Client, procédure et tarifs | Brouillon de soumission à examiner | | Adapter l’app | Model et configuration actuelle | Proposition de Fields, vues ou liens | | Revoir un résultat | Nouvelle source et résultat existant | Modifications ciblées et justification | Pour un client automatisé, `surface_graph_query` inclut les instructions obligatoires des Models et Workspaces de toutes les sources réellement consultées, pas seulement du premier Workspace ou du dernier ouvert. Des instructions obligatoires manquantes arrêtent la lecture ; elles n'élargissent pas les accès et ne retirent pas ses limites. Les lectures incrémentales du journal conservent les instructions du Workspace nommé, ou celles de Platform pour une lecture autorisée du compte entier. Cette dernière exige toujours un accès explicite à chaque Workspace enregistré. ## Choisir les instructions d’une Task de Flow Pour une Task créée par un Flow, Surface identifie les Actions opérationnelles déclarées pour cette Task exacte. Un choix unique est non ambigu ; si plusieurs sont proposés, choisissez explicitement. Un libellé, le premier élément d’une liste ou un autre document ouvert ne choisit pas une Action à votre place. Un client MCP automatisé utilise `surface_flow_task_operating_choices_get` avec l’application courante, la référence Surface et le snapshot exacts. Cette lecture exige `surface:read` et retourne seulement des métadonnées : elle ne charge aucun corps d’instructions et n’autorise aucune exécution. Transmettez l’exécution choisie à `surface_operating_flow_task_knowledge_get` pour lire ses instructions et références capturées autorisées. L’application courante et le programme Flow d’origine restent distincts, avec leurs propres versions consultées. Si le contexte Flow d’origine de la Task n’a pas été enregistré, si le programme n’est pas pris en charge ou si aucun choix déclaré n’est disponible, ne déduisez pas une Action et ne remplacez pas ses instructions par une autre famille. Actualisez une sélection devenue périmée et résolvez l’absence ou le refus signalé avant de poursuivre. ## Examiner avant d’appliquer Une proposition est distincte d’une opération enregistrée. L’interface présente l’objet concerné et les effets attendus. Les Actions et permissions Surface restent applicables aux demandes de l’AI; le fait de générer une composition ou du texte ne publie pas un Model et n’accepte pas une soumission. Le texte proposé apparaît progressivement dans la Surface concernée, sans modifier votre brouillon. Si vous commencez à écrire, changez de contenu ou perdez l’accès, la proposition ne remplace pas votre travail. Après une interruption de connexion, retrouvez la proposition finale sans relancer la génération. **Ajouter au brouillon** reste un choix explicite : les protections du document ou du champ s’appliquent, puis vous enregistrez avec les commandes habituelles. Masquer l’aperçu ne supprime pas le travail en cours ; **Arrêter la génération** demande son annulation séparément. L’arrêt peut rester demandé pendant que l’exécution se termine. Vous pouvez continuer à travailler et actualiser son état ; une demande d’arrêt n’est pas encore une confirmation d’arrêt. ## Utiliser votre environnement habituel Surface s’utilise depuis ses interfaces et ses intégrations avec des hôtes AI comme ChatGPT, Claude et Copilot selon les connexions disponibles. La conversation reste celle de l’hôte; la Surface apporte le contenu, les vues et les opérations contextualisées. Les fonctionnalités d’un hôte ne sont pas automatiquement identiques à celles d’un autre. ## Exemple de demande Pour un client MCP automatisé, `surface_profile_get` identifie le principal actif comme humain ou bot et retourne l'identifiant du client OAuth vérifié. Il n'atteste pas de délégation. Utilisez `surface_account_context_list` pour découvrir les comptes, puis transmettez le `tenantId` choisi à `surface_account_home_get` pour obtenir les adresses exactes de Home, Fil, Inbox, Preferences, Portfolio et Global Checkpoint. Ces adresses opaques ne confèrent aucun accès : chaque lecture ou écriture suivante vérifie ses propres permissions actuelles. Ces appels exigent `surface:read`. Pour conserver une entrée opérationnelle rédigée, utilisez `surface_operational_record` avec `surface:write` et un constructeur Home ou applicatif exact déclaré par le Model. Demandez d'abord `preview`, examinez les effets, puis envoyez `apply` avec la même intention et les mêmes valeurs, le hash du plan reçu, une confirmation explicite et la clé d'idempotence originale. Réutilisez cette clé après une réponse perdue ; ne créez pas une nouvelle intention pour récupérer un reçu. Un fait rédigé est une assertion attribuée et une note de décision est une proposition, pas une approbation métier. Un constructeur indisponible ou un contexte Task manquant est signalé explicitement. Les Results de Task sélectionnent, avec `SurfaceOperationalRecordInput@2`, la véritable Task et son action déclarée ; les décisions Work sélectionnent leur profil de consolidation et les révisions exactes du Work, de la proposition et de la cible. La branche Task exige aussi `surface:operational:write`. Preview, confirmation et replay conservent ces coordonnées et le plan revu. Un Result déclaré par une personne ne fournit pas de packet d'exécution AI privé et une note de décision rédigée ne devient jamais une décision Work en changeant son étiquette. L'activité découle du travail enregistré, jamais d'un ajout libre. > À partir d’Atelier Nord et de notre procédure commerciale, prépare une proposition d’entretien annuel. Utilise les tarifs de référence, signale les informations manquantes et demande ma validation avant de finaliser. Le [profil d’exécution](https://developers.dagio.ai/fr/runtime-profiles/) choisit les ressources et contraintes applicables; le [Flow](https://developers.dagio.ai/fr/flows/) conserve les étapes et les validations. ## Limites des requêtes MCP Une requête HTTP MCP complète, enveloppe JSON-RPC comprise, est limitée à 18 Mio d'octets UTF-8. Les arguments d'un appel d'outil peuvent contenir au plus 250 000 membres d'objets et éléments de tableaux cumulés; les caractères du texte ne sont pas comptés comme des éléments structurels. Une requête hors limite est refusée avant l'exécution de l'outil, sans troncature ni rejeu automatique. Les limites des documents, Forms et autres opérations restent indépendantes. Les réponses Resource ont leurs propres limites; ces budgets d'entrée ne fixent pas leur taille admise et ne garantissent pas l'ouverture ou l'enregistrement d'un document dans chaque hôte. Une requête dépassant la limite d'octets retourne HTTP 413; des arguments trop complexes produisent une erreur explicite de l'outil. Conservez votre saisie et examinez la limite indiquée avant de modifier la demande. Une réponse interrompue ou absente n'est pas un refus explicite : consultez le reçu de l'opération originale avant de réessayer. Le [guide de diagnostic](https://developers.dagio.ai/fr/troubleshooting/) précise les informations utiles pour demander de l'aide. ## Exemples appliqués : Une proposition fondée sur le contexte L’AI reçoit le client et les sources requises, dans les bornes de la politique du Model. ### Configuration Fragment à placer dans `contextPolicies[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-model-foundation/). ```json { "key": "quote-context", "targetDefinitionPaths": [ "workspace/quotes/surface/quote" ], "sources": [ { "key": "client", "kind": "relation", "definitionPaths": [ "workspace/clients/surface/client" ], "linkTypePaths": [ "application/client" ], "queryKey": null, "required": true, "revision": "current", "priority": 1, "maximumItems": 1, "maximumCharacters": 8000 } ], "maximumCharacters": 16000 } ``` ### Variante et raccordement Fragment à placer dans `contextPolicies[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-model-foundation/). ```json { "key": "quote-knowledge", "targetDefinitionPaths": [ "workspace/quotes/surface/quote" ], "sources": [ { "key": "pricing", "kind": "knowledge", "definitionPaths": [ "workspace/knowledge/surface/pricing" ], "linkTypePaths": [], "queryKey": null, "required": true, "revision": "current", "priority": 1, "maximumItems": 3, "maximumCharacters": 12000 } ], "maximumCharacters": 16000 } ``` ### Exemple de disposition UI La disposition illustrative ci-dessous situe cette configuration dans l’app Clients/Soumissions. Chaque fragment s’insère à l’emplacement indiqué; ses références aux Fields, Queries et Actions correspondent aux déclarations du Model. 1. Objet concerné 2. Changement proposé 3. Vérifications 4. Confirmer