Computer が、組み込みのコネクタを持たないサードパーティ API にアクセスする必要がある場合、ご自身の API 資格情報を安全に提供できます。お客様のキーは暗号化して保存され、エージェントの軌跡(サードパーティのモデルとやり取りされるプロンプトと応答)やタスクのサンドボックスに露出することはありません。タスク内での資格情報の提供はすべての Perplexity クライアントで機能します。資格情報を保存・管理するための資格情報ボルトの画面はウェブで利用できます。
概要
Computer に使わせたいツールの中には、まだ組み込みのコネクタがないものもあります。カスタム資格情報を使えば、ご自身の API 資格情報を持ち込んで、Computer がお客様に代わってそのサービスに認証できるようになります — たとえば、トランザクションメールの送信、分析 API からのデータ取得、データプロバイダーからのスポーツのスコアの取得などです。Computer は、これらの API が使用する認証方式(トークン、カスタムヘッダー、クエリパラメータ)に対応しています。ユーザー名とパスワードを提供した場合、Computer はそれらを組み合わせて Authorization ベアラー資格情報を作成し、API に安全に認証できるようにします。
タスクに資格情報が必要になると、Computer はセキュアなフォームで入力を求めます。お客様の資格情報は暗号化され、セキュアなプロキシを通じて送信 API リクエストに注入されるため、生の値がエージェントのアクティビティやタスクのサンドボックスに露出することはありません。資格情報をどのくらいの期間保持するかは、このタスク限り、再利用のため個人のボルトに保存、またはチームメイトも使えるようプロジェクトと共有、の中から選べます。タスク内で追加した資格情報は Computer セッションの間は利用でき、いつでも取り消せます。個人のボルトに保存した場合、Computer はお客様の承認を得て、または自動承認を設定していれば、それを必要とするクエリに対して自動的に添付します。
カスタム資格情報を使う理由
組み込みコネクタのないサービスに接続できます。 サードパーティツール用にご自身の API キーを持ち込めば、Computer はすぐにそれを扱えます。
シークレットをエージェントの視界の外に保てます。 資格情報は暗号化され、セキュアなプロキシを通じて注入されるため、生の値がエージェントのアクティビティやサンドボックスに現れることはありません。
タスクをまたいでキーを再利用できます。 資格情報を一度個人のボルトに保存すれば、Computer が今後のタスクでそれを再利用できます。
プロジェクトとアクセスを共有できます。 資格情報をプロジェクトに追加すれば、生のキーを共有することなく、チーム全員がそれを使えます。
制御を保てます。 保存した資格情報ごとに、Computer がお客様の承認なしに使えるようにするか、タスクで使う前に Computer に承認を求めさせるかを選べます。
注: カスタム資格情報を追加する前に、そのサービスにすでに組み込みのコネクタがないか確認してください。コネクタはサードパーティサービスを連携するための推奨される方法であり、利用可能な場合は Computer がそれを使用します。カスタム資格情報は、まだコネクタがないサービスに対して使用してください。
3 つの資格情報スコープ
資格情報には、有効期間と利用できる相手に応じて、3 つのスコープがあります。
セッション(単一タスク): 現在のタスク内でのみ使用され、再利用のために保存されません。
資格情報ボルト(個人): 個人の資格情報ボルトに保存され、ご自身のタスクをまたいで再利用できます。
プロジェクト(共有): プロジェクトに保存され、チーム全員が使用できます。
以下のセクションでは、それぞれの仕組みを説明します。
セッション資格情報(単一タスク)
セッション資格情報は最もシンプルな選択肢です。1 つのタスクのためにキーを提供し、それは保存されません。
タスク内で入力を求められます。 タスクに資格情報が必要になると、Computer は入力用のセキュアなフォームを表示します。可能な場合は、ホスト、名前、資格情報の種類などの詳細をあらかじめ入力しておきます。
暗号化されプロキシ経由になります。 お客様の資格情報は暗号化され、セキュアなプロキシを通じて送信 API リクエストに注入されるため、生の値がエージェントのアクティビティやサンドボックスに見えることはありません。
タスク全体で有効です。 一度追加すると、資格情報はフォローアップのリクエストを含め、そのタスクの残りの間ずっと利用できます。
保存されません。 セッション資格情報は再利用のために保存されません — 新しいタスクを開始すると、再び入力を求められます。今後再利用したい場合は、資格情報をボルトに保存するオプションを選べます。
ユーザーボルト資格情報(個人、再利用可能)
資格情報を個人のボルトに保存すると、毎回入力し直すことなく、ご自身のタスクをまたいで再利用できます。
タスクのフォームから保存する。 Computer が資格情報の入力を求めたときに、Computer のタスクをまたいで再利用するために資格情報ボルトに保存するオプションを選びます。
または直接追加する。 タスク外で資格情報を追加・管理するには、設定 > 資格情報ボルト に移動します。
再利用のたびに承認する。 デフォルトでは、Computer は保存した資格情報を認識し、使用する前にお客様の明示的な承認を求めます。常に許可 を選択すると、その資格情報が必要になるたびに明示的な承認を省略できます。
お客様に非公開のまま保たれます。 ユーザーボルト資格情報はお客様のアカウントに属し、他の誰とも共有されません。
プロジェクト資格情報(チームと共有)
資格情報をプロジェクトに追加すると、そのプロジェクトで作業する全員がそれを使えます — チームが頼りにする共有キーに便利です。
プロジェクト内で追加する。 プロジェクト資格情報は、プロジェクトのサイドバーの資格情報セクションで定義します。
プロジェクトの全員が使えます。 プロジェクトのすべてのメンバーが、生の値を見ることなく、自分のタスクでその資格情報を使えます。
ライターが管理します。 プロジェクト資格情報を追加または取り消すには、プロジェクトのコネクタと同じアクセスルールに従い、少なくともそのプロジェクトのライターである必要があります。
使用のたびに承認する。 タスク内では、Computer はプロジェクト資格情報を使用する前に必ずお客様の承認を求めます。常に許可 を設定すると、このステップを省略できます。
資格情報の管理
設定 > 資格情報ボルトでボルトを見つける。 個人の資格情報ボルトはアカウント設定内にあります。コネクタのページからも開けます — カスタム接続を追加 のドロップダウンをクリックし、次に 自分の API に接続 をクリックします。
キーの追加、確認、削除。 資格情報ボルトを開いて、新しい資格情報を追加したり、保存済みのものを確認したり、不要になったものを削除したりできます。
プロジェクト資格情報はプロジェクト内で管理する。 プロジェクトの資格情報の追加や取り消しは、そのプロジェクトのコネクタ設定から行います。少なくともそのプロジェクトのライターである必要があります。
制限とプライバシー
生のキーは隠されたままです。 資格情報は暗号化され、セキュアなプロキシを通じて注入されるため、生の値がエージェントのアクティビティやタスクのサンドボックスに露出することはありません。
API リクエストのみ。 カスタム資格情報は、Computer がセキュアなプロキシを通じてルーティングできる API リクエストに対応しています。SSH キーなど、その他のシークレットの種類は現在サポートされていません。
保存済み資格情報には承認が必要です。 Computer は、タスクで保存済みのユーザーまたはプロジェクト資格情報を使用する前にお客様の明示的な承認を求めます。ただし、その資格情報が必要になるたびに明示的な承認を省略するために 常に許可 を明示的に選択した場合を除きます。
セッション資格情報は保存されません。 セッション資格情報はその Computer セッション内でのみ使用され、いつでも取り消すことができ、以降のセッションでの再利用のために保存されることはありません。ただし、資格情報を資格情報ボルトに保存することを明示的に選択した場合を除きます。
プロジェクト資格情報はプロジェクトと共有されます。 プロジェクトにアクセスできる人は誰でも、その資格情報を自分のタスクで使用できるため、そのチームと共有するつもりのキーだけを追加してください。
よくある質問
セッション、ユーザー、プロジェクトの各資格情報の違いは何ですか?
セッション資格情報は現在のタスク内でのみ使用され、保存されません。ユーザーボルト資格情報は個人のアカウントに保存され、毎回お客様の承認を得たうえで、ご自身のタスクをまたいで再利用できます。プロジェクト資格情報はプロジェクトに保存され、これも使用のたびに承認を得たうえで、そのチーム全員が使用できます。
コネクタとカスタム資格情報のどちらを使うべきですか?
サービスに組み込みのコネクタがある場合は、コネクタを使ってください — サードパーティサービスを接続するための推奨される方法です。必要なツールに利用可能なコネクタがない場合は、カスタム資格情報を使用してください。
Computer は私の API キーを見られますか?
いいえ。お客様の資格情報は暗号化され、セキュアなプロキシを通じて送信リクエストに注入されるため、生の値がエージェントのアクティビティやタスクのサンドボックスに見えることはありません。
Computer はなぜ資格情報の承認を求めるのですか?
保存済みの資格情報について、Computer はタスクでユーザーボルトまたはプロジェクトの資格情報を使用する前にお客様の明示的な承認を求めます。これにより、保存したキーがいつ使われるかをお客様が制御し続けられます。特定の資格情報について承認リクエストをスキップするように Computer を設定できます — そのためには、資格情報ボルト内のその特定の資格情報の設定で 常に許可 を選択してください。
今後のタスクで資格情報を再利用するにはどうすればよいですか?
Computer から求められたときに資格情報ボルトに保存するか、ボルトから直接追加してください。以降のタスクでは、Computer がそれを認識し、使用の承認を求めます。
資格情報ボルトはどこにありますか?
個人の資格情報ボルトはアカウント設定内にあります。カスタム接続を追加する、または自分の API に接続するオプションを使って、コネクタのページからも開けます。
チームメイトは私のキーを使えますか?
プロジェクト資格情報として追加した場合に限ります。ユーザー資格情報はお客様のアカウントに非公開です。プロジェクト資格情報はプロジェクトの全員が使用でき、追加や取り消しには少なくともそのプロジェクトのライターである必要があります。
SSH キーなど、他のシークレットを保存できますか?
現在はできません。カスタム資格情報は、セキュアなプロキシを通じてルーティングされる API リクエストに対応しています。SSH キーなど、その他のシークレット形式は現在サポートされていません。
ユーザー名とパスワードは、そのサービスのウェブサイトへのログインと同じものですか?
いいえ。ユーザー名とパスワードを提供すると、Computer はそれらを使ってサービスの API に認証するための Authorization ベアラー資格情報を構築します — これはそのサービスのウェブサイトにサインインするための汎用ログインではありません。カスタム資格情報は、トークン、カスタムヘッダー、またはクエリパラメータを使って API リクエストを認証する目的でのみ使用されます。どの値を入力すべきか不明な場合は、その API がリクエストの認証をどのように想定しているか、API のドキュメントを確認してください。




