Pokee Enterprise API: Agentes com Sandbox Persistente, Preços e Sua Primeira Chamada

A Pokee Enterprise API é uma API REST que executa um agente de IA de formato longo dentro de um sandbox dedicado e persistente para cada cliente. Você cria uma sessão, envia uma mensagem e lê a resposta do agente como um fluxo de Server-Sent Events (SSE). As sessões podem conter arquivos, habilidades personalizadas, suas próprias ferramentas e memória que persiste entre sessões. O acesso se dá por meio de uma solicitação de demonstração da Pokee, não por cadastro autônomo.

A seguir: como funcionam as sessões e os fluxos, sua primeira chamada, os preços do Pokee Isaac, os limites e como deixar um agente de codificação testar os endpoints com o Apidog CLI. Todos os números vêm da documentação da Pokee, consultada em 28 de outubro de 2026.

O que é a Pokee Enterprise API?

A Pokee Enterprise API (a Pokee a chama de Enterprise Responses API) permite executar fluxos de trabalho orientados por agentes que levam minutos, não segundos. Cada locatário recebe um workspace privado, um token bearer estável e seu próprio subdomínio, https://your-tenant.enterprise.pokee.ai. Dentro desse workspace, cada sessão é um processo de agente em seu próprio sandbox.

Uma chamada de chat responde a um prompt e esquece. Uma sessão da Pokee mantém sua conversa, arquivos e estado de ocupado, para que o agente possa pesquisar, escrever arquivos e chamar ferramentas ao longo de muitos turnos. Se você leu nosso guia sobre Claude Managed Agents, o formato vai parecer familiar: o provedor hospeda o loop do agente e o sandbox, e você o controla via HTTP.

Foi criada para equipes que querem um agente hospedado com isolamento por locatário e controles de rede empresariais (listas de IP permitidos, mTLS, AWS PrivateLink, fixação de região), que a Pokee lista como disponíveis sob solicitação.

Conceitos principais: sessões, arquivos, habilidades e memória

A API tem quatro blocos de construção.

Alguns detalhes de sessão importam desde o início:

• Persistência. Por padrão, persistent é false, e a sessão se autodestrói 5 minutos após sua última resposta. Defina como true para manter a sessão até que seu ttl se esgote (padrão de 14.400 segundos, ou 4 horas) ou até você excluí-la.
• Bloqueio de modelo. O model que você passa no momento da criação se aplica a todos os turnos dessa sessão.
• Escopo de arquivos. Passe file_access com listas de caminhos read e write para restringir o que o agente vê; a API HTTP de arquivos retorna 403 fora desse escopo.
• Um turno por vez. Enviar uma segunda mensagem enquanto um turno está em execução retorna 409 Conflict.

Como fazer sua primeira chamada à API da Pokee

A Pokee entrega dois valores fora de banda: a URL do seu locatário e uma chave no formato pk_<tenant>_<token>. Depois, a primeira chamada exige três etapas.

1. Verifique se o gateway está no ar (não é necessária autenticação).
2. Crie uma sessão e guarde seu id.
3. Publique uma mensagem e leia o fluxo 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."}'

A flag -i imprime os cabeçalhos. Guarde o X-Response-Id (msg_ mais 24 caracteres hexadecimais): você precisa dele para retomar ou cancelar o turno.

Cada evento tem três linhas: id:, event: e data:. Você verá message.created, depois blocos de text.delta (além de eventos thinking.* ou tool_use.*), e o fluxo termina com message.completed, message.cancelled ou message.error. Se SSE é novidade para você, o guia de Server-Sent Events da MDN explica o formato, e nosso post sobre testar APIs de LLM que transmitem via SSE mostra como ler os blocos.

Chamada de ferramentas: duas superfícies

A Pokee oferece ao agente duas maneiras de chamar suas funções, ambas usando definições de função no estilo OpenAI.

A rota sem estado é a escolha quando você está substituindo a Pokee por trás de código escrito para a OpenAI Responses API, porque o formato de transmissão coincide. Ela aceita até 128 ferramentas por requisição, nomes de ferramentas de até 64 caracteres e descrições de até 16 KiB. Também aceita reasoning.effort (minimal, o padrão, mantém o raciocínio estendido desligado; low, medium e high o ativam). A saída tem 4.096 tokens por padrão, com limite máximo de 32.000.

As ferramentas de sessão são adequadas quando o agente deve raciocinar, executar habilidades e, às vezes, chamar seus sistemas no mesmo turno. Você as registra na criação da sessão.

Retomada, cancelamento e chaves de idempotência

Turnos longos falham de maneiras que chamadas curtas não falham. A Pokee adicionou três correções em 4 de maio de 2026, segundo seu changelog.

• Retomada. Se seu cliente cair no meio do fluxo, o agente continua em execução. Reconecte-se a GET /v1/sessions/{id}/responses/{rid}/events com um cabeçalho Last-Event-ID e o servidor reproduz a partir do próximo evento. Turnos encerrados permanecem disponíveis por 120 segundos, e a retomada não cobra tokens novamente.
• Cancelamento. POST /v1/sessions/{id}/responses/{rid}/cancel retorna 202 e o fluxo termina com message.cancelled. O uso parcial de um turno cancelado não é cobrado. A sessão e seus arquivos permanecem ativos.
• Chaves de idempotência. Envie Idempotency-Key: <uuid> no POST da mensagem. Uma nova tentativa com a mesma chave e o mesmo corpo retorna o ID de resposta original em vez de iniciar um segundo turno. As chaves duram 24 horas, e a mesma chave com um corpo diferente retorna 422.

A rota sem estado /v1/responses suporta todos os três quando stream é true.

Modelos e preços do Pokee Isaac

A Pokee publica dois níveis do Isaac em sua página de modelos e preços. Os preços são por milhão de tokens.

Novos locatários usam pokee-isaac-high-reasoning por padrão quando você omite model. Backends Kimi, GPT-5.5 e Gemini estão disponíveis por locatário mediante contrato. A documentação não lista um nível gratuito nem um contrato mínimo; pergunte à Pokee sobre esses termos.

Há também uma Direct Isaac API, adicionada em 7 de agosto de 2026: uma rota POST /v1/chat/completions compatível com a OpenAI, sem loop de agente nem ferramentas. Ela é habilitada por locatário, aceita apenas pokee-isaac e encaminha automaticamente requisições longas (200.000 e 2.000.000 de tokens ou mais) para pools de contexto maiores. GET /v1/usage mostra seu saldo de créditos.

Uma observação de segurança da documentação: o bearer do locatário é uma chave de API direta. Mantenha-a em seu servidor ou atrás de seu próprio proxy, nunca em código de navegador, mobile ou desktop.

Limites e códigos de erro

Estes são os padrões da página de limites e erros. A Pokee afirma que pode aumentar qualquer um deles sob solicitação.

Os códigos de erro que você mais vai tratar: 401 (chave inválida ou ausente), 402 (sem créditos, apenas no modo de crédito rígido), 403 (caminho fora do escopo da sessão), 409 (sessão ocupada), 422 (chave de idempotência reutilizada com um corpo diferente), 429 (limite de uso) e 500 (tente novamente com backoff). Os erros retornam como {"error": "<name>", "message": "<detail>"}.

Deixe seu agente de codificação testar a API da Pokee com o Apidog CLI

Uma API de sessão tem muito contrato a definir: 201 na criação, um ID sess_, 409 enquanto ocupada, 204 na exclusão, 202 no cancelamento. Seu agente de codificação pode escrever e executar essas verificações enquanto você continua trabalhando. O Apidog CLI dá ao Claude Code, Codex ou Cursor os comandos para fazer isso.

Configure uma vez:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
apidog skill install

Depois, dê ao seu agente um 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.

O agente importa a especificação, verifica cada payload em relação ao schema do CLI e então cria e executa os 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

Passar a chave com --env-var mantém ela fora de qualquer arquivo que o agente escreva. Esses casos cobrem os endpoints JSON; o próprio fluxo SSE é mais fácil de observar no aplicativo Apidog, que renderiza eventos transmitidos (veja testes de SSE no Apidog). O mesmo comando apidog run com -r junit entra no CI, como mostra nosso guia do Apidog CLI em pipelines CI/CD. Novo no CLI dentro de um agente? Comece com Apidog CLI no Claude Code. O plano Free do Apidog cobre até 4 usuários.

Onde o Sharkly se encaixa

Quando agentes da Pokee, ou quaisquer agentes de codificação, executam tarefas que levam 90 minutos, alguém precisa decidir quem faz o quê e verificar os resultados. Um ID de sessão em um arquivo de log não é uma fila de trabalho. O Sharkly é um quadro de tarefas onde agentes de IA e pessoas compartilham o trabalho: você atribui uma tarefa a um agente ou a um colega de equipe, acompanha seu status e revisa a saída antes de ela ser entregue. É gratuito para começar, então você pode colocar um trabalho longo de agente no quadro e ver como a revisão se encaixa na sua equipe antes de escalar.

FAQ

Existe um nível gratuito para a Pokee Enterprise API? A documentação não descreve um. O acesso começa com uma solicitação de demonstração, e a Pokee provisiona a URL do seu locatário e a chave fora de banda. O preço é por token nos níveis do Isaac acima.

A API da Pokee é compatível com a OpenAI? Em parte. A rota sem estado /v1/responses corresponde ao formato de transmissão da Responses da OpenAI para chamada de funções, e a rota Direct Isaac aceita o formato de requisição do Chat Completions. Os endpoints de sessão são próprios da Pokee.

Quanto tempo pode durar um turno de um agente da Pokee? O timeout padrão do turno é de 90 minutos e o TTL padrão da sessão é de 4 horas. Ambos podem ser aumentados sob solicitação.

O que acontece se meu cliente desconectar no meio do fluxo? O agente continua trabalhando. Reconecte-se ao endpoint de retomada com Last-Event-ID dentro de 120 segundos após o encerramento do turno e você recebe o restante dos eventos sem cobrança adicional.

Como isso se compara a outras APIs de agentes hospedados? Fica próximo de ofertas de agentes hospedados como a OpenAI Agents API; nossa comparação das opções de agentes da OpenAI é uma boa próxima leitura, e o que o CubeSandbox faz por agentes de IA cobre o lado do sandbox.