どちらの体験を使っていますか？
このドキュメントは両方の体験を対象にしています。Settings → Personal → My Okou が利用できる場合は、My Okou の手順に従ってください。New agent のある Agents ページを使っている場合は、Legacy Agents の手順に従ってください。利用可否はメンバーごとに異なる場合があり、このドキュメントがあなたの体験を変更することはありません。
どちらの体験でも、複数のチャットやタスクを同時に実行し、ワークフローを再利用し、レビュー済みの作業をチームと共有できます。ランタイムのサブエージェントは実行ツールであり、作成する必要のある別の製品プロファイルではありません。
設定の違い: My Okou では、Settings → Personal → My Okou の個人用 Instructions と、ワークスペースの Workflows を使用します。以下の手順のうち、名前付き Agent の選択、作成、または承認を求めるものは Legacy Agents にのみ適用されます。My Okou では、自分のチャットを使用し、表示されるアカウントと名前付き権限の要求に従ってください。共有された Workflows は資格情報を共有しません。自動化は所有者のコンテキストとアクセス権を使用します。
チャット は会話スレッドです。Okou に処理を依頼する各メッセージは、そのスレッド内で run を開始します。同じチャットで返信すると、スレッドの以前のメッセージと成果物がコンテキストとして利用可能なまま保持されます。新しいチャットを開くと、別のコンテキストが開始されます。
チャットが重要な理由
- コンテキストはスレッド単位です。 実行では、自身のチャット内にあるメッセージと成果物を利用できます。別のチャットの履歴を自動的に読み取ることはありません。
- 実行内容は確認できます。 スレッドには、各実行によって生成されたメッセージ、ツールの動作、成果物、ステータス、エラーが表示されます。
- 実行中でも作業の方向を変えられます。 実行中の処理を停止したり、Okou がまだ作業している間に修正を送ったりできます。新しい指示は、すでに進行中の作業を破棄するのではなく、そのアクティブな実行の中に取り込まれます。連続して送ったメッセージは、スレッド内で 1 つのまとまりとして扱われます。特定の一節に対して返信したい場合は、その部分を選択して Quote を選ぶと、そのテキストを次のメッセージに挿入できます。
チャットと run はどのように始まるか
- Web アプリで新しい会話を開くと、新しいチャットスレッドが作成されます。
- その会話に別のタスクを送信すると、同じスレッドで別の run が開始されます。
- Slack の会話は、対応付けられた Slack スレッド内でコンテキストを保持します。
- 自動化は、そのワークフローと所有者に関連付けられた自動化チャットで実行されます。そのワークフローが繰り返し起動されると、その自動化チャットが再利用されます。
複数のスレッドを同時に実行できます。 異なるチャットスレッドは、それぞれ独立して進行します。たとえば、1 つでは市場調査を開始し、別の 1 つでは投稿の下書きを作成するといったことができ、両方が同時に進みます。同時に並行実行できる数はプランによって異なります。詳しくは クレジットと請求 を参照してください。すべての実行スロットが使用中の場合、次の実行は 1 つ空くまで待機します。
1 つのスレッド内では、実行は順番に処理されます。 1 つのスレッドで同時に行える実行は 1 つだけです。実行中に送った修正は、別の 2 つ目の実行を並行して開始するのではなく、その実行に取り込まれます。
run はどこで実行されるか
各 run には専用のマシンが割り当てられます。ターミナル、ファイルシステム、ブラウザを備えた、実在のマシンです。だからこそ Okou は、どう行うかを説明するだけでなく、スプレッドシート変換の実行、リポジトリのクローン、プレゼンテーションのレンダリングを実際に行えます。
その環境はその実行専用のものであり、実行が終了すると破棄されます。その内部で動作するコードがコネクタの認証情報を受け取ることはありません。認証情報はネットワーク境界で注入されます。また、実行が行うすべてのリクエストは記録されます。分離の仕組みについては Security を参照してください。
そのマシンは一時的なものとして扱ってください。残す価値のあるものは、ページとして公開する、接続済みツールに保存する、またはダウンロードするなどして、永続的な場所に置く必要があります。run のマシン上のファイルパスは、共有できるものではありません。
続行するか、新しく始めるか
次の依頼が以前のメッセージ、ファイル、または判断に依存する場合は、同じスレッドで続けます。独立したコンテキストが欲しい場合は、新しいスレッドを開いてください。
チャネルは同じワークスペースへの入口ですが、1 つのグローバルな会話履歴を作るわけではありません。新しい web、Slack、Telegram、または phone のスレッドは、別のスレッドのメッセージを自動的には取り込みません。作業を新しいスレッドへ移すときは、必要なコンテキストや成果物を含めてください。
run の確認方法
スレッドのアクティビティまたはログのコントロールを使って run を確認します。そこには、見えているメッセージの流れ、ツールのアクティビティ、成果物、ステータス変更、エラーが記録されます。結果が不完全な場合や、コネクタの操作が実行されなかった場合に、まず確認すべき場所です。
トラブルシューティング
| 表示内容 | 確認または実行すること |
|---|---|
| Queued | ワークスペースに空いている実行スロットがないため、実行はまだ開始されていません。スロットが空くまで待ってください。キューに入っているメッセージは、開始前であれば削除できます。すでに処理中の実行に修正を送る場合はキューには入りません。そのメッセージはアクティブな実行に取り込まれます。 |
| Connect または Authorize のカード | 必要なアカウントが接続されていないか、このエージェントに必要なコネクタ権限がありません。カードの案内に従って完了し、タスクに必要なアクセス範囲と期間だけを選択してください。実行が再開しない場合は、同じスレッドでリクエストを再試行してください。 |
| Selected model is not available | そのスレッドのモデルは、現在のワークスペースのモデルポリシーまたはプロバイダー接続では利用できません。コンポーザーで利用可能なモデルを選択するか、Settings → Models で要求されたプロバイダーを再接続してください。 |
| Insufficient credits | 現在の残高では、ワークスペースでこれ以上モデル処理を開始できません。Billing を開いて残高を確認し、チャージするかプランを変更してから再試行してください。 |
| 添付ファイルのアップロードエラー | ファイルのアップロードが完了していないため、その実行では利用できません。メッセージを再送する前に、アップロードをやり直してください。 |
| 実行が Failed | 実行は結果を返さずに終了しました。表示されているエラーとアクティビティログを開き、報告されたコネクタ、権限、モデル、入力、またはサービスの問題を修正してから再試行してください。 |
サポートに助けを求めるときは、チャットの URL と、失敗した run に表示されているエラーを共有してください。コネクタの秘密情報やプロバイダーキーをチャットに貼り付けないでください。
