コネクタとは、Okouがあなたの代わりに取り出して使えるツールにすぎません。Slack、Notion、Gmail、GitHub、Linear、Stripe — 接続すれば、Okouはあなたの仕事について話すのをやめ、実行し始めます。
Okouに*「Notionでローンチ告知の下書きを作り、#marketingにリンクを投稿して」*と頼むとします。NotionとSlackが接続されていれば、それは仮定ではなくなります。OkouはNotionを開いてページを作り、下書きを書き、Slackに投稿します。あなたがやるのと同じ方法で、より速く。
接続の仕組み
Okouは作業中にコネクタを要求できます。または、ワークスペースからConnectorsを開いて先に設定することもできます。2つの別々の判断があります:
- Connectは、そのサービスに対する現在のメンバーのアカウントをリンクまたは有効化します。OAuthと手動入力の認証情報は、コネクタが明示的に別としない限り、そのメンバーのものです。
- Authorizeは、エージェントに名前付きコネクタ権限を付与します。接続済みアカウントが自動的にすべてのエージェントで使えるわけではなく、エージェントを認可しても拒否された権限は付与されません。
インラインカードが両方のステップを案内します。接続が完了したら、要求されたアクションを確認してアクセス期間を選びます。その後、Okouはそのエージェントでタスクを続行できます。
チームメイトの接続が自分のアカウントへのアクセスを与えるとは考えないでください。サービスがメンバーごとの認証情報を使う場合、各メンバーが自分のアカウントを接続します。
最初の接続チェックリスト
- Connectorsを開き、Built-inを選び、サービスを検索します。
- Connectを選び、プロバイダーのサインインまたは認証情報フローを完了します。
- コネクタを必要とするエージェントを選びます。
- 要求された権限を確認し、Allow for 1h、Allow for 24h、Allow for 7d、Allow alwaysのいずれかを適切に選びます。
- 元のチャットに戻り、Runが再開しなかった場合のみ再試行します。
アカウントが接続済みでもタスクがまだブロックされる場合は、エージェントの認可と、具体的に拒否された権限の両方を確認します。接続状態だけでは、要求されたアクションが許可されている証明にはなりません。
Okouができることの一端
コネクタが実際の仕事になる例をいくつか:
- Notion — ページ作成、データベース更新、会議メモの保存、提案の下書き、ワークスペース横断の検索。
- Slack — DM送信、チャンネルへの投稿、長いスレッドの要約、停滞した会話のフォローアップ。
- Gmail — 受信トレイを読み、今日本当に対応すべきものを浮き彫りにし、返信をアカウント内の下書きとして準備。Okouが下書きを書き、あなたが送信を押す。
- GitHub — Issue作成、PRへのコメント、バックログのトリアージ、リリースノートの下書き。
- Linear — チケット作成、ステータス間のタスク移動、スプリントサマリー生成。
- Stripe、HubSpot、Calendar、Drive、Sheets、Docs… — 同じ考え方。仕事があるツールの中で。
ツールの仕組みを説明する必要はありません。Okouはすでに知っています。あなたは結果を説明し、Okouがクリックを処理します。
Okouに何をさせるかはあなたが選ぶ
ツールの認可はオールオアナッシングではありません。各コネクタについて、Okouに許可するアクションを選びます。その選択は、エージェントのAuthorizationタブからいつでも緩めたり絞ったりできます。
チームによるスコープの例:
- Gmail — Okouに受信トレイの読み取りと返信の下書きを許可するが、代わりに送信は決してさせない。
- Slack — Okouにチャンネルの読み取りとスレッドの要約を許可するが、自分の名前での投稿はブロックする。
- GitHub — OkouにIssue作成とPRコメントを許可するが、force pushやブランチ削除など破壊的な操作は拒否する。
- Linear — Okouにチケットの作成と更新を許可するが、クローズや削除はさせない。
- Notion — Okouにページ読み取りとコメント追加を許可するが、データベースへの破壊的な更新はブロックする。
アクセスは名前付きコネクタ権限で強制されます。エージェントが現在許可されていない権限を必要とする場合、Okouは別途それを要求します。現在の付与はエージェントのAuthorizationタブで確認・変更し、そのRun中に実行されたコネクタアクションはチャットアクティビティで検証します。
組み込みとカスタム
組み込みコネクタはOkouが保守し、Built-inタブに表示されます。ワークスペースのライブなコネクタピッカーが正しいカタログです。コネクタの追加や設定に伴い可用性が変わるためです。
サービスが一覧にない場合、組織の管理者がCustom connectorを登録できます。カスタムコネクタは許可されるHTTPS送信先と認証情報の注入方法を定義します。その後、メンバーが自分の認証情報を接続し、必要なエージェントを認可します。
アクセスについての注記
認証情報はプラットフォームに保存され、ネットワーク境界で一致する送信リクエストに注入されます。エージェントコードに環境変数として公開されることはありません。コネクタ権限は認証情報とは別で、拒否や期間限定が可能です。
メンバーの接続を切断すると、その認証情報は将来のRunから削除されます。エージェントの認可を削除すると、そのエージェントはコネクタを使えなくなりますが、他の認可済みエージェントのためにメンバーのアカウントが切断されることはありません。
完全なアクセスモデルはPermissionsを参照。
次へ
- Catalog — Okouがそのままサポートするすべてのツール。
- Custom connectors — それ以外を追加。