> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# シークレットを作成・管理する

> Secret Manager に API キーや資格情報を追加し、Agents、Sheets、Aim で使用する

Secret Manager には、Agents、Workflows、Sheets、AI Marketer(Aim)が使用する API キーと資格情報を保存します。スコープと表示範囲の仕組みについては、[Secret Manager の仕組み](https://docs.tryprofound.com/ja-jp/platform-config/secret-manager/overview.md)をご覧ください。

## シークレットを作成する

**1. Secret Manager を開く**

プラットフォームの左上にある組織名を選択し、**Settings** を選択します。左側のナビゲーションサイドバーで、**Organization** の下にある **Secret Manager** を選択します。

**2. シークレットを追加する**

**Add secret** を選択します。**Scope** で、組織のすべてのメンバーとシークレットを共有する場合は **Organization** を、自分だけが使用する場合は **Personal** を選択します。

**3. 名前と値を入力する**

シークレットの用途がわかる **Name** を入力します(例: `CMS_API_KEY`)。この名前は、Agents、Aim、その他の Profound 内の場所でシークレットを識別するために使用されます。**Value** に資格情報を貼り付け、**Create secret** を選択します。

> [!TIP]
>
> シークレットには、`CRM_PROD_TOKEN` のように、どのサービスと環境に属するかがわかる名前を付けてください。チームメンバーは値を見ることができないため、組織のシークレットを名前で選択します。

## シークレットを表示・変更・削除する

Secret Manager には 2 つのタブがあります。**Organization** には組織全体で共有されているシークレットが、**Personal** には自分のシークレットが一覧表示されます。**Search secrets** でタブ内を検索できます。各行には、シークレットの名前、マスクされた値、最終更新者、更新日時が表示されます。

値を表示するには、**Value** 列の目のアイコンを選択します。このアイコンは自分が作成したシークレットでのみ有効になるため、他のメンバーの値は非表示のままです。

シークレットを変更または削除するには、その行の末尾にある **...** アクションメニューを開きます。シークレットの編集、削除、値の表示ができるのは作成者のみであるため、他のメンバーのシークレットではこれらのアクションは無効になっています。

## Agent、Workflow、Sheet でシークレットを使用する

Agents、Workflows、Sheets はいずれも **Profound Secret** 入力を通じてシークレットを受け取ります。入力を一度追加し、資格情報が必要な場所で参照して、実行時にシークレットを選択します。そのため、値が Agent、Workflow、Sheet 自体に保存されることはありません。

1. **Profound Secret** 入力を追加します。Agent Builder または Workflow Builder の **Start** ブロックで **Add input** を選択し、**Type** を **Profound Secret** に設定して **Label** を入力してから、**Add input** を選択します。[Sheet](https://docs.tryprofound.com/ja-jp/sheets/getting-started.md) の場合は、代わりに **Profound Secret** タイプの列を追加します。
2. 資格情報を必要とするノードまたはツールで入力を参照します。たとえば、[Call API](https://docs.tryprofound.com/ja-jp/agents/workflows/nodes/call-api.md) ノードでは、**Advanced settings** を開き、**Authentication Type** を **API Key** に設定して、**API Key Value** にシークレット入力を挿入します。
3. 実行時にシークレットを選択します。Agent や Workflow をテストまたは実行する際に、シークレット入力を開いて **Select a secret** を選択します。Sheet では行ごとに **Select a secret** を選択するため、その行で実行される Workflow 列は行ごとに異なる資格情報を使用できます。

## Aim でシークレットを使用する

チャットで Aim が資格情報を必要とする場合、必要なフィールドを含む **Secure input** フォームが表示されます。フィールドに入力し、次のいずれかを選択します。

* **Save**: Aim が後で再利用できるように資格情報を保存します。
* **Provide once**: 資格情報を保存せずに、このリクエストにのみ使用します。

Aim が保存済みのシークレットを必要とする場合は、そのシークレットの名前を示して許可を求めます。シークレットの使用を許可するには **Allow** を、停止するには **Deny** を選択します。