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

# エージェントビルダー

> エージェントの作成・編集方法

## エージェントビルダーとは

エージェントビルダーは、AI エージェントを作成・編集するための画面です。チャット形式で AI に指示を与えながら、エージェントの設定を行います。

<img src="https://mintcdn.com/carnot/ULP1fkXhkWwugjih/ja/pages/jinba_app/images/agents-builder.png?fit=max&auto=format&n=ULP1fkXhkWwugjih&q=85&s=9063a56b6a24682c823b5271a6a7b300" alt="エージェントビルダー画面" style={{ width: '100%', borderRadius: '8px', margin: '32px 0' }} width="2940" height="1642" data-path="ja/pages/jinba_app/images/agents-builder.png" />

<Warning>
  エージェントの作成・編集にはワークスペースのオーナー権限が必要です。
</Warning>

## エージェントビルダーを開く

### 新規作成の場合

<Steps>
  <Step title="エージェント管理画面を開く">
    サイドメニューから「エージェント」を選択します。
  </Step>

  <Step title="「新規作成」ボタンをクリック">
    画面上部の「新規作成」ボタンをクリックします。
  </Step>
</Steps>

### 既存エージェントの編集

<Steps>
  <Step title="エージェント一覧で編集対象を選択">
    編集したいエージェントの設定メニュー（⋮）から「編集」を選択します。
  </Step>
</Steps>

## 画面構成

エージェントビルダーは以下のエリアで構成されています：

| エリア          | 説明                |
| ------------ | ----------------- |
| **チャットエリア**  | AI との対話で指示を入力     |
| **設定パネル**    | エージェントの各種設定を表示・編集 |
| **プレビューエリア** | 設定結果のプレビュー        |

## チャットベースでの指示

エージェントビルダーでは、チャット形式で AI にエージェントの設定を指示できます。

### 指示の例

```
このエージェントは、Salesforce から商談データを取得して、
週次の営業レポートを作成するエージェントです。

レポートには以下の情報を含めてください：
- 今週の新規商談数
- 成約した商談の合計金額
- 次週のフォローアップが必要な商談リスト
```

AI が指示を解析し、適切な設定を提案します。

## コネクタの参照設定

エージェントで使用するコネクタを設定します。

<Steps>
  <Step title="コネクタ設定を開く">
    設定パネルの「コネクタ」セクションをクリックします。
  </Step>

  <Step title="コネクタを選択">
    利用可能なコネクタ一覧から、このエージェントで使用するコネクタにチェックを入れます。

    {/* TODO: スクリーンショット - コネクタ選択 */}
  </Step>

  <Step title="設定を保存">
    選択したコネクタがエージェントに関連付けられます。
  </Step>
</Steps>

<Note>
  コネクタを設定すると、このエージェントを使ったチャットで、選択したコネクタが自動的に利用可能になります。
</Note>

## ファイルの参照設定

エージェントが参照するファイルを設定します。

<Steps>
  <Step title="ファイル設定を開く">
    設定パネルの「ファイル」セクションをクリックします。
  </Step>

  <Step title="ファイルをアップロード">
    「ファイルを追加」ボタンをクリックし、参照させたいファイルをアップロードします。

    {/* TODO: スクリーンショット - ファイルアップロード */}
  </Step>

  <Step title="ファイルの確認">
    アップロードされたファイルが一覧に表示されます。
  </Step>
</Steps>

### 参照ファイルの活用例

* **FAQ ドキュメント**: 問い合わせ対応エージェントの回答の基になる情報
* **レポートテンプレート**: 出力形式のサンプル
* **業務マニュアル**: 手順や規則の参照

## エージェントの保存

設定が完了したら、エージェントを保存します。

<Steps>
  <Step title="エージェント名を入力">
    エージェントの名前を入力します（未入力の場合）。
  </Step>

  <Step title="説明を入力（任意）">
    エージェントの説明を入力します。一覧で表示されるため、わかりやすい説明を推奨します。
  </Step>

  <Step title="「保存」ボタンをクリック">
    画面上部の「保存」ボタンをクリックして保存します。
  </Step>
</Steps>

## エージェントの実行（テスト）

保存前または保存後に、エージェントをテスト実行できます。

<Steps>
  <Step title="「実行」ボタンをクリック">
    エージェントビルダーの「実行」ボタンをクリックします。
  </Step>

  <Step title="チャット画面でテスト">
    エージェントの設定が適用されたチャット画面が開きます。実際に質問を送信して動作を確認できます。
  </Step>
</Steps>

<Note>
  テスト実行で問題がなければ、保存して公開の準備を進めましょう。
</Note>

## トラブルシューティング

<AccordionGroup>
  <Accordion title="指示が反映されない">
    * 指示をより具体的に記述してみてください
    * AI が理解しやすい形式で入力してください
  </Accordion>

  <Accordion title="コネクタが選択できない">
    * コネクタがインストールされているか確認してください
    * コネクタの接続状態を確認してください
  </Accordion>

  <Accordion title="ファイルがアップロードできない">
    * ファイル形式が対応しているか確認してください
    * ファイルサイズが上限を超えていないか確認してください
  </Accordion>
</AccordionGroup>