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 choisit les ressources et contraintes applicables; le Flow 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 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.

{
  "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.

{
  "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

SurfaceClients / Atelier NordExemple

Travailler avec l’AIUne proposition fondée sur le contexte

Clients

AN

Atelier NordSoumission S-1042

À revoir

Changement proposé

L’AI reçoit le client et les sources requises, dans les bornes de la politique du Model.

Données et références

Client · Besoin · Tarifs

RevenirExaminer puis confirmer