どの体験を使っていますか？
このドキュメントは両方の体験を対象としています。Settings → Personal → My Okou が利用できる場合は、My Okou の手順に従ってください。New agent のある Agents ページを使っている場合は、Legacy Agents の手順に従ってください。利用可否はメンバーごとに異なる場合があります。このドキュメントによって、あなたの体験が切り替わることはありません。
どちらの体験でも、複数のチャットやタスクを同時に実行したり、ワークフローを再利用したり、レビュー済みの作業をチームと共有したりできます。実行時のサブエージェントは実行ツールであり、作成する必要のある別の製品プロフィールではありません。
セットアップの違い: My Okou は Settings → Personal → My Okou の個人用 Instructions と、ワークスペースの Workflows を使用します。以下の手順で、名前付きのエージェントを選択、作成、または承認するよう求められる場合は、Legacy Agents のみが対象です。My Okou では、自分のチャットを使い、表示されるアカウントおよび名前付き権限のリクエストに従ってください。共有されたワークフローは認証情報を共有しません。自動化は所有者のコンテキストとアクセス権を使用します。
カスタムコネクタを使うと、組織管理者はビルトインのカタログにない HTTPS API、または有効な場合は Streamable HTTP MCP サーバーを登録できます。これはネットワーク境界と認証方法を定義します。エージェント向けの完全な API リファレンスを自動生成するわけではありません。
何を誰が設定するか
- 組織管理者 がコネクタ定義を作成、編集、削除します。
- メンバー は自分のシークレットを接続するか、コネクタの OAuth フローを完了します。
- 認可と権限 により、Okou がその接続で要求できる名前付きアクションが制御されます。Legacy Agents でも Agent 固有の認可を使用します。
定義は組織内で共有されます。メンバーの認証情報は、そのメンバーと組織にスコープされたままです。
HTTP API コネクタ
- Connectors → Custom を開き、New connector を選択します。
- HTTP API を選択し、表示名を入力します。
- 1 行ごとに 1 つ以上の HTTPS Prefixes を追加します。要求は、コネクタが認可する前に、設定されたプレフィックスのいずれかに一致している必要があります。
- API に必要な場合は認証を追加します:
- API authentication: ヘッダー名と、
{{secret}}を含むヘッダーテンプレートを入力します。例:AuthorizationとBearer {{secret}}。 - OAuth 2.0: 認可 URL、トークン URL、クライアント ID、クライアントシークレット、スコープ、およびトークンエンドポイントの認証方式を入力します。フォームに表示される正確なリダイレクト URL をプロバイダーに登録します。
- API authentication: ヘッダー名と、
- コネクタを作成します。必要な各メンバーは、その後 Connect を選択し、シークレットを入力するか OAuth を完了します。
- 必要な名前付き権限を確認して承認します。Legacy Agents では、目的の Agent も選択します。
既存の OAuth 定義またはそのクライアント資格情報を変更すると、現在の OAuth 接続は切断されます。変更後、メンバーは再度接続する必要があります。
MCP コネクタ
ワークスペースでコネクタタイプとして MCP が表示される場合は、HTTPS の Streamable HTTP MCP エンドポイントを入力し、同じフォームで API または OAuth 認証を設定します。ピッカーに MCP が表示されない場合、そのワークスペースでは有効になっていません。
エージェントに API 手順を教える
カスタムコネクタは、安全なネットワークアクセスと認証情報の注入を提供します。作成フォームは OpenAPI ドキュメントをアップロードしたり、自動検出したりしません。エージェントには、リクエスト内でエンドポイント、メソッド、パラメータ、期待されるレスポンスを伝えるか、その手順を API リファレンスをファイルとして添付した workflow に記録してください。
新しいコネクタは、既知のエンドポイントに対する限定的な読み取り専用リクエストで検証します。多くの API は意味のあるルートエンドポイントを公開しないため、一般的な Test connection リクエストはありません。
セキュリティ境界
- HTTPS プレフィックスと MCP エンドポイントのみが受け入れられます。
- ファイアウォールは保存された認証情報を、一致するリクエストにのみ注入します。
- 保存されたシークレットは保存時に暗号化され、環境変数としてエージェントに公開されることはありません。
- キー、トークン、クライアントシークレットをチャットメッセージ、ワークフローの Instructions、または添付ファイルに入れないでください。
- ワークフローに必要な最小限の上流スコープを持つサービス用認証情報を使用してください。
トラブルシューティング
| 問題 | 確認事項 |
|---|---|
| New connector が利用できない | コネクタ定義を作成または編集できるのは組織管理者のみです。 |
| エージェントがコネクタを確認できない | 現在のメンバーに対して接続し、必要な権限を確認してください。Legacy Agents では、目的の Agent も承認してください。 |
| リクエストが API に到達する前にブロックされる | リクエスト URL が設定済みの HTTPS プレフィックスのいずれかで始まっていることを確認してください。 |
| API が 401 または 403 を返す | メンバーの認証情報を再接続し、上流のキーまたは OAuth スコープを確認してください。 |
| OAuth がリダイレクトエラーを返す | コネクタフォームに表示される正確なリダイレクト URL を登録し、認可 URL とトークン URL を確認してください。 |
| エージェントが間違ったエンドポイントまたはペイロードを推測する | コネクタ名だけに頼らず、API 手順をワークフローに入れ、関連するリファレンスを添付してください。 |
