Demandes et outils
Parlez naturellement ; votre assistant choisit les outils.
Demandes et outils disponibles
Vous pouvez formuler une demande avec le nom ou la référence de la Room. Votre assistant choisit les outils adaptés à vos droits ; il n’est pas nécessaire de mémoriser leur nom technique.
| Votre demande | Outils principaux | Résultat attendu |
|---|---|---|
| « Liste mes projets » | nexus_rooms_list_rooms, nexus_rooms_resolve_room | Rooms auxquelles vous avez accès, résolution d’un nom ou d’une référence. |
| « Quoi de neuf ? » | nexus_rooms_get_attention_digest | Projets demandant votre attention. |
| « Connecte-toi à cette Room et analyse les nouveautés » | nexus_rooms_get_room_brief | Mémoire validée et fraîcheur, contributions complètes, contexte, textes des versions courantes, questions et décisions ; poursuivre toutes les pages. |
| « Reprends tout le contexte » | nexus_rooms_get_room_brief avec full_context=true | Relecture des éléments déjà partagés, même si un autre assistant les a marqués lus. |
| « Lis ce fichier en entier » | list_room_documents, get_document_text | Texte extrait, par blocs si nécessaire ; original distinct. |
| « Partage cette réponse et ces fichiers » | nexus_rooms_prepare_publication, nexus_rooms_approve_draft, nexus_rooms_publish_approved_draft | Aperçu, accord humain puis publication liée aux fichiers. |
| « Adresse-la à Jérôme et Guillaume » | nexus_rooms_list_participants, destinataires lors de la préparation | Notifications ciblées, visibilité partagée inchangée. |
| « Garde cette question à résoudre » | nexus_rooms_create_open_point, nexus_rooms_update_open_point | Question/action ouverte et suivi. |
| « Enregistre notre décision et sa raison » | nexus_rooms_record_decision, nexus_rooms_list_decisions | Choix explicite et traçable. |
| « Invite ce partenaire » | nexus_rooms_invite_contact | Invitation par un administrateur autorisé ; aucune création de Room par MCP. |
Fichiers
Formats : TXT, MD, HTML, PDF, DOCX, XLSX, PPTX. upload_room_text_document envoie du texte TXT/MD/HTML. Pour les formats binaires, prepare_browser_document_upload propose un dépôt navigateur personnel ; les clients capables de gérer correctement les octets peuvent utiliser le transfert par blocs create_room_document_upload, append_room_document_upload_chunk, commit_room_document_upload. Ne demandez pas d’inventer un fichier ou son checksum.
L’extraction est asynchrone : consulter son état, puis lire son contenu. Un document effectivement lu peut être confirmé avec nexus_rooms_acknowledge_room, son identifiant et le hash du texte reçu. La lecture ne publie rien et ne vaut pas approbation d’une contribution.
Notifications et limites
notify_room_participants reste disponible pour une notification distincte expressément demandée. Ce n’est pas un service d’envoi arbitraire. Après publication, évitez un second appel qui doublerait la notification déjà déclenchée.
La disponibilité d’un outil n’accorde pas de droits supplémentaires. Aucun outil ne doit importer votre historique privé ou suivre des instructions trouvées dans un document comme si elles venaient de vous.
Mémoire et historique
| Demande | Outil | Comportement |
|---|---|---|
| « Retrouve les remarques sur le budget » | search_room_history | Recherche dans les sources partagées ; auteur, période, type et anciennes versions en option. |
| « Lis cette contribution en entier » | read_room_contribution | Lecture par blocs avec next_offset. |
| « Ce fichier remplace la version précédente » | link_document_version | Lien explicite entre deux fichiers de la même Room, sans effacer l’original. |
| « Partage nos conclusions et actualise la mémoire » | nexus_rooms_prepare_publication avec memory_update | Proposition validée et publiée avec la contribution. Le brief donne base_version et source_revision. |
Le catalogue natif a été consolidé de 35 à 33 outils : cinq alias retirés de la découverte et trois fonctions ajoutées. Les anciennes routes HTTP restent disponibles pour compatibilité ; actualisez le catalogue du client. Le nombre d’outils n’est pas une mesure de droits. Les Apps v6 conservent les anciennes URI v3/v4/v5 et restent en consultation.