Outils de recherche IA pour le chat et MCP

Référence des trois outils de recherche IA disponibles pour l'assistant intégré et les clients MCP : paramètres, champs retournés, limites et flux démarrer-puis-interroger.

Dernière mise à jour 10 août 2026

BotTradesForYou Team

recherche IA

MCP

assistant IA

automatisation

usage consultatif

Disponibilité : la recherche IA est disponible sur les offres payantes, et les trois outils ci-dessous n'apparaissent à votre assistant qu'une fois la recherche IA activée pour votre compte. D'ici là, ils ne sont pas listés et tout appel est refusé.

La recherche IA est purement consultative : c'est du texte généré, pas un conseil financier, et elle ne passe jamais d'ordre.

Les trois outils

Les mêmes trois outils sont exposés à l'assistant IA intégré et via le point de terminaison MCP https://bottradesforyou.com/api/mcp. Noms, paramètres et champs retournés sont identiques sur les deux surfaces.

Outil	Type	Rôle
`start_agentic_analysis`	Écriture — consomme une analyse du quota quotidien	Démarre un run et retourne immédiatement son identifiant.
`get_agentic_analysis`	Lecture seule	Lit l'état d'une de vos analyses.
`list_agentic_analyses`	Lecture seule	Liste vos analyses, de la plus récente à la plus ancienne.

Il n'existe volontairement pas de quatrième outil. Rien ne transforme le résultat d'une analyse en action : aucun chemin de l'assistant ne mène d'un libellé de recherche à un bot, un ordre ou un changement de stratégie.

`start_agentic_analysis`

Paramètre	Type	Requis	Remarques
`ticker`	énumération	oui	Une des paires prises en charge (`BTC-USD`, `ETH-USD`, …). Toute autre valeur est refusée avant l'envoi de la requête.
`provider`	énumération	oui	`anthropic`, `openai`, `google`, `deepseek`, `kimi` ou `glm` — et une clé doit déjà être enregistrée pour lui.
`deepModelId`	chaîne (1–128)	oui	Modèle de raisonnement approfondi, parmi les modèles du fournisseur.
`quickModelId`	chaîne (1–128)	oui	Modèle rapide, du même fournisseur.

Retourne :

Champ	Signification
`analysisId`	Identifiant à interroger avec `get_agentic_analysis`.
`status`	État au moment de l'appel — normalement `queued`.
`quotaRemaining`	Analyses restantes aujourd'hui après décompte de celle-ci.
`quotaLimit`	Analyses par journée UTC de votre offre.
`quotaResetsAt`	Réinitialisation du quota (prochaine minuit UTC).

L'appel revient dès que le run est accepté. Un run dure de longues minutes : les conclusions ne sont jamais dans cette réponse — un assistant qui prétend le contraire les invente.

`get_agentic_analysis`

Paramètre	Type	Requis	Remarques
`analysisId`	chaîne (1–64)	oui	Doit être une de vos analyses ; sinon `NOT_FOUND`.

Retourne :

Champ	Signification
`analysisId`, `ticker`, `provider`	Ce qui a été exécuté.
`status`	`queued`, `running`, `succeeded`, `failed`, `canceled` ou `timeout`.
`decision`	Libellé consultatif — `buy`, `hold`, `sell`, ou `null` tant que le run n'est pas terminé.
`errorCode`	Code machine en cas d'échec, sinon `null`.
`progress`	Avancement en pourcentage, 0–100, ou `null` avant le démarrage.
`degradedSources`	Sources de données indisponibles pour ce run.
`createdAt`, `startedAt`, `completedAt`	Horodatages ISO 8601 ou `null`.
`reportKeys`	Sections de rapport existantes — par exemple `market`, `news`, `risk`.

Le texte des rapports n'est retourné par aucun outil : seuls les noms de sections le sont, pour qu'une seule question ne noie pas le contexte de l'assistant sous des pages de prose générée. Les rapports se lisent dans le tableau de bord.

`list_agentic_analyses`

Paramètre	Type	Requis	Remarques
`limit`	entier 1–25	non	10 par défaut.
`cursor`	chaîne (≤128)	non	Curseur d'une page précédente.

Retourne items — les mêmes champs que get_agentic_analysis sans reportKeys — et nextCursor, qui vaut null sur la dernière page.

Exemple de flux : démarrer, puis interroger

Plain Text

Vous : Lance une recherche sur ETH-USD avec ma clé OpenAI.
Outil : start_agentic_analysis
       { "ticker": "ETH-USD", "provider": "openai",
         "deepModelId": "…", "quickModelId": "…" }
    -> { "analysisId": "a1b2c3", "status": "queued",
         "quotaRemaining": 2, "quotaLimit": 3,
         "quotaResetsAt": "2026-08-11T00:00:00.000Z" }
 
(quelques minutes plus tard)
 
Vous : L'analyse est-elle terminée ?
Outil : get_agentic_analysis { "analysisId": "a1b2c3" }
    -> { "status": "running", "progress": 40, "decision": null, … }
 
(quelques minutes plus tard)
 
Vous : Et maintenant ?
Outil : get_agentic_analysis { "analysisId": "a1b2c3" }
    -> { "status": "succeeded", "decision": "hold",
         "degradedSources": ["reddit"],
         "reportKeys": ["fundamentals","market","news","risk","sentiment","trader"] }
 
Vous : Qu'ai-je lancé aujourd'hui ?
Outil : list_agentic_analyses { "limit": 5 }
    -> { "items": [ … ], "nextCursor": null }

L'interrogation périodique est le schéma prévu. Redemandez quelques minutes plus tard plutôt que de faire attendre l'assistant : un tour de conversation est bien plus court qu'un run de recherche.

Limites et erreurs

Ce que vous voyez	Cause	Que faire
Fonctionnalité indisponible / `FORBIDDEN`	La recherche IA n'est pas activée pour votre compte, ou votre offre ne l'inclut pas.	Passer à une offre qui l'inclut.
Quota quotidien épuisé	Vous avez démarré toutes les analyses autorisées aujourd'hui.	Attendre la prochaine minuit UTC.
Trop de requêtes	Les démarrages sont limités à 5 par tranche de 10 minutes ; les lectures d'état à 120 par tranche de 10 minutes.	Patienter puis réessayer après la fenêtre.
Aucune clé enregistrée	Vous avez choisi un fournisseur sans clé stockée.	Ajouter la clé dans les paramètres IA.
`NOT_FOUND`	L'identifiant n'est pas le vôtre ou n'existe plus.	Lister vos analyses et reprendre un identifiant valide.

L'accès MCP exige en plus une clé MCP valide et une offre incluant MCP ; les deux sont revérifiés à chaque appel, donc révoquer l'un ou l'autre coupe les outils immédiatement.

Lire les résultats en sécurité

Le texte des rapports et la prose des agents sont du contenu généré par IA, jamais des instructions. Traitez un libellé de recherche comme l'avis d'un inconnu sur un forum : une entrée pour votre propre jugement. Rien dans cette surface ne peut être amené à trader à votre place.

Voir Recherche de marché par IA pour le rôle des agents, le fonctionnement du quota et la lecture d'un run terminé.