Introduction
Comprendre Surface et choisir le bon point de départ.
Construire autour du travail
Surface réunit les connaissances, les données et le travail nécessaire pour obtenir un résultat. Vous composez une app à partir de Workspaces, de fiches et de vues; vous reliez ensuite les informations et les Actions qui font avancer votre activité. L’AI travaille dans ce même contexte, avec vos permissions et des résultats que vous pouvez examiner.
Cette documentation suit une entreprise qui gère ses clients, prépare des soumissions et fait approuver ses propositions. L’exemple évolue au fil des guides : une base Clients devient un ensemble de Workspaces reliés, puis un processus de travail. Les mêmes principes s’appliquent à un projet de recherche, un produit logiciel ou un manuscrit.
Deux accès au même travail
Dans votre navigateur, l’application Surface sur app.dagio.ai vous permet de retrouver vos Workspaces, d’éditer vos Surfaces et de travailler avec l’AI. Dans un hôte AI compatible, Surface présente les mêmes contenus à côté de sa conversation native. Vous utilisez le même compte Dagio et retrouvez les modifications enregistrées dans les deux accès, selon vos permissions.
La conversation de l’application web et celle de votre hôte AI restent distinctes. Le contenu sauvegardé dans Surface conserve le travail : changer d’interface ne crée pas une copie de votre Workspace. Les conflits, les droits et les règles de collaboration continuent de s’appliquer. Le guide Travailler avec l’AI explique le contexte et la revue des modifications.
Cache de l’appareil
Settings s’ouvre en pleine page : navigation à gauche et colonne de contenu centrée avec des groupes de réglages bordés à droite.
Ouvrez Settings → Storage & cache pour activer ou désactiver le cache et choisir Cache size. La désactivation est déconseillée : les contenus sont téléchargés de nouveau à leur ouverture. Ces réglages s’appliquent globalement à votre compte sur cet appareil. Le préchargement inclut les descendants du Space ; les liens vers d’autres Spaces ne déclenchent pas de téléchargements supplémentaires. Pour Knowledge et Content, les listes de dossiers sont préparées avant les contenus des Surfaces. Si le Space propose Graph, son graphe global est aussi préparé. Les vues locales filtrées restent à la demande. La progression indique la préparation du Graph, le nombre de dossiers préparés, puis les téléchargements de contenus. À la réouverture, les contenus valides du cache sont réutilisés ; seuls les contenus manquants ou modifiés sont téléchargés. La progression distingue les contenus déjà en cache des nouveaux téléchargements. Les fiches Data sont incluses même sans contenu documentaire. Quitter un Space arrête sa file de préchargement ; y revenir réutilise les contenus valides. Après une panne temporaire de connexion, les téléchargements peuvent reprendre une fois l’accès rétabli. Une pause explicite reste active.
Des titres de section apparaissent au-dessus des groupes bordés. Sous l’utilisation, View details affiche une ligne par Space : taille, statut, activité et action Clear. Le nettoyage global ou par Space demande confirmation et protège les Spaces ouverts et les modifications non sauvegardées. Fermez un Space avant de vider ses téléchargements. Si les données protégées dépassent la taille choisie, les téléchargements s’arrêtent. L’emplacement reste géré par le navigateur ; choisir un dossier local n’est pas pris en charge par le moteur de stockage actuel. Vider le cache local conserve les données sauvegardées sur le serveur et l’historique. L’accès au cache exige toujours les droits courants ; il ne constitue pas une copie hors ligne indépendante.
Choisir votre parcours
| Votre objectif | Point de départ | Ce que vous obtenez |
|---|---|---|
| Utiliser votre première app | Démarrage rapide | Une fiche client et une première vue |
| Adapter les informations et les écrans | Models | Une structure d’app cohérente |
| Faire communiquer deux apps | Intégrations | Une sélection de client et ses soumissions liées |
| Automatiser un travail | Flows | Des étapes, un résultat et un suivi |
| Générer ou vérifier des sources | Référence du Model | Champs, valeurs, variantes et contraintes |
Une définition commune
Le Model est la définition de votre app. Il décrit les objets, leurs Fields, les vues, les Actions et les règles. Le Studio et l’AI utilisent cette définition commune : une modification proposée par l’AI reste visible et vérifiable dans les mêmes outils que vos propres modifications.
Les interfaces Surface présentent les Fields, les contenus et les résultats de Queries définis par le Model. Leurs commandes déclenchent les Actions de l’app, avec les permissions correspondantes. Un bouton visible ne donne jamais à lui seul le droit d’exécuter l’opération correspondante.
Lire, essayer, réutiliser
Les guides expliquent un usage complet. Les tableaux donnent les choix et les valeurs attendues. Les exemples situés dessous montrent leur assemblage dans la même app Clients/Soumissions. La référence des composants Surface détaille les éléments disponibles pour vos vues. Le bouton Copier et les versions Markdown facilitent l’utilisation des pages avec votre AI.
Exemples appliqués : Votre environnement Clients/Soumissions
Une app rassemble un accueil, des fiches et les actions qui font avancer le travail.
Configuration
Fragment à placer dans homePresentation. Propriétés et valeurs admises.
{
"contract": "WorkspaceHomePresentation@1",
"header": {
"intro": "Clients et soumissions",
"primaryNavigation": {
"destinationKey": "clients",
"label": "Ouvrir les clients"
}
},
"launchers": {
"title": "Faire avancer le travail",
"description": "Choisissez une action",
"icons": [
{
"actionKey": "create-client",
"icon": "users"
},
{
"actionKey": "prepare-quote",
"icon": "document"
}
]
},
"blocks": [
{
"kind": "section",
"sectionKey": "recent-quotes",
"variant": "collection",
"placement": "main",
"maximumVisible": 4,
"viewAll": {
"destinationKey": "quotes",
"label": "Toutes les soumissions"
}
}
]
}Variante et raccordement
Fragment à placer dans presentation.recordProfiles[]. Propriétés et valeurs admises.
{
"key": "client",
"definitionPaths": [
"workspace/clients/surface/client"
],
"editActionKey": "edit-client",
"identity": {
"title": {
"kind": "field",
"fieldPath": "fields/company"
},
"avatar": {
"kind": "initials",
"maximumLetters": 2
},
"subtitle": {
"kind": "field",
"fieldPath": "fields/status"
}
},
"valueLabels": [
{
"fieldPath": "fields/status",
"values": [
{
"value": "prospect",
"label": "Prospect"
},
{
"value": "active",
"label": "Actif"
}
]
}
],
"card": {
"summary": {
"kind": "field",
"fieldPath": "fields/notes"
},
"tags": {
"namespace": "user",
"maximumVisible": 3
},
"metricKeys": [],
"openLabel": "Ouvrir le client"
},
"queryBindings": [],
"metrics": [],
"detail": {
"primaryActionKey": null,
"creationActionKeys": [],
"actionKeys": [],
"sections": [
{
"kind": "fields",
"key": "follow-up",
"label": "Suivi du client",
"fieldPaths": [
"fields/notes",
"fields/status"
]
}
],
"settings": {
"fieldPaths": [
"fields/email"
]
},
"tags": {
"namespace": "user",
"maximumVisible": 3
},
"relatedGroups": [],
"primaryActionLabel": null
}
}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.
- Clients · Data
- Références · Knowledge
- Préparation · Work
- Soumissions · Product
Fiches et informations de référence
Tarifs, procédure et sources
Étapes, décisions et résultats
Livrable durable et ses révisions