Mentionable
Mentionable

bulk_update_competitor_status

Tool MCP bulk_update_competitor_status : confirmer, rejeter ou réinitialiser des concurrents suggérés en masse (50 max par appel). Erreurs par item, rôle member requis.

Mis à jour le 2026-04-26

bulk_update_competitor_status

bulk_update_competitor_status est le seul tool d'écriture de cet ensemble. Il met à jour le statut d'un ou plusieurs concurrents en un seul appel, jusqu'à 50 par batch. Utilisez-le pour agir sur la file d'auto-détection retournée par list_competitors : confirmer les vrais concurrents, rejeter le bruit, ou remettre à SUGGESTED une entrée précédemment écartée.

Quand l'utiliser

Sortez-le quand l'utilisateur donne une instruction de modération du type "confirme tous les concurrents que je vois ici", "rejette ces trois faux positifs", ou "remets Otterly en suggested pour qu'on revoie". C'est le bon tool pour tout agent qui trie automatiquement la file de suggestions selon des règles. Combinez avec list_competitors (filtre status: ["SUGGESTED"]) pour récupérer les candidats avant l'appel.

Exige le rôle member minimum. Le rôle customer est rejeté.

Paramètres

Champ Type Description
projectId string (CUID) Projet à mettre à jour.
updates array 1 à 50 entrées.
updates[].competitorId string (CUID) Concurrent à mettre à jour.
updates[].status enum CONFIRMED, REJECTED, SUGGESTED.

Réponse

La réponse renvoie les compteurs updated/failed et un tableau results item par item. Les erreurs par item ne bloquent pas le reste du batch : les updates valides s'appliquent quand même, et success passe à false uniquement pour signaler qu'au moins un item a échoué.

{
  "success": true,
  "updated": 2,
  "failed": 0,
  "results": [
    {
      "competitorId": "clxcomp001",
      "status": "success",
      "competitor": {
        "id": "clxcomp001",
        "canonicalName": "Otterly",
        "status": "CONFIRMED",
        "updatedAt": "2026-04-26T10:15:00.000Z"
      }
    },
    {
      "competitorId": "clxcomp002",
      "status": "success",
      "competitor": {
        "id": "clxcomp002",
        "canonicalName": "Profound",
        "status": "REJECTED",
        "updatedAt": "2026-04-26T10:15:00.000Z"
      }
    }
  ]
}

Si un competitorId est invalide ou appartient à un autre projet, l'entrée renvoie status: "error" avec un message et success passe à false pour tout le batch. Les updates valides s'appliquent quand même.

Conseils et patterns

  • Lisez toujours success et le results[].status de chaque item pour détecter les échecs partiels.
  • Batchez jusqu'à la limite de 50 items pour minimiser les allers-retours. Au-delà, paginez côté agent.
  • Gérez proprement le cas d'un utilisateur customer : attrapez l'erreur de rôle et renvoyez la requête vers un membre plus privilégié.
  • Réinitialiser à SUGGESTED réinjecte le concurrent dans la file de modération ; ne l'utilisez pas comme un soft-delete.

Tools liés