Back to docsCore concepts

Chat

How a single Okou run works — isolation, traceability, follow-ups.

Last updated August 21, 2026 · 5 min read

A chat is a conversation thread. Each message that asks Okou to act starts a run inside that thread. Replying in the same chat keeps the thread's earlier messages and artifacts available as context; opening a new chat starts a separate context.

A chat in progress, showing the agent working through a request in real time

Why chats matter

  • Context is thread-scoped. A run can use the messages and artifacts in its own chat. It does not automatically read another chat's history.
  • Runs are inspectable. The thread shows the messages, tool activity, artifacts, status, and errors produced by its runs.
  • Work can be redirected while it runs. You can stop an active run, or send a correction while Okou is still working — the new instruction is picked up inside the active run instead of discarding the work already underway. Consecutive messages stay grouped as one burst in the thread. To respond to one exact phrase, select it and choose Quote to place that text into your next message.

How chats and runs start

  • Opening a new conversation in the web app creates a new chat thread.
  • Sending another task in that conversation starts another run in the same thread.
  • A Slack conversation keeps context within its mapped Slack thread.
  • An automation runs in the automation chat associated with its workflow and owner. Repeated firings of that workflow reuse that automation chat.

Several threads can run at once. Different chat threads make progress independently — kick off a market study in one, draft a post in another, and both move at the same time. How many run in parallel depends on your plan; see Credits & billing. When every run slot is busy, the next run waits for one to free up.

Within one thread, runs are sequential. A thread does one run at a time. A correction you send while a run is working joins that run rather than starting a second one alongside it.

Where a run executes

Every run gets a machine of its own — a real one, with a terminal, a filesystem, and a browser. That's what lets Okou actually run the spreadsheet transform, clone the repository, or render the video, instead of describing how you would do it.

That environment is private to the run and is torn down when the run finishes. The code running inside it never receives your connector credentials — they are injected at the network boundary — and every request the run makes is recorded. See Security for how the isolation is built.

Treat the machine as temporary. Anything worth keeping should end up somewhere durable: published as a page, filed into a connected tool, or downloaded. A file path on the run's machine is not something you can share.

Continuing or starting fresh

Continue in the same thread when the next request depends on earlier messages, files, or decisions. Open a new thread when you want an independent context.

Channels are entry points to the same workspace, but they do not create one global conversation history. A new web, Slack, Telegram, or phone thread does not automatically import another thread's messages. When moving work to a new thread, include the context or artifact it needs.

Inspecting a run

Use the thread's activity or log control to inspect the run. It records the visible sequence of messages, tool activity, artifacts, status changes, and errors. This is the first place to check when a result is incomplete or a connector action did not happen.

Troubleshooting

What you seeWhat to check or do
QueuedThe workspace has no free run slot, so the run has not started yet. Wait for a slot to free up; a queued message can be removed before it starts. Sending a correction into a run that is already working is not queueing — that message joins the active run.
A Connect or Authorize cardThe required account is not connected, or this agent lacks a required connector permission. Complete the card and choose only the access and duration the task needs. If the run does not resume, retry the request in the same thread.
Selected model is not availableThe thread's model is not currently usable under the workspace's model policy or provider connection. Choose an available model in the composer, or reconnect the requested provider under Settings → Models.
Insufficient creditsThe workspace cannot start more model work with its current balance. Open Billing to review the balance, top up, or change plan, then retry.
An attachment upload errorThe file did not finish uploading, so it is not available to the run. Retry the upload before sending the message again.
A run is FailedThe run ended without a result. Open its visible error and activity log, correct the reported connector, permission, model, input, or service problem, then retry.

When asking support for help, share the chat URL and the failed run's visible error. Never paste connector secrets or provider keys into the chat.

What's next