Slackでは、チームがリクエストや意思決定が行われる場所で同じ公開ワークフローを実行できます。可視化された作業にはチャンネルでOkouにメンションし、下書きや機密分析にはダイレクトメッセージを利用してください。
ワークフローは1つのOkouエージェントに紐づきます。Slackは会話の場所を決定しますが、ワークフローの指示や接続、権限モデルは変更されません。
1. SlackワークスペースにOkouをインストールする
ワークスペース管理者が共有インテグレーションを設定します：
- Okouのチャンネルや作業スペースを管理するページを開きます。
- Slack を見つけて Slackにインストール を選択します。
- 対象のSlackワークスペースを選択します。
- 要求されたSlackの権限を確認し、承認します。
- インストールを完了し、Okouに戻ります。
ワークスペース管理者でない場合、製品には「Slackインテグレーションのインストールを管理者に依頼してください」と表示されます。Slack組織によっては、Slack管理者の承認が必要な場合もあります。
アプリはワークスペースごとに一度だけインストールしてください。各メンバーは自分のOkouアカウントを接続し、メッセージや実行が正しい人物に紐づくようにします。
2. 各メンバーの接続
ワークスペースへのインストール後：
- OkouでSlackインテグレーションを開きます。
- 接続 を選択します。
- Slackアカウントの接続を完了します。
- SlackでOkouアプリのホームを開くか、Slackからアカウント連携を求められた場合は
/okou connectを使用します。
現在の主なスラッシュコマンドは/okouです。
3. Okouをチャンネルに追加する
チームが利用したい各チャンネルに@Okouを招待してください。Okouは追加されたチャンネルのみで読み取り・返信が可能です。
必要最小限のチャンネルだけを追加しましょう。サポートワークフローには#support-triageだけ、ローンチワークフローには#launch-roomだけが必要な場合もあります。
プライベート作業には、共有チャンネルに追加する代わりにOkouとのダイレクトメッセージを開いてください。
4. 適切なエージェントを選択する
選択したエージェントによって、新しいSlack会話で利用できる役割、公開ワークフロー、接続、権限が決まります。
利用方法：
/okou switchで次の会話用のエージェントを選択；- オプションがある場合は
/okou modelでモデルを選択； - ビジュアルピッカーを使いたい場合はOkouアプリのホームコントロールを利用。
エージェントとモデルの選択はSlackスレッド作成時に固定されます。変更しても既存スレッドは書き換えられません。異なるエージェントで別作業を行う場合は、新たにトップレベルでメンションしてください。
5. 共有ワークフローを呼び出す
Okouにメンションし、ワークフロー名または成果物名を指定します。入力や必要な宛先・承認条件も含めてください。
明示的なワークフロー名の例：
Okou run qualify-inbound-lead for this message.
要約と返信案を作成してください。送信はしないでください。
自然言語リクエストの例：
Okou このインバウンドリードを共有プロセスで評価してください。
このスレッドに要約を投稿し、レビュー用のメール下書きを作成してください。
リクエストが現在のSlack会話に依存する場合は、そのメッセージやスレッドからOkouにメンションし、関連するコンテキストが保持されるようにしてください。
6. フォローアップは同じスレッドで行う
Okouはチャンネルでのメンションにスレッドで返信します。関連する修正やフォローアップリクエストもそのスレッドで続けてください。そのスレッドが1つの会話としてコンテキストを持ちます。
新たにトップレベルでメンションするタイミング：
- タスクが無関係な場合；
- 別のエージェントが担当すべき場合；
- 現在のスレッドのコンテキストを引き継ぎたくない場合；
- チームで別のレビュー履歴を残したい場合。
これによりチャンネルのやり取りが見やすくなり、無関係なタスクの指示が混ざるのを防げます。
チャンネル、スレッド、DMの使い分け
| サーフェス | 利用用途 | 例 |
|---|---|---|
| チャンネルメンション | チーム全体で見てレビューすべき作業 | インシデントスレッドの要約とアクションアイテムの下書き |
| スレッドでのフォローアップ | 同じタスクの修正や次のステップ | 1つの主張の検証、フォーマット変更、承認済み課題の登録 |
| ダイレクトメッセージ | プライベートな下書き、機密分析、個人作業 | 顧客返信の下書きや非公開ドキュメントの分析 |
ワークフローが公開されているからといって、機密情報をパブリックチャンネルに入力しないでください。ワークフローの公開範囲とメッセージの公開範囲は異なります。
例：共有バグトリアージワークフロー
ワークスペースに公開triage-bug-reportワークフローがパブリックなProductエージェント上にあるとします。
- チームメンバーが
#bug-reportにスクリーンショットと説明を投稿します。 - 次のように書きます：
@Okou run triage-bug-report on this message. Draft the GitHub issue, but ask before creating it. - Okouが共有の再現手順、重大度、重複チェック、課題フォーマットのルールを適用します。
- チームメンバーがSlackスレッドで下書きを確認します。
- 承認後、Okouはそのメンバーの認可されたGitHubアクセスを使って課題を作成し、リンクを返信します。
- 同じ入力漏れが繰り返される場合、ワークフローの所有者が今後の報告用に公開指示を更新します。
チームでトリアージ手法とレビュー履歴を共有できます。アクションを承認するメンバーは自分のアカウントと付与された権限を利用します。
トラブルシューティング
Okouが反応しない
- アプリが対象のSlackワークスペースにインストールされているか確認してください。
@Okouがチャンネルのメンバーであることを確認してください。- Okouアカウントを接続してください。
/okou helpで利用可能なコマンドを確認してください。
Okouが誤ったエージェントを使用する
/okou switchを実行し、目的のエージェントを選択してから新たにトップレベルでメンションしてください。既存スレッドでは作成時に選択されたエージェントが維持されます。
ワークフローが見つからない
ワークフローが「公開」になっていること、所有エージェントが公開であること、Slack会話がそのエージェントにルーティングされていることを確認してください。チームでワークフローを共有するもご参照ください。
コネクタの権限が不足している
認証プロンプトを開き、アカウントを確認し、必要な権限のみを付与してください。共有ワークフローは他メンバーのGmail、GitHub、Notion等のサービスアクセスを継承しません。
結果が誤った場所に送信された
リクエストやワークフロー指示で宛先を明記してください（例：「このスレッドに返信」「DMで送信」「下書きのみ作成」など）。全ての実行で宛先を統一したい場合は公開ワークフローを更新してください。
Slackインテグレーションの詳細な挙動はSlackをご覧ください。スケジュールやイベント駆動型のSlack配信については自動化をご参照ください。
