La API Enterprise de Pokee es una API REST que ejecuta un agente de IA de formato largo dentro de un sandbox dedicado y persistente para cada cliente. Creas una sesión, envías un mensaje y lees la respuesta del agente como un flujo de Server-Sent Events (SSE). Las sesiones pueden contener archivos, habilidades personalizadas, tus propias herramientas y memoria que se conserva entre sesiones. El acceso es mediante una solicitud de demo de Pokee, no mediante registro autoservicio.
A continuación: cómo funcionan las sesiones y los flujos, tu primera llamada, los precios de Pokee Isaac, los límites y cómo dejar que un agente de programación pruebe los endpoints con Apidog CLI. Cada cifra proviene de la documentación de Pokee, consultada el 28 de octubre de 2026.
¿Qué es la API Enterprise de Pokee?
La API Enterprise de Pokee (Pokee la llama la API Enterprise Responses) te permite ejecutar flujos de trabajo dirigidos por agentes que tardan minutos, no segundos. Cada inquilino obtiene un espacio de trabajo privado, un token bearer estable y su propio subdominio, https://your-tenant.enterprise.pokee.ai. Dentro de ese espacio de trabajo, cada sesión es un proceso de agente en su propio sandbox.
Una llamada de chat responde a un prompt y olvida. Una sesión de Pokee conserva su conversación, archivos y estado de ocupado, por lo que el agente puede investigar, escribir archivos y llamar herramientas a lo largo de muchos turnos. Si has leído nuestra guía sobre Claude Managed Agents, la forma te resultará familiar: el proveedor aloja el bucle del agente y el sandbox, y tú lo controlas vía HTTP.
Está diseñada para equipos que quieren un agente alojado con aislamiento por inquilino y controles de red empresariales (listas de IP permitidas, mTLS, AWS PrivateLink, fijación de región), que Pokee indica como disponibles bajo solicitud.
Conceptos clave: sesiones, archivos, habilidades y memoria
La API tiene cuatro bloques de construcción.
| Concepto | Endpoint | Qué te ofrece |
|---|---|---|
| Sesiones | POST /v1/sessions |
Un proceso de agente por sesión, con su propio historial, alcance de archivos y modelo |
| Archivos | /v1/sessions/{id}/files/{path} |
Sube, descarga, lista y elimina archivos del espacio de trabajo (unos 100 MB por subida) |
| Habilidades | POST /v1/skills/{name} |
Instala un paquete zip con un SKILL.md en su raíz; se aplica a las nuevas sesiones |
| Memoria | .pokee/*.md, .memory/MEMORY.md |
Instrucciones del inquilino añadidas al prompt del sistema, más memoria entre sesiones |
Algunos detalles de las sesiones importan desde el principio:
- Persistencia. Por defecto
persistentesfalse, y la sesión se destruye a sí misma 5 minutos después de su última respuesta. Configúralo comotruepara mantener la sesión hasta que se agote suttl(por defecto 14.400 segundos, o 4 horas) o la elimines. - Bloqueo de modelo. El
modelque pasas en el momento de crear la sesión se aplica a todos los turnos de esa sesión. - Alcance de archivos. Pasa
file_accesscon listas de rutas dereadywritepara restringir lo que ve el agente; la API de archivos HTTP devuelve403fuera de ese alcance. - Un turno a la vez. Enviar un segundo mensaje mientras un turno se está ejecutando devuelve
409 Conflict.
Cómo hacer tu primera llamada a la API de Pokee
Pokee te entrega dos valores por fuera de banda: la URL de tu inquilino y una clave con la forma pk_<tenant>_<token>. Después, la primera llamada requiere tres pasos.
- Comprueba que la pasarela está activa (no se necesita autenticación).
- Crea una sesión y guarda su
id. - Publica un mensaje y lee el flujo SSE.
export POKEE_API="https://your-tenant.enterprise.pokee.ai"
export POKEE_KEY="pk_<tenant>_<token>"
curl "$POKEE_API/health"
SID=$(curl -s -X POST "$POKEE_API/v1/sessions" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: application/json" \
-d '{"persistent": true}' | jq -r '.id')
curl -N -i -X POST "$POKEE_API/v1/sessions/$SID/messages" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: application/json" \
-d '{"message": "Summarize the files in my workspace in three bullets."}'
El flag -i imprime las cabeceras. Guarda X-Response-Id (msg_ más 24 caracteres hexadecimales): lo necesitas para reanudar o cancelar el turno.
Cada evento tiene tres líneas, id:, event: y data:. Verás message.created, luego fragmentos text.delta (además de eventos thinking.* o tool_use.*), y el flujo termina con message.completed, message.cancelled o message.error. Si SSE es nuevo para ti, la guía de Server-Sent Events de MDN explica el formato, y nuestro artículo sobre probar APIs de LLM que transmiten por SSE muestra cómo leer los fragmentos.
Llamada a herramientas: dos superficies
Pokee ofrece al agente dos formas de llamar a tus funciones, ambas usando definiciones de función al estilo de OpenAI.
/v1/responses sin estado |
Herramientas de sesión | |
|---|---|---|
| Bucle del agente | Ninguno, un único viaje de ida y vuelta de inferencia | Sesión de agente completa con habilidades y archivos |
| Estado | Envías el historial completo en cada llamada | El servidor mantiene la conversación |
| Cómo aparece una llamada | Un elemento function_call en output[] |
Un evento SSE tool_call.requested a mitad del flujo |
| Cómo continúas | Nueva llamada con un elemento function_call_output |
POST /v1/sessions/{id}/tool_results |
La ruta sin estado es la que debes elegir cuando estás sustituyendo Pokee detrás de código escrito para la API Responses de OpenAI, porque la forma en el cable coincide. Acepta hasta 128 herramientas por solicitud, nombres de herramientas de hasta 64 caracteres y descripciones de hasta 16 KiB. También acepta reasoning.effort (minimal, el valor por defecto, mantiene desactivado el pensamiento extendido; low, medium y high lo activan). La salida por defecto es de 4.096 tokens, con un tope de 32.000.
Las herramientas de sesión encajan cuando el agente debe razonar, ejecutar habilidades y, a veces, llamar a tus sistemas en el mismo turno. Las registras al crear la sesión.
Reanudar, cancelar y claves de idempotencia
Los turnos largos se rompen de formas que las llamadas cortas no. Pokee añadió tres soluciones el 4 de mayo de 2026, según su registro de cambios.
- Reanudar. Si tu cliente se cae a mitad del flujo, el agente sigue ejecutándose. Reconéctate a
GET /v1/sessions/{id}/responses/{rid}/eventscon una cabeceraLast-Event-IDy el servidor reproducirá desde el siguiente evento. Los turnos cerrados permanecen disponibles durante 120 segundos, y reanudar no vuelve a facturar tokens. - Cancelar.
POST /v1/sessions/{id}/responses/{rid}/canceldevuelve202y el flujo termina conmessage.cancelled. El uso parcial en un turno cancelado no se factura. La sesión y sus archivos siguen vivos. - Claves de idempotencia. Envía
Idempotency-Key: <uuid>en el POST del mensaje. Un reintento con la misma clave y cuerpo devuelve el ID de respuesta original en lugar de iniciar un segundo turno. Las claves viven 24 horas, y la misma clave con un cuerpo diferente devuelve422.
La ruta sin estado /v1/responses admite las tres cuando stream es true.
Modelos y precios de Pokee Isaac
Pokee publica dos niveles de Isaac en su página de modelos y precios. Los precios son por millón de tokens.
| Modelo | Entrada | Salida | Lectura de caché |
|---|---|---|---|
pokee-isaac-high-reasoning |
$3 | $15 | $0.30 |
pokee-isaac |
$0.30 | $5 | $0.10 |
Los nuevos inquilinos usan pokee-isaac-high-reasoning por defecto cuando omites model. Los backends de Kimi, GPT-5.5 y Gemini están disponibles por inquilino según contrato. La documentación no indica un nivel gratuito ni un contrato mínimo; pregúntale a Pokee por esas condiciones.
También existe una API Direct Isaac, añadida el 7 de agosto de 2026: una ruta POST /v1/chat/completions compatible con OpenAI, sin bucle de agente ni herramientas. Se habilita por inquilino, acepta solo pokee-isaac y enruta automáticamente las solicitudes largas (200.000 y 2.000.000 de tokens y más) a grupos de contexto más grandes. GET /v1/usage muestra tu saldo de créditos.
Una nota de seguridad de la documentación: el bearer del inquilino es una clave de API directa. Mantenla en tu servidor o detrás de tu propio proxy, nunca en código de navegador, móvil o escritorio.
Límites y códigos de error
Estos son los valores por defecto de la página de límites y errores. Pokee dice que puede elevar cualquiera de ellos bajo solicitud.
| Límite | Valor por defecto |
|---|---|
| Sesiones concurrentes | 10 |
| Tiempo de espera de turno | 90 minutos |
| TTL de sesión | 4 horas |
| Turnos por hora / por día | 300 / 5.000 |
| Tokens por hora / por día | 20M / 200M |
| Subida máxima | Unos 100 MB por llamada |
| Espacio de trabajo máximo | 100 GB |
Los códigos de error que manejarás con más frecuencia: 401 (clave incorrecta o ausente), 402 (sin créditos, solo en modo de crédito estricto), 403 (ruta fuera del alcance de la sesión), 409 (sesión ocupada), 422 (clave de idempotencia reutilizada con un cuerpo diferente), 429 (límite de uso) y 500 (reintentar con retroceso exponencial). Los errores se devuelven como {"error": "<name>", "message": "<detail>"}.
Deja que tu agente de programación pruebe la API de Pokee con Apidog CLI
Una API de sesiones tiene mucho contrato que fijar: 201 al crear, un ID sess_, 409 mientras está ocupada, 204 al eliminar, 202 al cancelar. Tu agente de programación puede escribir y ejecutar esas comprobaciones mientras tú sigues trabajando. Apidog CLI da a Claude Code, Codex o Cursor los comandos para hacerlo.
Configúralo una vez:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install
Luego dale a tu agente un solo prompt:
Write an OpenAPI file for the Pokee Enterprise API endpoints /health,
POST/GET/DELETE /v1/sessions, /v1/sessions/{id}/responses/{rid}/cancel and
/v1/usage, import it into Apidog project <projectId>, create an environment
for my tenant URL, then add test cases that assert 201 and an id starting
with "sess_" on create, 204 on delete and a credit balance on /v1/usage.
Run them and summarize failures. Read POKEE_KEY from my shell, never a file.
El agente importa la especificación, comprueba cada payload contra el esquema del CLI y luego crea y ejecuta los casos:
apidog import --project <projectId> --format openapi --file ./pokee-openapi.json
apidog environment create pokee-tenant --project <projectId> --base-url https://your-tenant.enterprise.pokee.ai
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file create-session.json
apidog test-case create --project <projectId> --file create-session.json
apidog run --test-case <caseId> --project <projectId> -e <envId> --env-var "POKEE_KEY=$POKEE_KEY" -r cli,junit
Pasar la clave con --env-var la mantiene fuera de cualquier archivo que escriba el agente. Estos casos cubren los endpoints JSON; el flujo SSE en sí es más fácil de observar en la aplicación Apidog, que renderiza los eventos transmitidos (consulta pruebas SSE en Apidog). El mismo comando apidog run con -r junit se integra en CI, como muestra nuestra guía de CI/CD con Apidog CLI. ¿Eres nuevo con el CLI dentro de un agente? Empieza con Apidog CLI en Claude Code. El plan gratuito de Apidog cubre hasta 4 usuarios.
Dónde encaja Sharkly
Una vez que los agentes de Pokee, o cualquier agente de programación, ejecutan tareas que tardan 90 minutos, alguien tiene que decidir quién hace qué y revisar los resultados. Un ID de sesión en un archivo de registro no es una cola de trabajo. Sharkly es un tablero de tareas donde los agentes de IA y las personas comparten el trabajo: asignas una tarea a un agente o a un compañero de equipo, sigues su estado y revisas el resultado antes de que se publique. Es gratis para empezar, así que puedes poner un trabajo largo de agente en el tablero y ver cómo encaja la revisión en tu equipo antes de escalar.
Preguntas frecuentes
¿Hay un nivel gratuito para la API Enterprise de Pokee? La documentación no describe ninguno. El acceso comienza con una solicitud de demo, y Pokee aprovisiona la URL de tu inquilino y la clave por fuera de banda. El precio es por token en los niveles de Isaac anteriores.
¿Es la API de Pokee compatible con OpenAI? En parte. La ruta sin estado /v1/responses coincide con la forma en el cable de Responses de OpenAI para la llamada a funciones, y la ruta Direct Isaac acepta la forma de solicitud de Chat Completions. Los endpoints de sesión son propios de Pokee.
¿Cuánto puede durar un turno de un agente de Pokee? El tiempo de espera de turno por defecto es de 90 minutos y el TTL de sesión por defecto es de 4 horas. Ambos pueden elevarse bajo solicitud.
¿Qué pasa si mi cliente se desconecta a mitad del flujo? El agente sigue trabajando. Reconéctate al endpoint de reanudación con Last-Event-ID dentro de los 120 segundos posteriores al cierre del turno y recibirás el resto de los eventos sin volver a facturar.
¿Cómo se compara con otras APIs de agentes alojados? Se sitúa cerca de ofertas de agentes alojados como la API Agents de OpenAI; nuestra comparación de las opciones de agentes de OpenAI es una buena lectura a continuación, y qué hace CubeSandbox por los agentes de IA cubre el lado del sandbox.