Aller au contenu
SurfaceDocs
ENCommencer
DocsTravailler avec Surface

Connaissances et sources

Donner au travail et à l’AI des références utiles et traçables.

Préparer les références

Un Space Knowledge organise les informations qui servent à travailler : procédures, documentation, tarifs et décisions de référence. Ajouter un document ne suffit pas à le rendre pertinent pour toutes les tâches. Le contexte sélectionne les sources utiles à un travail précis selon les droits du lecteur.

Élément Valeur attendue Usage
Source Surface, document ou ressource reliée Retrouver l’information d’origine
Périmètre Portfolio, Workspace ou travail autorisé Éviter un contexte trop large
Section Objet ou passage pertinent Cibler les éléments nécessaires
Révision Identité de la version utilisée Examiner l’effet d’un changement

Exemple : préparer une soumission

Dans le chat local, la découverte distingue quatre portées : le manuel système Surface, vos Knowledge personnels, ceux de l’application courante et les sources associées à un Worker. Les Knowledge personnels peuvent être découverts sans ouvrir d’application. Chaque Space possède aussi ses propres Instructions; l’assistant lit les Instructions applicables et les passages utiles au besoin. Les associations d’un Worker peuvent viser un Knowledge de l’application ou un Space personnel exact. Une association ne copie aucun document et ne donne aucun droit d’accès. Les sources indisponibles sont signalées explicitement.

Reliez la procédure commerciale et le barème de services au travail de préparation. La fiche Atelier Nord apporte ses besoins; les sources apportent les règles et prix. Demandez à l’AI d’indiquer les éléments utilisés et les incertitudes au lieu de transformer une hypothèse en fait client.

Choisir vos références

Dans Connaissances, retrouvez Mes connaissances et celles Partagées avec moi. Saisissez votre recherche et lancez-la pour parcourir les connaissances accessibles du compte, y compris celles qui ne figuraient pas sur la première page. Le chargement et un problème de lecture ne signifient pas qu’aucune connaissance ne correspond. Réessayer reprend la recherche envoyée; pour rechercher le texte modifié dans le champ, lancez une nouvelle recherche.

Ouvrez une carte pour consulter ses notes, ou choisissez Utiliser par défaut pour rendre ces références disponibles à vos demandes générales. Vous pouvez désactiver ce choix sans supprimer les connaissances. Si la disponibilité personnelle ne peut pas être lue, réessayez cette lecture avant de modifier vos choix.

Pour un travail précis, choisissez Associer à…, puis le Workspace et l’option d’utilisation. Les Workspaces disponibles peuvent se charger sur plusieurs pages. Enregistrer l’association conserve votre choix pour cette destination; cela ne copie pas les notes et ne partage aucun droit. Vous devez toujours être autorisé à consulter les sources. Un accès en lecture seule aux connaissances partagées peut permettre leur usage dans vos demandes personnelles, sans vous permettre de modifier leurs notes.

Si le résultat de l’association ne peut pas être affiché, votre choix reste conservé. Réessayer reprend cette même association, pour la même destination et la même option d’utilisation. Une lecture indisponible propose d’abord de réessayer cette lecture; elle ne signifie pas que l’association est désactivée.

Vous pouvez aussi choisir une définition de Flow activée comme destination de l’association. Sélectionnez le Flow nommé et sa version exacte de Model, et non une instance de travail déjà en cours. Ses références restent distinctes des connaissances par défaut et des associations à un Workspace existant. Modifier ces références ne réécrit pas les Workspaces déjà créés à partir de ce Flow. Les droits de lecture des sources restent nécessaires : l’association ne partage aucun accès.

Les connaissances sélectionnées pour une demande à l’AI partagent une même limite de contexte. Si ce contexte est trop volumineux ou qu’une source requise ne peut pas être lue, Surface refuse la demande au lieu d’écarter silencieusement des notes ou instructions. Sélectionnez explicitement moins de connaissances ou des Entrées plus ciblées avant de faire une nouvelle demande. Les instructions requises et les droits d’accès restent applicables.

Faire évoluer une source

Pour ajouter une catégorie ou une note, choisissez l’emplacement concerné et l’action proposée. Renseignez le nom et les valeurs demandées, puis sélectionnez Continuer pour examiner la demande. Cette étape prépare la création : elle ne remplace pas sa confirmation. Le titre de l’action reste celui de votre application.

Si la préparation échoue, votre saisie reste disponible pour correction. Si une confirmation reste à vérifier, reprenez cette même demande plutôt que d’en créer une autre. Lorsque la modification est confirmée mais que la vue ne s’actualise pas, réessayez sa lecture sans répéter la création.

Dans vos connaissances, utilisez Notes, Graphe et Instructions pour consulter et organiser les contenus. Le menu des autres actions donne accès aux Suggestions : examinez la raison, ouvrez les notes sources, choisissez les améliorations utiles puis confirmez leur application. Rien n’est modifié simplement parce qu’une suggestion apparaît. Les informations avancées permettent de retrouver les versions des sources utilisées.

Pour une amélioration qui utilise une Action déclarée, choisissez explicitement l’application compatible ou les connaissances indépendantes, l’Action proposée et la note ou catégorie ciblée. Renseignez les valeurs demandées par son Form, puis examinez la modification exacte avant de confirmer. Surface ne transforme pas l’explication d’une suggestion en saisie et ne choisit pas une autre application pour vous. L’absence d’une Action compatible n’autorise pas une autre modification. Si la confirmation reste incertaine, reprenez la même demande examinée plutôt que de soumettre une nouvelle amélioration.

Si la liste des suggestions ne peut pas être lue, Réessayer reprend sa lecture sans appliquer d’amélioration. Les instructions qui ne peuvent pas être ouvertes sont indiquées comme indisponibles : elles ne sont pas remplacées par des notes vides ou inventées.

Pour gérer les personnes autorisées, ouvrez Réglages → Sécurité et accès dans les connaissances concernées. Le propriétaire consulte les accès, invite une personne, modifie un rôle ou retire un accès selon ses autorisations. Fermer les réglages puis les rouvrir conserve la saisie en cours; une demande au résultat incertain doit être reprise avant d’être modifiée. Les réglages du compte et les accès à ces connaissances restent deux portées différentes.

Quand le barème change, les travaux et résultats associés doivent être examinés. Comparez les éléments affectés, proposez des corrections ciblées et conservez les points d’approbation humaine. La mise à jour d’une connaissance ne vaut pas validation automatique de toutes les soumissions existantes.

Les liens gardent la relation; l’historique permet de comprendre la version utilisée.

Dans l’interface Knowledge V2 locale, cliquez sur le titre ou l’icône d’une catégorie pour ouvrir sa propre Surface et rédiger son résumé. Le chevron déplie indépendamment ses sous-catégories et notes. Le résumé utilise le même éditeur riche, la sauvegarde automatique, l’historique, les Tags et les liens que les notes. Les instructions AI de bibliothèque restent une configuration distincte du Model.

Le chargement d’une Surface affiche un indicateur centré en superposition sur le contenu, sans déplacer les barres ni les panneaux. La sauvegarde en arrière-plan garde le layout stable. L’indicateur d’une opération reste dans le bouton initiateur sans le redimensionner.

L’icône des instructions Knowledge ouvre les instructions dans la zone Surface principale, avec un lien de retour à la bibliothèque. Leur source reste le Model; l’icône d’édition ouvre l’Application Builder.

Le passage de Links à Graph conserve la position du graphe. Le redimensionnement du panneau conserve également le cadrage; utilisez Fit graph pour le recentrer. Les libellés suivent le zoom et le survol rend lisible celui du nœud pointé. La relecture d’une même projection s’effectue sans masquer le graphe déjà chargé; changer de projection affiche l’indicateur centré.

Les notes sont bleues, les catégories menthe et les sections indexées dorées. Un halo repère la note ouverte. Les groupes peuvent remplacer ces couleurs selon le titre ou le type; la première règle correspondante s’applique.

Les options Graph regroupent Filters, Groups, Display et Forces. Vous pouvez filtrer les éléments affichés par titre, masquer notes, catégories, sections ou éléments isolés, régler le seuil des libellés et l’épaisseur des liens. Le placement par forces expose centrage, répulsion, force et distance des liens. Rearrange relance le placement; les filtres et couleurs conservent le cadrage. Les mêmes réglages d’affichage sont accessibles dans les paramètres globaux et sont conservés sur l’appareil. Les animations respectent la préférence de mouvement réduit.

Ces filtres portent sur la projection chargée. Les Tags et pièces jointes comme nœuds du graphe et les groupes par expressions de recherche avancées restent indisponibles.

Dans l�interface Knowledge/Content locale, le menu d�un �l�ment propose Duplicate, Move, Merge et Trash. Une fusion pr�visualise le contenu r�uni et les r�f�rences concern�es; choisissez les propri�t�s � retenir en cas de conflit. Tags et liens sont r�unis, les sections prot�g�es restent prot�g�es et la source rejoint la corbeille r�versible. Restore conserve les identit�s d�origine. Glissez un �l�ment dans une cat�gorie ou avant un autre pour organiser la biblioth�que.

L�import pr�visualise les fichiers Markdown, dossiers ou archives ZIP avant cr�ation. Propri�t�s YAML, Tags, liens et pi�ces jointes sont conserv�s; les cibles manquantes ou ambigu�s sont signal�es. Exportez une branche ou la biblioth�que en ZIP avec Markdown, pi�ces jointes et manifeste Surface exact. L�import cr�e de nouveaux �l�ments sans remplacer les titres existants. La limite est de 200 �l�ments par op�ration, 20 Mio d�compress�s et 5 Mio par pi�ce jointe.

Lorsque le Model active le contenu Canvas, Add Surface crée une Surface éditable avec texte, formes, images et pages dans le workspace documentaire. Cette commande utilise le cycle de contenu Surface partagé, avec sauvegardes versionnées et historique. Les tableaux liés existants restent consultables; la création ne choisit plus un moteur de board distinct. Les imports/exports JSON Canvas et les transferts de bibliothèque conservent les limites de leurs formats déclarés.

Exemples appliqués : Préparer une soumission avec les bons tarifs

Le contexte exige le tarif de référence; la politique conserve la révision utilisée.

Configuration

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

{
  "key": "quote-knowledge",
  "targetDefinitionPaths": [
    "workspace/quotes/surface/quote"
  ],
  "sources": [
    {
      "key": "pricing",
      "kind": "knowledge",
      "definitionPaths": [
        "workspace/knowledge/surface/pricing"
      ],
      "linkTypePaths": [],
      "queryKey": null,
      "required": true,
      "revision": "current",
      "priority": 1,
      "maximumItems": 3,
      "maximumCharacters": 12000
    }
  ],
  "maximumCharacters": 16000
}

Variante et raccordement

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

{
  "key": "retained-pricing",
  "sourceDefinitionPaths": [
    "workspace/knowledge/surface/pricing"
  ],
  "linkTypePaths": [
    "application/based-on"
  ],
  "mode": "pin-revision",
  "actionKey": null,
  "queryKey": null,
  "maximumTargets": 50
}

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. Soumission S-1042
  2. Objet et besoin
  3. Proposition
  4. Références retenues
DISPOSITION ILLUSTRATIVEApp Clients / Soumissions
SurfaceClients / Atelier NordExemple
Connaissances et sourcesPréparer une soumission avec les bons tarifs
Clients
Atelier Nord · S-1042Proposition de services

Accompagner le nouveau projet du client avec une proposition précise et documentée.

Montant proposé12 500
↗ Tarifs et procédure retenus
Recherchez un concept, un champ ou une action.Esc