---
title: "Connexions"
url: https://developers.dagio.ai/fr/connections/
---

# 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](https://developers.dagio.ai/fr/runtime-profiles/) organisent le choix des capacités; les [droits](https://developers.dagio.ai/fr/permissions/) encadrent leur utilisation.

<!-- surface-examples:start -->

## 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](https://developers.dagio.ai/fr/reference/workspace-model-foundation/).

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

### Variante et raccordement

Fragment à placer dans `documentProfiles[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/managed-document-profile-v3/).

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

<!-- surface-examples:end -->