update_project_settings

update_project_settings modifie les réglages d'un projet. Il en règle un seul pour l'instant : ecommerce, qui indique à Mentionable que la marque vend des produits en ligne. Il écrit le même réglage que l'interrupteur e-commerce des réglages du projet dans le dashboard.

Sur un projet e-commerce, les réponses des IA ne citent pas que des marques rivales : elles envoient l'acheteur vers un magasin (Amazon, une pharmacie, une marketplace) ou nomment un produit. L'IA trie alors chaque entité citée dans les réponses en trois groupes : marques concurrentes, revendeurs (là où l'acheteur est envoyé) et produits (noms de produits). Revendeurs et produits restent hors de la vue Concurrents, qui ne montre plus que les marques face auxquelles vous êtes vraiment en concurrence.

Quand l'utiliser

Appelez-le quand l'agent apprend que la marque vend en ligne, par exemple après avoir lu le site depuis list_projects (champs url et ecommerce) et trouvé une boutique, ou quand l'utilisateur dit « Amazon et la pharmacie du coin ne sont pas mes concurrents, ils vendent mes produits ». Coupez-le pour une marque qui ne vend pas de produits en ligne, comme une activité de services ou un SaaS.

Tool d'écriture : exige le rôle member minimum, le rôle customer est refusé.

Paramètres

Réponse

{ "success": true, "projectId": "clx0000aaa", "ecommerce": true }

La réponse renvoie la valeur désormais enregistrée sur le projet.

Fonctionnement

• L'activer retrie le passé. Les concurrents déjà jugés par l'IA sur ce projet sont triés à nouveau en arrière-plan, avec les trois groupes. Revendeurs et produits quittent alors la vue Concurrents. Il tourne après la réponse : relisez list_competitors un peu plus tard pour voir le résultat.
• Enregistrer deux fois la même valeur ne fait rien. Seul un passage de coupé à activé relance un tri.
• Le couper ne défait rien. Les entités déjà classées revendeurs ou produits gardent ce verdict. Seuls les prochains scans reviennent au tri simple, concurrent ou non.
• Seuls les verdicts de l'IA sont retriés. Les concurrents ajoutés à la main et les entités que vous avez rejetées restent en l'état. Pour en déplacer une vous-même, utilisez bulk_update_competitor_status.

Conseils et patterns

• Lisez le champ ecommerce de list_projects avant l'appel : s'il a déjà la valeur voulue, il n'y a rien à faire.
• Une fois activé, listez les revendeurs avec list_competitors et filters.verdict: ["RETAILER"], et les produits avec ["PRODUCT"].
• Corrigez un mauvais tri entité par entité avec bulk_update_competitor_status et son champ kind (COMPETITOR, RETAILER, PRODUCT).

Tools liés

• list_projects : lire la valeur ecommerce actuelle de chaque projet.
• list_competitors : concurrents, revendeurs et produits, filtrables par verdict.
• bulk_update_competitor_status : confirmer, rejeter ou reclasser des entités à la main.