DEV Community

Cover image for Comment confier du travail osFoundry à un chat Claude lié
BBT for BBT Français

Posted on

Comment confier du travail osFoundry à un chat Claude lié

À la fin, l'une de vos conversations Claude aura un identifiant de lien dans osFoundry. Vous saisissez une tâche dans osFoundry, ouvrez ce chat Claude, dites « vérifie tes tâches osFoundry », et Claude prend la tâche, la réalise et renvoie la réponse. osFoundry montre la tâche passer de « Waiting for Claude » à « Claimed by host chat » puis à « Completed », avec le résultat en dessous. Aucune clé d'API Anthropic n'apparaît nulle part dans cette configuration. Le raisonnement vient de la conversation Claude que vous payez déjà.

Qui fait quoi

Côté Claude Côté osFoundry
Détient votre connexion Claude et la conversation elle-même Détient votre connexion osFoundry, votre espace de travail et vos projets
Se connecte une seule fois à osFoundry via le connecteur personnalisé (OAuth) Délivre la connexion et décide quels projets elle peut voir
Appelle link_current_chat, read_linked_chat_tasks, claim_linked_chat_task et submit_linked_chat_result quand vous le lui demandez Enregistre la tâche, la prise en charge et le résultat, et vérifie l'accès au projet à chaque appel
Raisonne, dans la conversation Affiche l'état de la tâche et vous permet d'annuler
Ne commence à travailler que lorsque vous ouvrez le chat et le lui demandez N'ouvre, ne liste et ne lit jamais vos conversations Claude

C'est la dernière ligne qui conditionne tout le reste. Un serveur MCP peut répondre à des appels d'outils. Il ne peut pas lancer un tour dans la conversation Claude personnelle de quelqu'un, et Claude n'a pas de déclencheur d'événements général qui le permettrait. Le passage de relais est donc une boîte aux lettres : osFoundry y dépose la tâche, et le chat Claude la vide quand vous le lui dites.

Configuration

  1. Dans osFoundry, cliquez sur l'icône de clé et ouvrez l'onglet « Connected ». Sous « Assistant », choisissez Claude, saisissez un nom d'affichage (par exemple « Research assistant ») et cliquez sur « Add assistant » (ajouter un assistant). Le panneau affiche une « Server address » avec un bouton Copy. Sur la version de production, cette adresse est :
   https://api.osfoundry.io/api/v1/external-mcp
Enter fullscreen mode Exit fullscreen mode

L'onglet Connected après Add assistant, avec l'adresse du serveur et une connexion en attente

Exemple : L'onglet Connected après Add assistant, avec l'adresse du serveur et une connexion en attente

  1. Dans Claude, allez dans Customize > Connectors, cliquez sur « + Add », puis sur « Add custom connector ». Donnez-lui un nom, collez l'adresse du serveur, cliquez sur « Continue » et connectez-vous à osFoundry lorsque c'est demandé. Sur les offres Team et Enterprise, un propriétaire ajoute d'abord le connecteur dans Organization settings > Connectors, puis les membres cliquent sur « Connect ».

  2. De retour dans osFoundry, sélectionnez la nouvelle connexion. Sous « Projects », choisissez un projet et cliquez sur « Add to project ». Jusqu'à cette étape, la connexion ne voit rien, et c'est voulu : une conversation Claude qui n'est pas dans un projet n'a aucune tâche à prendre et aucune donnée à lire.

La connexion ajoutée à un projet, avec son chat lié en dessous

Exemple : La connexion ajoutée à un projet, avec son chat lié en dessous

  1. Ouvrez la conversation Claude à laquelle vous voulez confier du travail. Activez-y le connecteur (le bouton « + » en bas à gauche, puis « Connectors ») et demandez :
   Use osFoundry to link this chat to my project as an agent.
Enter fullscreen mode Exit fullscreen mode

Claude appelle link_current_chat avec le projet et un libellé. Dans osFoundry, le chat apparaît désormais sous « Linked chats » avec son libellé, le nom du projet, « Project access active » et un « Link ID ». Chaque conversation a son propre lien, vous pouvez donc lier un deuxième chat pour un autre type de travail.

  1. Dans osFoundry, cliquez sur « Tasks » à côté du chat lié. Rédigez le travail dans « Task for this chat » et cliquez sur « Assign task ». La tâche affiche « Waiting for Claude », une heure d'expiration 24 heures plus tard et un bouton « Cancel ». La même boîte de réception se trouve aussi sur la page de l'agent connecté dans Message, sous « Work with a linked chat » et « Send work to ».

Une tâche assignée au chat lié, en attente de Claude

Exemple : Une tâche assignée au chat lié, en attente de Claude

  1. Ouvrez le chat Claude et demandez-lui de vérifier ses tâches de chat lié osFoundry. C'est le déclencheur. Tant que vous ne l'avez pas fait, rien ne se passe côté Claude.

Une exécution réelle

La transcription ci-dessous est un exemple. Les noms des outils et les champs des arguments sont ceux du connecteur ; les identifiants, le texte de la tâche et la réponse sont illustratifs.

Exemple

Vous :   Vérifie tes tâches de chat lié osFoundry et fais ce qui est en attente.

Claude → read_linked_chat_tasks   { "chat_link_id": "5b1e…a07" }
       ← [ { "id": "c39d…41f", "status": "queued",
             "goal": "Lis la note de lancement de ce projet et liste chaque
                      question ouverte, une par ligne." } ]

Claude → claim_linked_chat_task   { "chat_link_id": "5b1e…a07", "task_id": "c39d…41f" }
       ← { "claim_id": "e8a2…9c0", … }

         (Claude lit la note via le connecteur et rédige la liste)

Claude → submit_linked_chat_result { "chat_link_id": "5b1e…a07", "task_id": "c39d…41f",
                                     "claim_id": "e8a2…9c0", "status": "completed",
                                     "result": "1. Qui valide le texte des tarifs ?\n2. …" }
       ← { "ok": true }

Claude : C'est fait. J'ai trouvé quatre questions ouvertes dans la note de
         lancement et je les ai renvoyées à osFoundry.
Enter fullscreen mode Exit fullscreen mode

Dans osFoundry, la carte passe de « Waiting for Claude » à « Claimed by host chat », puis à « Completed ». Dépliez « Result » pour lire le texte. Si Claude a aussi joint un fichier, « Show returned files » l'affiche avec son type et sa taille.

Deux détails du contrat des outils méritent d'être connus. Prendre deux fois la tâche depuis le même chat renvoie la même prise en charge tant que la tâche est active, donc un tour Claude qui réessaie ne crée pas un second exécutant. Et un envoi porte l'identifiant de prise en charge, si bien qu'une réponse ne peut atterrir que sur la tâche pour laquelle elle a été prise.

Où passe la limite

osFoundry ne voit pas votre conversation Claude. Le libellé et la référence de conversation sont ce que Claude déclare au moment du lien ; le panneau le précise (« Labels are self reported »). Ce que Claude reçoit, c'est ce que la carte de la tâche liste sous « Shared with this linked chat » : le texte de la tâche, plus les images ou actions d'éditeur jointes à cette tâche.

Claude n'obtient pas votre espace de travail. Chaque prise en charge et chaque résultat sont vérifiés par rapport à la connexion OAuth et au projet auquel appartient le lien. Retirez la connexion du projet et la boîte de réception cesse de charger ses tâches ; « Unlink » retire un chat ; « Revoke connection » les arrête tous.

Claude ne peut pas exécuter d'actions osFoundry de sa propre autorité. Quand une tâche propose des actions d'éditeur, Claude ne peut demander que celles qui sont proposées, et osFoundry les exécute selon ses permissions et approbations existantes.

Le travail est borné. Une tâche contient jusqu'à 100 000 caractères, un résultat jusqu'à 20 000, les fichiers renvoyés jusqu'à 8 Mio chacun et 8 par tâche, et une tâche non prise ou non terminée expire au bout de 24 heures. Une tâche que vous annulez ne peut plus être terminée ensuite, même par un tour Claude qui travaillait déjà dessus.

Et c'est vous qui choisissez le moment. Comme Claude n'a pas de déclencheur d'événements pour cela, une tâche attend que vous ouvriez le chat. Le panneau le dit clairement quand aucun abonnement n'est actif : « Open the host conversation to start each task. »

Ensuite, essayez une tâche qui renvoie un fichier plutôt que du texte, par exemple un court brief en Markdown : demandez à Claude de le téléverser avant l'envoi, puis ouvrez « Show returned files » sur la carte terminée. Pour voir comment les agents osFoundry utilisent les mêmes outils dans l'application, consultez les agents dans osFoundry ; le protocole du connecteur lui-même est expliqué dans ce qu'est MCP.

Top comments (0)