---
title: "Démarrage rapide"
url: https://developers.dagio.ai/fr/quickstart/
---

# Démarrage rapide

   
                         
                                                                              
                  
              
         
   

## Créer votre compte

Ouvrez le [portail de compte Surface](https://account.dagio.ai/register), indiquez votre nom,
votre adresse courriel et un mot de passe d’au moins 12 caractères, puis confirmez votre adresse
avec le lien reçu par courriel. Connectez-vous ensuite pour vérifier que votre espace est prêt.
Le compte commence avec le forfait Free, sans carte de paiement. La clé technique de votre tenant
reste interne aux services Surface; vous n’avez aucune clé à copier ou à configurer.

## 1. Créer votre espace de travail

Connectez-vous à Surface et choisissez le compte à ouvrir, même si un seul compte est proposé. Créez ensuite un Workspace à partir d’un Model. Sélectionnez une app de gestion de clients ou décrivez votre besoin à l’AI : « Je veux suivre mes clients, leurs coordonnées et les prochaines actions commerciales. » Examinez la structure proposée avant de l’utiliser.

Lorsque l'entrée **Décrire un besoin avec l’AI** est proposée par votre interface, choisissez si vous voulez trouver une app, adapter un Model autorisé ou en créer un. Précisez votre objectif et le résultat attendu. Cette demande ouvre la conversation, sans sélectionner de version ni créer de Workspace. Vérifiez les choix et les conséquences dans la revue native avant de confirmer une création ou un lancement.

Comparez les versions exactes, les entrées, les livrables et les conditions d’accès des choix disponibles. Une inspection de déclaration ou une preview n’est pas un Flow exécuté; après modification de la proposition, relisez une nouvelle preview avant de confirmer.

Nommez le Workspace **Clients** et rattachez-le au Portfolio de votre entreprise. Le Portfolio rassemble vos Workspaces et leur contexte commun. À l’intérieur de Clients, le Space Data contient les fiches; un Space Knowledge accueille vos procédures et un Space Work les suivis qui demandent plusieurs étapes.

## 2. Ajouter votre premier client

Choisissez **Nouveau client**. Le formulaire de création demande les informations nécessaires pour créer une fiche valide. Les notes de contexte et les informations complémentaires restent accessibles dans la fiche après sa création.

| Information | Valeur pour cet exemple                          | Utilisation                                |
| ----------- | ------------------------------------------------ | ------------------------------------------ |
| Entreprise  | Atelier Nord                                     | Titre de la fiche et résultat de recherche |
| Courriel    | contact@example.com                              | Coordonnée du contact                      |
| État        | Actif                                            | Filtre et indicateur visuel                |
| Notes       | Besoin d’une proposition pour l’entretien annuel | Contexte éditable dans la Surface          |

Ouvrez la fiche créée. Modifiez les notes directement sous leur titre. Utilisez **Paramètres** pour les Fields destinés à la configuration plutôt qu’au contenu principal de la fiche.

## 3. Organiser la collection

Dans la vue tableau, affichez Entreprise, Courriel, État et Dernière mise à jour. Ajoutez le filtre **État = Actif** et choisissez le tri par entreprise. La Query définit la collection recherchée; les colonnes déterminent les informations que le tableau présente.

```text
Clients
  Data → Clients actifs → Atelier Nord
  Knowledge → Procédure de qualification
  Work → Préparer le suivi d’Atelier Nord
```

## 4. Relier les soumissions

Ajoutez ensuite un Workspace **Soumissions**. Dans sa configuration d’intégration, liez le Field clientId à l’identifiant de la fiche Client. Une soumission peut maintenant sélectionner Atelier Nord avec une recherche. La fiche Atelier Nord présente les soumissions associées dans un panneau latéral.

Continuez avec les [Fields](https://developers.dagio.ai/fr/fields/) pour adapter la fiche, les [intégrations](https://developers.dagio.ai/fr/workspace-links/) pour les liens et les [Flows](https://developers.dagio.ai/fr/flows/) pour préparer une proposition avec l’AI.

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

## Exemples appliqués : Créer le premier client

Reliez la Form de création à son Action, puis ouvrez la fiche Atelier Nord après confirmation.

### Configuration

Fragment à placer dans `forms[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-model-foundation/).

```json
{
  "contract": "WorkspaceForm@2",
  "key": "new-client",
  "label": "Nouveau client",
  "actionKey": "create-client",
  "targetDefinitionPath": "workspace/clients/surface/client",
  "mode": "create",
  "fields": [
    {
      "contract": "WorkspaceFormControl@2",
      "repeatable": false,
      "key": "company",
      "label": "Entreprise",
      "input": "text",
      "binding": {
        "kind": "field",
        "fieldKey": "company"
      },
      "required": true,
      "ruleKeys": [],
      "options": []
    },
    {
      "contract": "WorkspaceFormControl@2",
      "repeatable": false,
      "key": "status",
      "label": "État",
      "input": "choice",
      "binding": {
        "kind": "field",
        "fieldKey": "status"
      },
      "required": true,
      "ruleKeys": [],
      "options": [
        "prospect",
        "active"
      ]
    }
  ],
  "ruleKeys": []
}
```

### Variante et raccordement

Fragment à placer dans `actions[]`. [Propriétés et valeurs admises](https://developers.dagio.ai/fr/reference/workspace-model-foundation/).

```json
{
  "key": "create-client",
  "label": "Créer un client",
  "targetDefinitionPaths": [],
  "kind": "semantic-command",
  "operationKey": "create-client",
  "formKey": "new-client",
  "ruleKeys": [],
  "contextPolicyKey": null,
  "minimumRole": "member",
  "confirmation": true
}
```

### 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. Entreprise *
2. État *
3. Notes
4. Créer le client

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