ドキュメントに戻るコアコンセプト

チャット

1回のOkouランがどう動くか — 分離、追跡可能性、フォローアップ。

最終更新日: 2026年8月21日 · 1 min read

チャットは会話スレッドです。Okouに行動を求める各メッセージは、そのスレッド内でRunを開始します。同じチャットで返信すると、スレッドの以前のメッセージと成果物がコンテキストとして利用できます。新しいチャットを開くと、別のコンテキストが始まります。

進行中のチャット。エージェントがリクエストをリアルタイムで処理している様子

チャットが重要な理由

  • コンテキストはスレッドに閉じる。 Runは自分のチャット内のメッセージと成果物を使えます。別のチャットの履歴を自動では読みません。
  • Runは検査できる。 スレッドには、そのRunが生成したメッセージ、ツールアクティビティ、成果物、ステータス、エラーが表示されます。
  • 作業は実行中でも向きを変えられる。 アクティブなRunを停止できるほか、Okouが作業している最中に修正を送ることもできます。新しい指示はすでに済んだ作業を捨てずに、進行中のRunの中で取り込まれます。連続して送ったメッセージはスレッド内で1つのまとまりとして扱われます。特定の一文に返したいときは、その部分を選択して引用を選ぶと、そのテキストを次のメッセージに差し込めます。

チャットとRunの始まり方

  • Webアプリで新しい会話を開くと、新しいチャットスレッドが作られます。
  • その会話で別のタスクを送ると、同じスレッドで別のRunが始まります。
  • Slackの会話は、対応するSlackスレッド内にコンテキストを保持します。
  • オートメーションは、そのワークフローとオーナーに関連付けられたオートメーションチャットで実行されます。そのワークフローの繰り返しの発火は、そのオートメーションチャットを再利用します。

複数のスレッドを同時に走らせられます。 別々のチャットスレッドはそれぞれ独立に進みます。片方で市場調査を始め、もう片方で記事を書き、両方が同時に動きます。何本を並行して走らせられるかはプランによります。クレジットと請求を参照してください。すべてのRunスロットが埋まっているときは、次のRunは空きが出るまで待ちます。

1つのスレッドの中では順番に走ります。 スレッドは一度に1つのRunだけを実行します。Runが動いている最中に送った修正は、隣に2本目を立てるのではなく、そのRunに合流します。

Runはどこで実行されるか

Runごとに専用のマシンが用意されます。ターミナル、ファイルシステム、ブラウザを備えた本物のマシンです。だからこそOkouは、表計算の変換を実際に走らせ、リポジトリをクローンし、動画をレンダリングできます。やり方を説明するだけでは終わりません。

この環境はそのRunだけのもので、Runが終わると取り壊されます。中で動くコードがあなたのコネクタ認証情報を受け取ることはありません(ネットワーク境界で注入されます)。そしてRunが出したリクエストはすべて記録されます。隔離がどう作られているかはセキュリティを参照してください。

マシンは一時的なものだと考えてください。残したいものは、どこか永続する場所に着地させます。ページとして公開する、接続済みのツールに保存する、あるいはダウンロードする。Runのマシン上のファイルパスは、誰かに共有できるものではありません。

続けるか、新しく始めるか

次のリクエストが以前のメッセージ、ファイル、決定に依存する場合は、同じスレッドで続けます。独立したコンテキストにしたい場合は、新しいスレッドを開きます。

チャンネルは同じワークスペースへの入口ですが、単一のグローバルな会話履歴を作るわけではありません。新しいWeb、Slack、Telegram、電話のスレッドは、別のスレッドのメッセージを自動では取り込みません。作業を新しいスレッドに移すときは、必要なコンテキストや成果物を含めます。

Runの検査

スレッドのアクティビティまたはログのコントロールでRunを検査します。そこには、メッセージ、ツールアクティビティ、成果物、ステータス変更、エラーの見える順序が記録されます。結果が不完全な場合やコネクタのアクションが実行されなかった場合に、最初に確認すべき場所です。

トラブルシューティング

表示確認・対処
Queuedワークスペースに空きRunスロットがなく、Runがまだ開始していない。スロットが空くのを待つ。キューにあるメッセージは開始前に削除できる。すでに作業中のRunに修正を送るのはキューイングではなく、そのメッセージはアクティブなRunに合流する。
ConnectまたはAuthorizeカード必要なアカウントが未接続か、このエージェントに必要なコネクタ権限がない。カードを完了し、タスクに必要なアクセスと期間だけを選ぶ。Runが再開しない場合は、同じスレッドでリクエストを再試行する。
Selected model is not availableスレッドのモデルが、ワークスペースのモデルポリシーまたはプロバイダー接続の下で現在使えない。コンポーザーで利用可能なモデルを選ぶか、Settings → Modelsで該当プロバイダーを再接続する。
Insufficient credits現在の残高では、ワークスペースがこれ以上のモデル作業を開始できない。Billingを開いて残高を確認し、追加するかプランを変更してから再試行する。
添付のアップロードエラーファイルのアップロードが完了していないため、Runが利用できない。メッセージを再送する前にアップロードを再試行する。
RunがFailedRunが結果なしで終了した。表示されるエラーとアクティビティログを開き、報告されたコネクタ、権限、モデル、入力、サービスの問題を修正して再試行する。

サポートに助けを求める際は、チャットのURLと失敗したRunの表示されるエラーを共有します。コネクタのシークレットやプロバイダーキーをチャットに貼り付けないでください。

次へ

  • チャット境界で何が強制されるかはPermissionsを参照。
  • チャットのコストの計算方法はCredits & billingを参照。
  • 繰り返し・イベント駆動のチャットモデルはAutomationsを参照。