En pocas palabras: Los agentes de Pokee AI se ejecutan a través de la API Pokee Enterprise: cada cliente obtiene un entorno aislado (sandbox) privado y persistente donde un agente puede trabajar en un solo turno hasta por 90 minutos, con acceso delimitado a archivos, habilidades cargadas, archivos de personalidad en .pokee/ y memoria que persiste entre sesiones. La API se encarga de ejecutar el agente; tu equipo sigue necesitando un lugar para asignar ese trabajo, monitorearlo y revisar los resultados antes de ponerlos en producción.
Pokee está pensado para tareas que van más allá de lo que cabe en una ventana de chat convencional: un informe de mercado de diez páginas o una investigación exhaustiva que toma casi una hora. Como nadie se queda mirando fijamente un turno de 90 minutos, alguien tiene que asumir la responsabilidad, verificar el avance y determinar si está terminado. Si ya gestionas agentes de programación en un solo tablero, Sharkly es el espacio ideal para centralizar ese trabajo; más adelante profundizamos en ello.
¿Qué es Pokee AI?
Pokee es una plataforma de agentes cuya Enterprise API se define como «una API REST para ejecutar flujos de trabajo prolongados basados en agentes en un sandbox dedicado y persistente». Cada cliente cuenta con un espacio de trabajo privado, un token bearer y endpoints para gestionar sesiones, archivos, habilidades y streaming de mensajes en una dirección del tipo https://your-tenant.enterprise.pokee.ai. El acceso está enfocado a empresas: la documentación de Pokee canaliza a los nuevos clientes a través de la opción «Request demo» y no contempla planes de autoservicio o gratuitos.
En su página de modelos y precios se detallan dos niveles de modelos:
| Modelo | Entrada ($/M tokens) | Salida ($/M tokens) | Lectura de caché ($/M tokens) |
|---|---|---|---|
pokee-isaac-high-reasoning |
$3 | $15 | $0.30 |
pokee-isaac |
$0.30 | $5 | $0.10 |
Las cuentas nuevas utilizan por defecto el nivel de razonamiento avanzado (high-reasoning). El modelo queda fijado al crear la sesión, por lo que cada turno dentro de ella se ejecutará bajo ese mismo nivel.
El modelo de agentes de Pokee: sesiones, sandbox, archivos, habilidades y memoria
El modelo de agentes de Pokee consta de cinco componentes configurables, y cada uno de ellos se traduce en una decisión para el equipo.
- Sesiones. Una sesión es un proceso de agente individual dentro de su propio sandbox en tu pod dedicado, con su propio historial, delimitación de archivos y estado de ocupación.
- Modo persistente. De forma predeterminada, una sesión se autodestruye 5 minutos después de emitir su última respuesta. Si configuras
persistent: true, se mantendrá activa hasta que venza su TTL (4 horas por defecto) o hasta que decidas eliminarla. - Acceso delimitado a archivos. Al momento de la creación indicas las rutas permitidas para
readywrite. Cualquier ruta que quede fuera de ese alcance simplemente no existe dentro del sistema de archivos del agente. - Habilidades (skills). Se cargan mediante un archivo zip que contenga un
SKILL.mden su directorio raíz. Todas las nuevas sesiones de la organización podrán acceder a él. - Archivos de personalidad y memoria. El contenido Markdown en
.pokee/se antepone al prompt del sistema, mientras que.memory/MEMORY.mdretiene información clave entre sesiones.
¿Cómo delimita Pokee el acceso a los archivos?
La delimitación de permisos se aplica en dos niveles. Dentro del agente, un espacio de nombres de montaje con bubblewrap por sesión oculta todo lo que esté fuera de las rutas autorizadas, por lo que cualquier intento de lectura devuelve un error ENOENT. A través de la API HTTP de archivos, esa misma solicitud genera un 403 Forbidden.
La guía práctica de acceso delimitado a archivos muestra el ejemplo de una sesión autorizada para leer la carpeta de un cliente y una carpeta compartida de plantillas, pudiendo escribir exclusivamente en la carpeta de salida de dicho cliente:
curl -X POST "$POKEE_API/v1/sessions" \
-H "Authorization: Bearer $POKEE_KEY" \
-H "Content-Type: application/json" \
-d '{
"persistent": true,
"ttl": 14400,
"metadata": {"board_task": "COIN-412", "client": "acme-corp"},
"file_access": {
"read": ["projects/acme-corp", "shared/templates"],
"write": ["projects/acme-corp/output"]
}
}'
El alcance de acceso es inmutable durante toda la vida de la sesión. Si necesitas ampliarlo, debes destruir la sesión y crear una nueva. Esto facilita el cumplimiento normativo y traslada una decisión clave al equipo: definir los permisos al asignar la tarea, no a mitad del proceso.
¿Para qué sirven los archivos de personalidad en .pokee/ y la memoria?
Los archivos ubicados en workspace/.pokee/*.md se incorporan en orden alfabético al prompt del sistema, cada uno bajo un encabezado ## <filename>. La guía práctica sobre personalidad recurre a 00_soul.md para definir el tono de voz, 10_glossary.md para la terminología técnica y 20_style_guide.md para las pautas de formato. El límite de tamaño conjunto en este directorio es de 1 MB.
Cualquier modificación surte efecto en la siguiente sesión; una sesión en curso conserva su prompt original. Asimismo, el agente consulta y actualiza .memory/MEMORY.md en cada sesión, un archivo que puedes editar a través de la API de archivos o, según se indica en la página sobre contexto del agente, solicitar a Pokee que lo desactive.
El impacto de los agentes de IA de larga duración en los equipos
Los agentes de IA diseñados para ejecuciones prolongadas transforman tres momentos clave en la dinámica de trabajo de un equipo: quién pone en marcha la tarea, cómo se supervisa su avance y quién valida el resultado. Los límites predeterminados de Pokee ilustran con claridad estas implicaciones.
| Límite | Valor predeterminado |
|---|---|
| Sesiones simultáneas | 10 |
| Tiempo límite por turno | 90 minutos |
| TTL de la sesión | 4 horas |
| Turnos por hora / por día | 300 / 5,000 |
| Tokens por hora / por día | 20M / 200M |
| Tamaño máximo del espacio de trabajo | 100 GB |
Pokee indica que cualquiera de estos valores puede incrementarse previa solicitud.
¿Quién asigna una tarea de agente que toma 90 minutos?
Tener diez sesiones simultáneas parece margen de sobra hasta que un lunes por la mañana cinco personas inician la generación de dos informes cada una. Además, si una sesión está ocupada, rechazará cualquier segundo mensaje con un error 409. Por ello, es indispensable que alguien defina la tarea, seleccione el nivel del modelo, delimite el acceso a los archivos y configure la sesión, registrándolo todo en una tarea con un responsable asignado para evitar que dos personas lancen la misma ejecución de 90 minutos.
¿Cómo supervisar el avance de un turno prolongado?
El agente continúa ejecutándose aun después de que tu cliente se desconecte. La guía práctica para tareas de larga duración recurre a sondeos periódicos con GET /v1/sessions/{id} cada 15 segundos para comprobar el indicador busy, lee las claves de progreso que el flujo de trabajo escribe en metadata y, finalmente, descarga el archivo generado.
while True:
s = c.get(f"/v1/sessions/{sid}").json()
if not s["busy"]:
break
print(f"metadata: {s['metadata']}")
time.sleep(15)
La transmisión de datos utiliza Server-Sent Events, con eventos como message.created, message.completed, message.error y message.cancelled. El endpoint de reanudación permite reconectar una transmisión interrumpida a partir del Last-Event-ID sin volver a facturar tokens. Esto le indica a tu script que el turno concluyó, pero no si la calidad del informe es satisfactoria.
¿Quién revisa el resultado antes de darlo por bueno?
Pokee guarda el archivo resultante en el espacio de trabajo. La revisión es un paso humano externo a la API: alguien debe abrir report.md, contrastarlo con los requisitos iniciales y aprobarlo o solicitar ajustes. En entornos donde se ejecutan múltiples agentes en paralelo, esta fase suele convertirse en el cuello de botella, tal como se expone en la revisión humana es el cuello de botella.

Ejemplo práctico: elaboración de un informe de cliente, de la asignación a la revisión
Tres personas comparten una cuenta corporativa en Pokee. El entregable es un informe de mercado trimestral para «Acme Corp».
- Asignación. Dana crea una tarea: «Informe de mercado del Q3 para Acme», asignada a Dana, con Sam como revisor y fecha límite el jueves.
- Definición del alcance. En la tarea se especifican el modelo de Pokee (
pokee-isaac-high-reasoning), las rutas de lectura (projects/acme-corp,shared/templates) y la ruta de escritura (projects/acme-corp/output). - Inicio. Dana crea una sesión persistente vinculando el ID de la tarea en
metadatay envía un único mensaje solicitando que el informe se guarde enoutput/report.md. - Seguimiento. El ID de la sesión se publica en los comentarios de la tarea. Al consultar
GET /v1/sessions/{id}, cualquiera podrá verbusy: truehasta que el turno concluya. - Recopilación. En cuanto
busycambia a false, Dana descarga el archivo y lo adjunta a la tarea. - Revisión. Sam contrasta el documento con las especificaciones. Si detecta discrepancias, añade un comentario y lanza un nuevo turno; si todo es correcto, aprueba la tarea.
- Limpieza. Dana elimina la sesión, o bien un proceso programado nocturno con
DELETE /v1/sessions?status=idle&older_than=1hse encarga de depurarla.
Los pasos 1, 4 y 6 no son llamadas a una API. Son labores de coordinación indispensables: justo los pasos que los equipos suelen omitir cuando un agente responde al instante, pero que echan en falta cuando la tarea demora una hora.
El papel de Sharkly en el trabajo con agentes de Pokee
Sharkly es una plataforma de gestión del trabajo para agentes: un tablero centralizado donde las tareas se asignan tanto a personas como a agentes, las ejecuciones quedan registradas y las entregas esperan la validación humana. No ejecuta directamente las sesiones de Pokee ni cuenta con un conector nativo para él; su función es estructurar la tarea, su responsable, el estado y el proceso de revisión que los rodea.
En el día a día, esto se traduce en lo siguiente:
- Asignación clara. La tarea de Pokee se integra en el tablero con un responsable y un estado bien definidos, junto al resto del trabajo del equipo. En nuestro artículo sobre equipos orientados a agentes explicamos por qué la asignación explícita es crucial.
- Un agente que interactúa con la API. Un agente de Sharkly se ejecuta en tu propio ordenador a través de un entorno de ejecución como Claude Code. Al equiparlo con una habilidad que encapsule las llamadas curl vistas anteriormente, puede encargarse de iniciar la sesión, hacer el seguimiento y registrar tanto el ID de la sesión como los resultados en la tarea.
- Límites de ejecución alineados con los de Pokee. Cada agente cuenta con parámetros de ejecución específicos: concurrencia máxima de tareas asignadas, tiempo límite por tarea y tiempo de expiración en cola. El agente mostrado abajo tiene un límite de 1 tarea y 40 minutos; para trabajar con Pokee, mantén la concurrencia en 10 sesiones o menos y ajusta el tiempo para cubrir el turno de 90 minutos, o programa el agente para que inicie la ejecución y verifique el avance más tarde.

- La revisión como estado, no como un mensaje suelto. Un agente puede dejar una tarea pendiente de validación humana, enviándola directamente a la bandeja de entrada del revisor. En nuestros artículos sobre agentes de programación con intervención humana y filtros de aprobación para agentes de código detallamos en qué puntos estratégicos conviene establecer estas pausas.
- Activadores externos. Las automatizaciones de Sharkly admiten activadores por webhook: una URL segura que inicia una ejecución cada vez que un servicio externo envía una solicitud POST. Tu propio script puede invocarla cuando un turno de Pokee haya finalizado.
Comenzar a usar Sharkly es completamente gratis, y el consumo de modelos se carga a las cuentas que ya utilizas. Si quieres profundizar en el flujo de revisión para tareas de larga duración, consulta nuestro artículo sobre por qué las ejecuciones de millones de tokens necesitan una cola de revisión.
Cuándo utilizar Pokee y cuándo optar por otra alternativa
Pokee es la opción idónea cuando la tarea genera un documento o un conjunto de datos en lugar de cambios en el código, toma de unos minutos a una hora y exige un sandbox persistente. Resulta especialmente conveniente si el contrato estipula que «el agente no debe tener acceso a los datos del cliente B», ya que el aislamiento se garantiza a nivel del sistema de archivos. Además, su modo sin conexión ofrece un entorno en el que la única salida permitida hacia el exterior es la API del modelo.
En cambio, conviene considerar otras alternativas si necesitas empezar a trabajar de inmediato sin pasar por reuniones comerciales. Para tareas de desarrollo directamente sobre tus propios repositorios, Claude Code o Codex en tu propia infraestructura resultan opciones más directas. Muchos equipos optan por combinar ambas soluciones, lo que justifica plenamente contar con un tablero unificado para coordinarlas.
Conclusión
Los agentes de Pokee AI permiten a los equipos delegar tareas prolongadas con un aislamiento riguroso. La API se limita a responder si el turno ha finalizado; tu equipo sigue siendo quien debe definir quién puso en marcha la tarea, qué recursos se vieron afectados y si el entregable final cumple con los estándares esperados.
Asegúrate de dejar claros esos tres puntos en la tarea antes de lanzar la primera sesión. Y si buscas un tablero donde converjan tanto las ejecuciones de Pokee como tus agentes de programación, crea un espacio de trabajo en Sharkly y asigna esta misma semana tu primera tarea de larga duración a un agente.
Preguntas frecuentes
¿Qué es la API Pokee Enterprise?
La API Pokee Enterprise es una interfaz REST orientada a ejecutar flujos de trabajo extensos basados en agentes dentro de un sandbox persistente y dedicado por cliente. Ofrece endpoints para gestionar sesiones, archivos, habilidades, streaming de mensajes y métricas de consumo, todo autenticado mediante un token bearer.
¿Cuánto tiempo puede ejecutarse un agente de Pokee?
Un turno individual puede durar hasta 90 minutos por defecto y una sesión hasta 4 horas; ambos límites pueden aumentarse previa solicitud.
¿Pokee AI es gratuito?
La documentación no contempla un plan gratuito. El acceso requiere solicitar una demostración comercial y el uso se factura por token consumido: $3 por millón de tokens de entrada y $15 por millón de salida en pokee-isaac-high-reasoning, frente a $0.30 y $5 en pokee-isaac.
¿Qué ocurre si dos personas envían un mensaje a la misma sesión de Pokee?
El segundo mensaje recibirá un error 409, indicando que la sesión está ocupada procesando otra solicitud. Cada sesión atiende un solo turno a la vez, por lo que las tareas simultáneas requieren sesiones independientes, hasta el máximo predeterminado de 10.
¿Puede un agente de Pokee retener información entre sesiones?
Sí. Lee y actualiza el archivo workspace/.memory/MEMORY.md en cada sesión, y la información se conserva aun si el pod se reinicia.
¿Puede Sharkly ejecutar agentes de Pokee directamente?
No. Sharkly no incluye un conector directo con Pokee. Sin embargo, un agente de Sharkly en tu ordenador puede interactuar con la API de Pokee mediante una habilidad personalizada, mientras la tarea en Sharkly centraliza la asignación, el seguimiento de estado y la revisión humana.



