classify_thread · Documentation Subagent

Ajoute ou retire les tags d’une conversation (labels remplace la liste complète), archive ou restaure le fil, marque les messages reçus comme lus ou non lus.

En bref

Propriété	Valeur
Titre	Classer une conversation
Outil MCP	`classify_thread`, sur `https://api.subagent.fr/mcp`
Appel HTTP	`POST https://api.subagent.fr/v1/classify_thread`
Accès	permission `send` ou `approve`
État de l’espace	vérifié ou non
Effet	écriture
Vue dans l’assistant	oui : voir Vues

Ce que fait l’outil

Le serveur décrit l’outil ainsi à l’agent qui se branche :

Ajoute ou retire les tags d’une conversation (labels remplace la liste complète), archive ou restaure le fil, marque les messages reçus comme lus ou non lus. Ne modifie ni les messages, ni les blocages, ni leur statut de livraison.

Paramètres

classify_thread accepte ces paramètres. Un paramètre inconnu est refusé avec le code invalid_argument.

Paramètre	Type	Obligatoire	Description
`thread_id`	identifiant `thr_…`	oui	Conversation à classer.
`labels`	liste	non
`archived`	booléen	non	Archiver ou restaurer.
`read`	booléen	non	Marquer comme lu ou non lu.

Résultat

L’outil rend un texte lisible en français et un objet structuré (structuredContent). En HTTP, la réponse est cet objet.

Champ	Type	Contenu
`thread`	objet	Un fil. Voir les champs d’un fil.

Exemple d’appel

Les valeurs sont fictives.

HTTP

curl -X POST https://api.subagent.fr/v1/classify_thread \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "thread_id": "thr_b81f4c6a2d9e47035c1a8e6f0b4d2c97",
  "labels": [
    "devis"
  ],
  "archived": false
}'

MCP · tools/call

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "classify_thread",
    "arguments": {
      "thread_id": "thr_b81f4c6a2d9e47035c1a8e6f0b4d2c97",
      "labels": [
        "devis"
      ],
      "archived": false
    }
  }
}

Refus possibles

Aucun refus propre à cet outil. Restent les refus communs à tous les outils (unauthorized, forbidden, invalid_argument, rate_limited, internal) : voir Erreurs.

`classify_thread`