Profils d’exécution AI

Séparer l’intention des ressources

Le Flow décrit le travail à réaliser. Le profil d’exécution décrit les ressources et contraintes applicables : capacité AI, connexion, périmètre et limites. Cette séparation permet de réutiliser l’app sans imposer les comptes d’un auteur à tous les usagers.

Paramètre	Valeurs attendues	Description
Capacité	Fonction nécessaire au travail	Texte, analyse ou autre capacité admise
Connection	Accès configuré et autorisé	Fournisseur utilisable
Ressources	Choix pris en charge par le fournisseur	Paramètres d’exécution
Résidence	Région et contraintes effectives	Frontière de traitement
Limites	Budget et politique d’usage	Encadre l’exécution

Exemple

Le Flow de préparation d’une soumission utilise le profil Rédaction commerciale. Celui-ci sélectionne une connexion autorisée, la région imposée par l’organisation et ses limites. L’usager voit pourquoi une ressource n’est pas disponible et quel réglage doit être vérifié.

Refuser une exécution incompatible

Une capacité absente, une connexion révoquée ou une région incompatible doit empêcher l’exécution concernée. Le profil ne contourne pas les droits et ne bascule pas vers un fournisseur ou une région non autorisés pour terminer le travail.

Voir Résidence des données et Usage et limites pour préparer la configuration de votre équipe.

Configurer vos ressources

Depuis les réglages du compte, ouvrez LLM Runtime, puis choisissez le compte et l’application à configurer. Les emplacements proposés correspondent aux responsabilités déclarées dans cette application ; aucune connexion ou aucun profil n’est choisi à votre place.

1. Ajoutez une Connection et choisissez son fournisseur et son mode d’authentification. Une clé personnelle se saisit uniquement dans le portail sécurisé du compte, jamais dans le chat ni dans une Surface.
2. Préparez un Profile avec une connexion précise, le modèle autorisé et vos plafonds d’entrée, de sortie, de durée et de coût. Enregistrer n’est pas une vérification du fournisseur.
3. Vérifiez la connexion pour le Profile et le modèle choisis. Si la configuration liée évolue, sélectionnez explicitement sa nouvelle révision avant de l’utiliser.
4. Rédigez les instructions du Worker et associez-lui le Profile voulu. Les budgets du compte, de votre utilisation, du Profile et du Worker encadrent ensemble l’exécution ; ils ne donnent aucun droit supplémentaire.

Une réponse de sauvegarde perdue conserve la même demande pour sa reprise. Ne créez pas une seconde configuration pour contourner une attente ; vérifiez d’abord le résultat de l’opération initiale.

Un Profile texte nouveau ou révisé est sauvegardé avec une configuration requise, même si sa Connection était déjà prête. Validez à nouveau ce Profile texte exact, puis sélectionnez explicitement sa nouvelle révision pour le Worker voulu. Les autres Profiles et Workers conservent leurs révisions originales ; Surface ne répare pas les références partagées et ne redémarre pas automatiquement l’AI.

Remplacer une clé exige une confirmation explicite. L’ancienne clé n’est jamais réaffichée. Vérifiez ensuite la connexion et sélectionnez sa nouvelle révision dans les Profiles liés. Si la réponse du remplacement manque, vérifiez le résultat de la même opération plutôt que de saisir et renvoyer la clé une seconde fois.

Examiner une proposition de texte avant de sauvegarder

Choisissez la Task, le Worker et le document, l’objet Surface, le Field texte ou la sélection exacte à assister. Examinez le plan, les sources et les limites, puis confirmez explicitement ce même plan. Surface utilise la capacité texte validée du Profile choisi ; aucun autre fournisseur n’est sélectionné et un résultat Worker structuré n’est pas transformé en texte.

Le texte en direct n’est qu’une prévisualisation temporaire. La proposition finale possède son propre résultat et son reçu ; l’accepter prépare le brouillon éditable ordinaire, sans sauvegarder automatiquement la cible ni terminer la Task. Conservez votre brouillon en cas de conflit. Cette consultation stricte exige la même révision canonique cible ; une révision modifiée n’est jamais rebasée silencieusement. Une réponse perdue se récupère depuis l’opération originale au lieu de relancer une génération.

Une demande d’annulation arrête les travaux encore autorisés, sans promettre que le fournisseur est déjà arrêté ni que l’usage réservé est remboursé. Vérifiez l’état réel de l’exécution.

Reprendre explicitement une question déléguée

Lorsqu’un Worker demande une information, son Execution attend sans terminer la Task ni enregistrer un Result d’échec intermédiaire. Si la question expire, la même Execution et la même Task restent en attente d’une reprise explicite ; l’expiration ne lance jamais automatiquement une nouvelle demande AI.

Examinez la question et confirmez sa reprise. Surface vérifie à nouveau vos permissions actuelles, l’échéance originale de l’exécution et les budgets restants. La reprise ne réinitialise pas ces limites. Si l’échéance originale de l’exécution est dépassée, un nouveau plan explicite est nécessaire ; l’ancienne réservation et l’opération ne sont pas réactivées silencieusement. Après une réponse perdue, récupérez le résultat de l’opération originale avant d’envoyer une autre réponse.

Exemples appliqués : Distinguer contexte et ressources

La politique définit les sources de l’AI et le Flow limite le travail. Le profil d’exécution se choisit dans les paramètres Surface.

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 flowBlueprints[].composition.budgets. Propriétés et valeurs admises.

{
  "maximumDepth": 2,
  "maximumOccurrences": 20,
  "maximumConcurrency": 2,
  "maximumIterations": 3,
  "maximumDurationMilliseconds": 86400000,
  "maximumCostUnits": 100,
  "maximumStateBytes": 32000
}

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. Profil d’exécution
2. Connexions
3. Résidence
4. Enregistrer

SurfaceClients / Atelier NordExemple

Profils d’exécution AIDistinguer contexte et ressources

Clients

Profil d’exécution

Profil de l’équipe

Sources requises

Client et tarifs

Budget du Flow

100