Connexions

Une connexion représente un accès

Une Connection décrit l’accès à un service ou fournisseur. Elle contient la configuration nécessaire et référence les secrets protégés. Un Model peut demander une capacité; il ne doit pas contenir les clés privées de votre compte.

Paramètre	Valeurs attendues	Description
Fournisseur	Service pris en charge	Identifie le protocole et les capacités
Compte ou endpoint	Configuration du service	Désigne la ressource utilisée
Authentification	Référence de secret ou autorisation	Donne un accès protégé
Périmètre	Utilisateurs, équipe et usages autorisés	Limite l’utilisation
Vérification	Résultat du contrôle de connexion	Distingue configuré et utilisable

Exemple

Votre équipe connecte son fournisseur AI et autorise son usage pour la rédaction des soumissions. Le profil d’exécution sélectionne cette Connection avec les contraintes de résidence et d’usage. Le Model Clients peut rester réutilisable dans une autre entreprise, qui possède ses propres connexions.

Modifier et révoquer

Changer une clé ou révoquer un accès concerne les opérations qui l’utilisent. Le diagnostic identifie la connexion à corriger; il ne sélectionne pas silencieusement un autre fournisseur. Les secrets ne sont pas copiés dans les prompts, les sources du Model ou les diagnostics publics.

Les profils d’exécution organisent le choix des capacités; les droits encadrent leur utilisation.

Exemples appliqués : Déclarer la ressource nécessaire

Le Model déclare une capacité de connexion; le profil détermine le document à produire.

Configuration

Fragment à placer dans publication. Propriétés et valeurs admises.

{
  "kind": "workspace-application",
  "license": "Propriétaire",
  "requiredCapabilities": [],
  "requiredConnections": [
    "document.export"
  ]
}

Variante et raccordement

Fragment à placer dans documentProfiles[]. Propriétés et valeurs admises.

{
  "contract": "DocumentProfile@3",
  "key": "client-quotes-export",
  "source": {
    "kind": "record-query",
    "recordProfileKey": "client",
    "queryBindingKey": "client-quotes",
    "viewKey": "quotes-table"
  },
  "exportFormats": [
    "markdown"
  ],
  "budget": {
    "maximumRows": 100,
    "maximumPages": 4,
    "maximumOutputBytes": 1000000
  }
}

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

ConnexionsDéclarer la ressource nécessaire

Clients

Connexion

Export documentaire

Capacité requise

document.export

Accès

À vérifier avant activation