Preparar a máquina de uma conversa
Sobe ou retoma a máquina da conversa e prepara o que o agente usa, em segundo plano, para a próxima mensagem não esperar por isso. Responde na hora; o trabalho continua depois da resposta e nenhum erro dele afeta a conversa. Use quando a pessoa volta a digitar numa conversa parada há mais de 10 minutos, antes de enviar a mensagem por POST /v1/runs/{runId}/stream. Conversa antiga sem máquina ativa não ganha máquina nova (`no_warm_session`); conversa com turno em andamento não precisa (`run_in_progress`). Exige o escopo runs:execute.
Authorization
chaveDeApi Chave de API da organização, criada nas configurações. Envie-a em Authorization: Bearer <sua chave>.
In: header
Path Parameters
Identificador do run (o mesmo da conversa).
Header Parameters
Slug (ou id) de uma organização cliente do parceiro dono da chave. Aceito só em GET /v1/agents, POST /v1/agents/{agentId}/run, POST /v1/agents/{agentId}/stream, POST /v1/agents/{agentId}/threads, POST /v1/runs/{runId}/continue, GET /v1/runs/{runId}, POST /v1/runs/{runId}/stream, POST /v1/runs/{runId}/stop, POST /v1/runs/{runId}/plan e POST /v1/runs/{runId}/prewarm, e só com o escopo partner:execute: a operação roda dentro da organização cliente, como a identidade de sistema dela, sobre as cópias gerenciadas dos agentes do parceiro. Qualquer outra rota responde 400 org_header_not_supported. Organização que não existe ou não é cliente deste parceiro: 404 client_not_found.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/v1/runs/string/prewarm"{ "run_id": "string", "status": "string"}Continuar uma conversa recebendo o passo a passo
Mesma continuação de POST /v1/runs/{runId}/continue, respondendo text/event-stream. O histórico entra em contexto automaticamente. Numa conversa de pessoa da aplicação, valem as mesmas regras de `user` e `mcp` da continuação. Exige o escopo runs:execute.
Decidir o plano de um run
Aprova ou reprova o plano que um turno com `plan_mode: true` propôs. O `request_id` é o do evento `awaiting_input` com `kind: "plan"`, ou o de `pending_plan` em GET /v1/runs/{runId}. Aprovar grava a decisão, desliga o modo de plano e retoma a conversa para executar o plano, em segundo plano; o desfecho sai em GET /v1/runs/{runId}. O turno que propôs o plano precisa ter terminado: enquanto ele termina, a decisão responde 409 `turn_still_running` sem gravar nada, e quem chama tenta de novo em alguns segundos. Reprovar grava a recusa com a `note` e devolve a conversa ociosa, sem retomar o agente: o replanejamento é um turno novo de quem chamou, por POST /v1/runs/{runId}/continue ou /stream com `plan_mode: true` e a nota como `input`. Decide quem é aprovador do pedido ou quem configura o agente, avaliado como a pessoa dona da chave. Exige o escopo runs:execute.