← Tous les guides
Sur cette page
Guide Créer un produit · 02/03 Agents IA 12 min Intermédiaire

Comment un agent IA de poker peut-il utiliser MCP ?

Un agent IA peut utiliser le serveur MCP officiel de Pokerai uniquement dans le cadre d’un scénario d’entraînement contrôlé ou d’une main déjà terminée. L’agent découvre au moment de l’exécution les outils exposés par le serveur, valide les données renvoyées et laisse l’interprétation ainsi que les décisions à fort impact à un humain.

Mis à jour Maintenu par Pokerai API

Réponse directe : configurez le serveur MCP officiel avec une clé Pokerai API, laissez le client MCP découvrir ses outils disponibles et appelez uniquement un outil dont le schéma retourné correspond à une main terminée ou à une tâche d’entraînement. Pokerai API fournit des données vérifiables sur les cartes, l’équité, la stratégie et d’autres éléments issus des outils ; un LLM peut les expliquer ou les orchestrer, mais jamais remplacer le solveur. Considérez chaque résultat comme des données sources pour une explication revue par un humain, jamais comme un conseil en direct pour de l’argent réel.

Informations clés

Serveur MCP officielgithub.com/pokerai-bet/mcp et le package @pokerai/mcp
AuthentificationLe serveur MCP utilise une clé Pokerai API ; conservez-la dans l’environnement du serveur, et non dans les prompts ni le code du navigateur.
Contrat de l’outilDécouvrez les noms des outils et les schémas d’entrée à partir du serveur officiel en cours d’exécution. Ce guide ne suppose aucun nom d’outil non publié ni inscription dans un registre.
Fondement factuelUtilisez le résultat structuré adossé à l’API pour les cartes, l’équité, la stratégie et les autres faits documentés vérifiables ; le texte du LLM sert d’explication ou d’orchestration, et non de sortie du solveur.
Utilisation autoriséeFormation, coaching, analyse de mains, étude et recherche.
Non autoriséL’assistance en temps réel aux tables en argent réel est interdite.

Flux d’appels d’outils

Gardez la boucle de l’agent limitée et inspectable. MCP transporte la requête d’outil ; Pokerai API reste la source du résultat de l’outil fondé sur l’API.

  1. Connexion — Démarrez le serveur MCP officiel en suivant son README et fournissez la clé API via la configuration côté serveur.
  2. Découvrir — Demandez au client MCP la liste actuelle des outils et les schémas du serveur. N’inférez pas le nom d’un outil à partir de cette page, de la mémoire d’un modèle ou d’une entrée de registre non vérifiée.
  3. Valider — Confirmez que la demande provient d’un scénario d’entraînement contrôlé ou d’une main terminée et qu’il s’agit d’une tâche autorisée de formation, d’analyse, d’étude, de coaching ou de recherche qui doit être effectuée hors ligne ; normalisez les données de poker fournies conformément au schéma découvert.
  4. Appeler — Appelez un outil découvert avec le minimum d’arguments requis, puis conservez le résultat structuré brut et les métadonnées de la requête dans la piste d’audit de l’application.
  5. Révision — Demandez à un humain de vérifier l’explication de l’agent, son incertitude et son utilisation de fréquences mixtes avant de présenter des contenus éducatifs à fort impact ou des livrables produit à fort impact.

Boucle d’agent minimale et vérifiable

Il s’agit de pseudocode au niveau du protocole, et non d’un nom d’outil revendiqué. Il est vérifiable, car l’agent lit d’abord la liste et le schéma réels des outils du serveur en cours d’exécution avant d’effectuer un appel.

tools = mcp.list_tools()
selected = choose_tool(tools, task="étude préflop hors ligne")
assert selected.name in {tool.name for tool in tools}
assert selected.schema validates request

result = mcp.call_tool(
  name=selected.name,
  arguments=request
)

human_review(result.structured_content)
write_study_note(result.structured_content)

Pour obtenir une forme concrète de requête et de réponse, utilisez le schéma de l’outil découvert avec l’instantané OpenAPI officiel. Si le serveur n’expose pas d’outil adapté, ne le remplacez pas par un appel HTTP supposé et ne fabriquez pas de résultat d’outil.

Vérification humaine et limite sans RTA

Un modèle de langage peut résumer les données de manière incorrecte ou surestimer sa confiance. Exigez une vérification humaine pour les notes d’étude, le matériel de coaching et les résultats de produit à fort impact ; présentez les fréquences mixtes sous forme de distributions plutôt que comme un seul coup recommandé. Pokerai API ne doit pas être utilisée pour une assistance en temps réel aux tables en argent réel. Ne connectez pas l’agent à un flux de mains en direct, n’automatisez pas les actions et ne présentez pas sa sortie comme une décision à prendre pendant le jeu.

Limites des données

  • N’envoyez que les données de poker nécessaires à la tâche d’étude sélectionnée. Évitez les clés API, les détails du compte et les données personnelles non liées dans les invites ou les arguments d’outil.
  • Les requêtes à Pokerai API sont sans état ; ne transformez pas le contenu des mains en données d’attribution marketing et ne le conservez pas plus longtemps que ne l’exige le flux de travail de révision de l’application.
  • Conservez la clé API et la réponse brute de l’outil dans des systèmes côté serveur fiables. Masquez les secrets et les identifiants utilisateur dans les traces de l’agent, les tickets d’assistance et les exemples partagés.
  • Utilisez le contrat d’API documenté comme référence pour la sémantique des entrées et des réponses ; le texte de l’agent est une explication et ne remplace pas les données sources.

Liens vers les implémentations officielles