← Todas las guías
En esta página
Guía Crear un producto · 02/03 Agentes de IA 12 min Intermedio

¿Cómo puede un agente de IA de póker usar MCP?

Un agente de IA puede usar el servidor MCP oficial de Pokerai solo para un escenario de entrenamiento controlado o una mano que ya ha terminado. El agente descubre las herramientas expuestas del servidor en tiempo de ejecución, valida los datos devueltos y deja la interpretación y las decisiones de alto impacto a una persona.

Actualizado Mantenido por Pokerai API

Respuesta directa: configure el servidor MCP oficial con una clave de API de Pokerai, permita que el cliente MCP descubra sus herramientas disponibles y llame solo a una herramienta cuyo esquema devuelto coincida con una tarea de mano completada o de entrenamiento. Pokerai API proporciona cartas, equity, estrategia y otros datos verificables de las herramientas; un LLM puede explicarlos u orquestarlos, pero nunca sustituir al solver. Trate cada resultado como datos fuente para una explicación revisada por una persona, nunca como consejo en vivo para dinero real.

Datos rápidos

Servidor MCP oficialgithub.com/pokerai-bet/mcp y el paquete @pokerai/mcp
AutenticaciónEl servidor MCP utiliza una clave de API de Pokerai; manténgala en el entorno del servidor, no en prompts ni en código del navegador.
Contrato de herramientasDescubre los nombres de las herramientas y los esquemas de entrada del servidor oficial en ejecución. Esta guía no presupone un nombre de herramienta no publicado ni una entrada en el registro.
FundamentaciónUsa el resultado estructurado respaldado por la API para cartas, equidad, estrategia y otros hechos documentados verificables; el texto del LLM es explicación u orquestación, no una salida del solver.
Uso permitidoFormación, coaching, revisión de manos, estudio e investigación.
No permitidoLa asistencia en tiempo real en mesas con dinero real está prohibida.

Flujo de llamadas a herramientas

Mantenga el ciclo del agente pequeño e inspeccionable. MCP transporta la solicitud de la herramienta; Pokerai API sigue siendo la fuente del resultado de la herramienta respaldado por la API.

  1. Conectar — Inicia el servidor MCP oficial utilizando su README y proporciona la clave API mediante la configuración del lado del servidor.
  2. Descubrir — Solicita al cliente MCP la lista actual de herramientas y los esquemas del servidor. No deduzcas el nombre de una herramienta a partir de esta página, la memoria de un modelo o una entrada de registro no verificada.
  3. Validar — Confirma que la solicitud procede de un escenario de entrenamiento controlado o de una mano finalizada y que es una tarea permitida de formación, revisión, estudio, coaching o investigación sin conexión; normaliza las entradas de póker proporcionadas conforme al esquema descubierto.
  4. Llamar — Llame a una herramienta detectada con los argumentos mínimos necesarios y, a continuación, conserve el resultado estructurado sin procesar y los metadatos de la solicitud en el registro de auditoría de la aplicación.
  5. Revisión — Haga que una persona revise la explicación del agente, la incertidumbre y el uso de frecuencias mixtas antes de presentar resultados educativos o de producto de alto impacto.

Bucle mínimo de agente verificable

Este es pseudocódigo de nivel de protocolo, no un nombre de herramienta declarado. Se puede verificar porque el agente primero lee la lista real de herramientas y el esquema del servidor en ejecución antes de hacer una llamada.

tools = mcp.list_tools()
selected = choose_tool(tools, task="offline preflop study")
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)

Para una forma concreta de solicitud y respuesta, usa el esquema de la herramienta descubierta junto con la instantánea de OpenAPI oficial. Si el servidor no expone una herramienta adecuada, no sustituyas una llamada HTTP supuesta ni fabriques el resultado de una herramienta.

Revisión humana y límite sin RTA

Un modelo de lenguaje puede resumir datos incorrectamente o exagerar la confianza. Exija revisión humana para las notas de estudio, el material de coaching y los resultados de productos de alto impacto; muestre las frecuencias mixtas como distribuciones en lugar de una única jugada recomendada. Pokerai API no debe usarse para asistencia en tiempo real en mesas con dinero real. No conecte el agente a una fuente de manos en vivo, automatice acciones ni presente su salida como una decisión que tomar durante el juego.

Límites de datos

  • Envíe solo las entradas de póker necesarias para la tarea de estudio seleccionada. Evite incluir claves de API, datos de la cuenta y datos personales no relacionados en las indicaciones o los argumentos de las herramientas.
  • Las solicitudes a la API de Pokerai no tienen estado; no conviertas el contenido de las manos en datos de atribución de marketing ni lo conserves durante más tiempo del que requiere el flujo de revisión de la aplicación.
  • Mantenga la clave de API y la respuesta sin procesar de la herramienta en sistemas confiables del lado del servidor. Oculte secretos e identificadores de usuario en los rastros del agente, los tickets de soporte y los ejemplos compartidos.
  • Use el contrato de API documentado como autoridad para la semántica de las entradas y las respuestas; el texto del agente es una explicación, no un sustituto de los datos de origen.

Enlaces de implementación oficial