チャット は会話のスレッドです。Okou に何かを頼むメッセージはすべて、そのスレッド内で Run を開始します。同じチャットで返信すれば、そのスレッドの過去のメッセージや成果物がコンテキストとして使えます。新しいチャットを開くと、別のコンテキストが始まります。
チャットが重要な理由
- コンテキストはスレッド単位。 Run が使えるのは自分のチャットにあるメッセージと成果物です。別のチャットの履歴を自動で読むことはありません。
- Run は確認できる。 スレッドには、その Run が生み出したメッセージ、ツールの動作、成果物、ステータス、エラーが表示されます。
- 走っている途中で方向を変えられる。 実行中の Run を止めることも、Okou が作業中のまま修正を送ることもできます。新しい指示は、すでに進んだ作業を捨てずに、実行中の Run の中で取り込まれます。連続したメッセージはスレッド内でひとまとまりとして扱われます。特定の一文に応答したいときは、その部分を選んで Quote を選ぶと、そのテキストが次のメッセージに入ります。
チャットと Run はどう始まるか
- Web アプリで新しい会話を開くと、新しいチャットスレッドができます。
- その会話でさらに別の作業を送ると、同じスレッドで別の Run が始まります。
- Slack の会話は、対応づけられた Slack スレッドの中でコンテキストを保ちます。
- オートメーションは、そのワークフローと所有者に紐づくオートメーション用チャットで実行されます。そのワークフローが繰り返し発火しても、同じオートメーション用チャットが使われます。
複数のスレッドを同時に動かせます。 別々のチャットスレッドは独立して進みます。ひとつで市場調査を走らせ、別のひとつで投稿を書き、両方が同時に進みます。並行して走る数はプランによります。Credits & billing を参照してください。実行枠がすべて埋まっているときは、次の Run は枠が空くまで待ちます。
ひとつのスレッドの中では、Run は順番に実行されます。 スレッドは一度にひとつの Run しか行いません。Run の作業中に送った修正は、隣に 2 つ目の Run を立てるのではなく、その Run に合流します。
Run はどこで実行されるか
すべての Run に専用のマシンが割り当てられます。ターミナル、ファイルシステム、ブラウザを備えた本物のマシンです。だからこそ Okou は、やり方を説明するのではなく、実際に表計算の変換を実行し、リポジトリをクローンし、動画を書き出せます。
この環境は Run 専用で、Run が終わると破棄されます。中で動くコードがあなたのコネクタ認証情報を受け取ることはありません（認証情報はネットワーク境界で注入されます）。そして Run が行ったすべてのリクエストが記録されます。分離の仕組みは Security を参照してください。
マシンは一時的なものとして扱ってください。残す価値があるものは、どこか永続的な場所に置く必要があります。ページとして公開する、接続済みのツールに保存する、あるいはダウンロードする、といった形です。Run のマシン上のファイルパスは共有できるものではありません。
続けるか、新しく始めるか
次の依頼が以前のメッセージ・ファイル・決定に依存するなら、同じスレッドで続けてください。独立したコンテキストが欲しいときは、新しいスレッドを開きます。
チャネルは同じワークスペースへの入り口ですが、ひとつのグローバルな会話履歴を作るわけではありません。Web、Slack、Telegram、電話の新しいスレッドが、別のスレッドのメッセージを自動で取り込むことはありません。作業を新しいスレッドに移すときは、そこで必要なコンテキストや成果物も一緒に渡してください。
Run を確認する
スレッドのアクティビティ表示やログ操作から Run を確認します。そこにはメッセージ、ツールの動作、成果物、ステータスの変化、エラーの見える範囲の流れが記録されています。結果が不完全なときや、コネクタの操作が実行されていないときに、まず見るべき場所です。
トラブルシューティング
| 表示 | 確認・対処 |
|---|---|
| Queued | ワークスペースに空きの実行枠がないため、Run がまだ始まっていません。枠が空くのを待ってください。待機中のメッセージは開始前なら取り消せます。すでに作業中の Run に修正を送るのは順番待ちではなく、そのメッセージは実行中の Run に合流します。 |
| Connect または Authorize のカード | 必要なアカウントが接続されていないか、このエージェントに必要なコネクタ権限がありません。カードの手順を完了し、その作業に必要なアクセスと期間だけを選んでください。Run が再開しない場合は、同じスレッドでもう一度依頼します。 |
| Selected model is not available | 現在のワークスペースのモデルポリシーやプロバイダー接続では、そのスレッドのモデルを使えません。入力欄で使えるモデルを選ぶか、Settings → Models で該当プロバイダーを接続し直してください。 |
| Insufficient credits | 現在の残高では、これ以上モデルの処理を開始できません。Billing を開いて残高を確認し、追加購入またはプラン変更をしてから再実行してください。 |
| 添付のアップロードエラー | ファイルのアップロードが完了しておらず、Run から使えません。メッセージを送り直す前にアップロードをやり直してください。 |
| Run が Failed | Run が結果を出さずに終わりました。見えているエラーとアクティビティログを開き、報告されたコネクタ・権限・モデル・入力・サービスの問題を直してから再実行してください。 |
サポートに相談するときは、チャットの URL と、失敗した Run の見えているエラーを共有してください。コネクタのシークレットやプロバイダーのキーをチャットに貼らないでください。
次に読むもの
- チャットという境界で何が強制されるかは Permissions。
- チャットのコストがどう計算されるかは Credits & billing。
- 定期実行やイベント駆動のチャットの仕組みは Automations。
