Slackでは、チームがリクエストや意思決定がすでに行われている場所で、同じ公開ワークフローを実行できます。可視的な作業にはチャンネルでOkouをメンションし、非公開の下書きや機微な分析にはダイレクトメッセージを使ってください。
My Okou では、Public Workflow はワークスペース内の共有手順です。各メンバーは、自分の個人用の指示（Instructions）、メモリー、接続済みアカウント、権限を使ってそれを実行します。Legacy Agents では、その Workflow は1つの Agent にも属します。Slack は会話がどこで行われるかを決めるだけで、チームメイトのアカウントアクセスを付与するものではありません。
1. Slack ワークスペースにOkouをインストールする
ワークスペースの管理者が共有連携を設定します:
- Okouのチャンネルまたは作業画面を管理するページを開きます。
- Slack を見つけて Install to Slack を選択します。
- 対象の Slack ワークスペースを選びます。
- 要求された Slack の権限を確認して承認します。
- インストールを完了し、Okou に戻ります。
ワークスペースの管理者でない場合、製品には Slack integration をインストールするよう管理者に依頼してください と表示されます。Slack の組織によっては、Slack 管理者によるアプリの承認が必要な場合もあります。
アプリはワークスペースに対して1回だけインストールします。その後、各メンバーが自分の Okou のアイデンティティを接続するため、メッセージと実行は正しい人に帰属します。
2. 各メンバーを接続する
ワークスペースへのインストール後:
- Okou で Slack integration を開きます。
- Connect を選択します。
- Slack アカウントの接続を完了します。
- Slack で、Okou の app home を開くか、Slack からアカウントのリンクを求められた場合は
/okou connectを使います。
現在の主なスラッシュコマンドは /okou です。
3. チャンネルにOkouを追加する
チームが作業させたい各チャンネルに @Okou を招待します。Okou は、追加されたチャンネルでしか読み取りと返信ができません。
使うチャンネルは、必要最小限に絞ってください。サポート用ワークフローには #support-triage だけで十分な場合があり、ローンチ用ワークフローには #launch-room だけで十分な場合があります。
非公開の作業には、共有チャンネルに追加するのではなく、Okou とのダイレクトメッセージを開いてください。
4. 体験を確認する
My Okou: 接続後は、自分の Okou を使います。共有ワークフローを実行するために Agent を選ぶ必要はありません。利用可能なコマンドを確認するには /okou help を使います。
Legacy Agents: 適切な Agent を選ぶ
選択された agent によって、新しい Slack 会話で利用できる役割、公開ワークフロー、接続、権限が決まります。
使用するもの:
- 次の会話で使う agent を選ぶための
/okou switch; - そのオプションが利用できる場合に model を選ぶための
/okou model; - 視覚的なピッカーを使いたい場合の Okou app home のコントロール。
Agent と model の選択は、Slack のスレッドが作成された時点で確定します。後から変更しても、既存のスレッドは書き換えられません。別件の作業で別の agent が必要な場合は、新しいトップレベルのメンションを開始してください。
5. 共有ワークフローを起動する
Okou をメンションし、ワークフロー名または成果物のいずれかを指定します。実行に必要な入力や、出力先、承認条件も含めてください。
明示的なワークフロー名:
Okou このメッセージに対して qualify-inbound-lead を実行してください。
要約と返信の下書きを作成してください。送信しないでください。
自然言語での依頼:
Okou この受信リードを共有プロセスで選別してください。
要約をこのスレッドに投稿し、レビュー用のメール下書きを作成してください。
依頼が現在の Slack 会話に依存する場合は、関連するコンテキストが保持されるよう、そのメッセージまたはスレッドから Okou をメンションしてください。
6. フォローアップは同じスレッドで行う
Okou はチャンネルでのメンションに対してスレッドで返信します。関連する修正や追加依頼は、そのスレッドで続けてください。そのスレッドは、独自のコンテキストを持つ1つの会話です。
次の場合は新しいトップレベルのメンションを開始してください:
- 作業が別件である;
- Legacy Agents では、別の Agent がその作業を担当すべきである;
- 現在のスレッドに、引き継ぐべきでないコンテキストが含まれている;
- チームが別のレビュー履歴を望んでいる。
これにより、チャンネルの流れが読みやすく保たれ、無関係な作業の指示が混ざるのを防げます。
チャンネル、スレッド、それともDM?
| Surface | 使う場面 | 例 |
|---|---|---|
| Channel mention | チームに見せてレビューしてほしい作業 | インシデントのスレッドを要約し、対応項目の下書きを作成する |
| Thread follow-up | 同じ作業の修正と次の手順 | 1つの主張を確認する、形式を変更する、または承認済みの issue を登録する |
| Direct message | 非公開の下書き、機微な分析、個人作業 | 顧客への返信を下書きする、または非公開文書を分析する |
ワークフローが公開だからといって、機密情報を公開チャンネルに入れないでください。ワークフローの可視性とメッセージの可視性は別です。
例: 共有バグトリアージワークフロー
ワークスペースに Public triage-bug-report Workflow があるとします。Legacy Agents では、その Product Agent も Public である必要があります。
- チームメイトがスクリーンショットと説明を
#bug-reportに投稿します。 - その人は
@Okou run triage-bug-report on this message. Draft the GitHub issue, but ask before creating it.と書きます。 - Okou は共有の再現手順、重大度、重複確認、issue 形式のルールを適用します。
- チームメイトは Slack のスレッドで下書きをレビューします。
- 承認後、Okou はそのメンバーの許可済み GitHub アクセスを使って issue を作成し、リンクを返信します。
- 同じ不足フィールドが繰り返し出る場合、ワークフローの所有者は今後の報告用に公開の指示を更新します。
チームはトリアージ手順とレビュー履歴を共有します。操作を承認するメンバーは、引き続き自分のアイデンティティと付与された権限を使います。
トラブルシューティング
Okou が応答しない
- アプリが対象の Slack ワークスペースにインストールされていることを確認します。
@Okouがチャンネルのメンバーであることを確認します。- Okou アカウントを接続します。
- 利用可能なコマンドを確認するために
/okou helpを試します。
Legacy Agents: Okou が間違った Agent を使う
My Okou では、Agent の切り替えは不要です。Legacy Agents では、/okou switch を実行して目的の agent を選び、その後で新しいトップレベルのメンションを開始します。既存のスレッドは、作成時に選択された agent を保持します。
ワークフローが見つからない
ワークフローが Public で、対象のワークスペースにあることを確認してください。Legacy Agents では、所有する Agent も Public であり、会話がその Agent にルーティングされていることも確認してください。 チームとワークフローを共有する を参照してください。
コネクター権限が不足している
認可プロンプトを開き、アカウントを確認して、必要な権限だけを付与します。共有ワークフローは、他のメンバーの Gmail、GitHub、Notion、その他のサービスへのアクセスを継承しません。
結果が間違った場所に送られた
「このスレッドで返信する」「DM を送る」「下書きのみ作成する」など、依頼やワークフロー指示の中で送信先を明示してください。毎回同じ送信先にする必要がある場合は、公開ワークフローを更新してください。
Slack 連携の完全な動作については Slack を参照してください。スケジュールとイベント駆動の Slack 配信については オートメーション を参照してください。
