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

# 外部エージェントを接続する

> FPT AI Platform の外ですでに動いている Digital Worker を Workspace に取り込む。接続を登録し、検証を通し、ほかの Digital Worker と同じように管理します

すでに自社の環境で Digital Worker を動かしていて、ここで作り直したくはない。そんなときに、その Digital Worker を Workspace に登録する方法です。管理、デプロイチャネル、レポートはプラットフォームが受け持ち、考える部分はあなたの側に残ります。

> [!NOTE]
>
> Console の左メニュー、**構築** グループの **外部エージェント** から開きます。

## こんなときに向いています

* Digital Worker がすでに自社の環境、たとえば n8n、LangGraph、社内サービス、パートナー製品の上で動いている。
* Digital Worker のロジックを書き直さずに、Workspace とデプロイチャネルとレポートだけを使いたい。
* データを自分で握っておきたい。知識と処理は自社のインフラの中にとどまります。

プラットフォームの上で Digital Worker を作るなら、代わりに **マイDigital Worker** を使ってください。

## 始める前に用意するもの

| もの | 理由 |
| - | - |
| Base URL | Digital Worker のルートアドレス。たとえば `https://agent.acme.com/ai`。プラットフォームはその下の `/health` と `/runs` を呼びます |
| `fpt-v1` の規約 | Digital Worker がプラットフォームのプロトコル `fpt-v1` を話せること。これは Digital Worker を作ったチームの担当範囲です |
| 認証情報 | 呼び出し元を確認するシステムであれば、プラットフォームが送るべきヘッダーと値 |

> [!NOTE]
>
> 一覧画面の右上にある **統合ガイド** ボタンは、パートナー側のエンジニア向けに書かれています。このフォームを埋めるだけなら、先方から渡される Base URL と認証情報があれば足ります。

> [!NOTE]
>
> パートナー側のエンジニアは [External Agent の技術要件](https://docs-eos.fpt.ai/eos/ja/external-agent-requirements.md) を読んでください。2 つのエンドポイント、認証、レスポンスストリームの形式、守るべき時間制限がすべて書いてあります。

## Digital Worker を登録する

**1. 外部エージェントを開く**

Console の左メニュー、**構築** グループです。

**2. 外部エージェントを接続を押す**

右上の青いボタンです。まだ 1 件もない場合は、同じボタンが画面の中央にあります。

**3. 接続情報を入れる**

Digital Worker 名、説明、Base URL、そしてプラットフォームがどう認証するか。各項目は下で説明します。

**4. 接続を検証を押す**

プラットフォームがあなたのシステムを呼び、5 つの検証を行います。すべて通るまで保存は押せません。

**5. 保存を押す**

Digital Worker が **下書き** として作られ、Console が詳細ページを開きます。保存を押すまで何も書き込まれません。

![外部エージェントを接続するフォーム](https://mintcdn.com/fpt-15dbd015/38Dm9D-hll-psE1A/images/eos/ja_ext_form.jpg?fit=max\&auto=format\&n=38Dm9D-hll-psE1A\&q=85\&s=4068c4396be6b8d931ad9fdaa0b402a1)

### 入力項目

| 項目 | 必須 | 内容 | 例 |
| - | - | - | - |
| Digital Worker 名 | はい | 一覧やチャネルで表示される名前。60 文字まで | 倉庫アシスタント |
| 説明 | いいえ | 何をする Digital Worker で、どんなときに使うか。200 文字まで | 在庫数と注文状況を照会します |
| Base URL | はい | Digital Worker のルートアドレス。https と http のどちらも受け付けます | `https://agent.acme.com/ai` |
| 認証 | はい | **認証あり** か **認証なし** | 認証あり |
| 認証ヘッダー | 認証ありの場合は必須 | ヘッダー名と値。**ヘッダーを追加** で増やせます | `Authorization` / `Bearer abc123` |

> [!WARNING]
>
> Base URL は `http` も受け付けますが、その場合、認証情報が平文で流れます。`http` は社内のパートナー向けにとどめ、それ以外では `https` を使ってください。

### 2 つの認証方式

* **認証あり**: プラットフォームは入力したとおりのヘッダーを送り、自分では何も足しません。ベアラートークンを使うなら、値の前に `Bearer ` を自分で書いてください。値は保存され、二度と表示されません。
* **認証なし**: プラットフォームは何も送りません。IP 範囲などの別の方法でパートナー側がすでにアクセスを制限している場合にだけ選んでください。

### 5 つの検証

![5 つの接続検証](https://mintcdn.com/fpt-15dbd015/ZZ_AlSQhekpFaExV/images/eos/en_ext_check.jpg?fit=max\&auto=format\&n=ZZ_AlSQhekpFaExV\&q=85\&s=459ddf9984f5f2b98cc6bfc08ad3cc80)

| 検証 | 確かめること |
| - | - |
| エンドポイントに到達できる | Digital Worker がヘルスチェックに応答した |
| パートナーが認証情報を受け入れた | 送った内容をあなたのシステムが受け付けた |
| パートナーが `fpt-v1` に対応している | Digital Worker がプラットフォームのプロトコルを話せる |
| 認証情報が保存された | 認証情報が保存済み。公開はこれを待ちます |
| Digital Worker が実際の 1 ターンに応答した | プラットフォームが `/runs` に 1 ターン送り、Digital Worker が規約どおりに応答した。ヘルスチェックだけでは分からない部分です |

一覧の下には、パートナー側が名乗る名前とバージョン、そして往復にかかった時間が表示されます。失敗した検証は理由を説明するので、フォームを直して **接続を検証** をもう一度押してください。

## 接続済み Digital Worker の一覧

![外部エージェントの一覧](https://mintcdn.com/fpt-15dbd015/ZZ_AlSQhekpFaExV/images/eos/en_ext_list.jpg?fit=max\&auto=format\&n=ZZ_AlSQhekpFaExV\&q=85\&s=4f005510eea7a0dc1dcaf0043b1f1841)

Digital Worker ごとに、名前、状態、説明、最終更新を載せたカードが並びます。上のフィルタは状態ごとの件数を示します。**すべて**、**下書き**、**公開済み**、**一時停止**。右の **Digital Worker を検索** は名前で絞り込みます。

## Digital Worker の中身

![外部エージェントの詳細ページ](https://mintcdn.com/fpt-15dbd015/ZZ_AlSQhekpFaExV/images/eos/en_ext_detail.jpg?fit=max\&auto=format\&n=ZZ_AlSQhekpFaExV\&q=85\&s=3f195f820a5ed233a001251aaf0755c2)

詳細ページには 4 つのタブがあります。**ビルド**、**テスト**、**チャネル**、**インサイト**。

接続の情報は **ビルド** タブにあります。

| 行 | 分かること |
| - | - |
| Base URL | 使用中のアドレス |
| 認証 | 認証ありかどうか |
| 認証情報 | 保存済みか、不要か |
| ヘルス | 直近の検証結果と **再確認** ボタン |

**エンドポイント** の表には、プラットフォームが Digital Worker に対して呼ぶアドレスと、それぞれの状態が並びます。`/health` と `/runs` は必須で、残りは任意、この段階では無効です。

## 接続が動き出したあと

ここから先、外部エージェントはプラットフォーム上で作った Digital Worker とまったく同じように振る舞います。

* **テスト** タブは実際に 1 ターン送るので、ほかの人より先に回答を読めます。
* **チャネル** タブで Workspace の公開範囲と、外部のチャネル(Web ウィジェット、API、Zalo)を選びます。
* 右上の **Publish** でバージョンを稼働させます。

この 3 つは通常の Digital Worker とまったく同じなので、[公開](https://docs-eos.fpt.ai/eos/ja/publishing.md) と [デプロイチャネルの管理](https://docs-eos.fpt.ai/eos/ja/manage-channels.md) を参照してください。

## 編集、再検証、削除

**1. 接続を編集する**

詳細ページで **Publish** の横の鉛筆、または **接続を編集** ボタンを押します。Digital Worker を作ったときと同じダイアログで、保存前に同じ検証が走ります。

**2. 検証をやり直す**

接続カードの **再確認**、またはエンドポイント表の **今すぐ再確認**。**...** メニューの **今すぐ検証** も同じ動きで、詳細ページでも一覧のカードでも使えます。

**3. Digital Worker を削除する**

**...** メニューから **Digital Worker を削除** を選びます。Console が確認を求めます。

> [!WARNING]
>
> Base URL や認証情報を変えても、実際の利用者に届くのは再度公開してからです。Digital Worker を削除すると、稼働中のすべてのチャネルから外れ、会話の途中だった顧客は返答を受け取れなくなります。

## 次に読むもの

> **[デプロイチャネルの管理](https://docs-eos.fpt.ai/eos/ja/manage-channels.md)**
>
> Digital Worker を出すチャネルと公開範囲を選びます。

> **[Live Chat チャネル](https://docs-eos.fpt.ai/eos/ja/live-chat-channel.md)**
>
> 用意されたチャット画面で、自社サイトに Digital Worker を載せます。

> **[API 連携](https://docs-eos.fpt.ai/eos/ja/api-integration.md)**
>
> 自前のチャット画面がすでにある場合に。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.