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

# デプロイチャネルの管理

> Agent がどこで動いているか、チャネルごとにどのバージョンが稼働しているかを確認し、必要なら切り替えます

**チャネル** タブには、Agent に届くすべての場所が集まります。Agent Workspace と外部チャネルです。どのチャネルが稼働中で、どれが未設定で、それぞれどのバージョンが動いているかが分かります。

## 統合のアーキテクチャ

エンドユーザーの前に Agent を出すチャネルは 2 つあります。どちらも同じ Agent、同じナレッジベース、同じ会話履歴を共有し、違うのはチャット画面を誰が持つかだけです。

```mermaid theme={null}
flowchart LR
  subgraph KH["お客様側のシステム"]
    U1["利用者<br/>ブラウザ / アプリ"]
    W["自社サイト<br/>+ 埋め込みウィジェット"]
    U2["利用者<br/>Zalo、アプリ、自社サイト"]
    CA["自社の基幹アプリ"]
    WH["自社の Webhook サーバー"]
  end
  subgraph FPT["FPT AI Agent Platform"]
    BFF["direct-bff<br/>Visitor API + SSE"]
    CG["channel-gateway<br/>Webhook Server"]
    MD["Message Dispatching"]
    AG["AI Agents<br/>agent-runtime, llm-gateway, knowledge"]
  end
  U1 --> W
  W -->|HTTPS / SSE| BFF
  BFF -->|gRPC| AG
  U2 --> CA
  CA -->|HTTPS| CG
  CG --> AG
  AG --> MD
  MD -->|Callbacks| WH
  WH --> U2
```

<CardGroup cols={2}>
  <Card title="Live Chat チャネル" icon="comments" href="/ja/live-chat-channel">
    チャット画面はこちらが提供します。自社サイトに埋め込みコードを貼るか、モバイルアプリで SDK を呼び出します。
  </Card>

  <Card title="API チャネル" icon="code" href="/ja/api-integration">
    いま使っているチャット画面をそのまま使います。顧客のメッセージは Webhook でこちらに送られ、回答はコールバックで自社の Webhook に返ります。
  </Card>
</CardGroup>

## チャネルタブを開く

Agent を開き、ナビゲーションバーから **チャネル** を選びます。見出しには「この Agent が動いている場所と、稼働中のバージョン」と出ます。

<img src="https://mintcdn.com/fpt-62e894b4/OEIa1zuMs6GjYr6X/images/en_ch_overview.jpg?fit=max&auto=format&n=OEIa1zuMs6GjYr6X&q=85&s=de8518ce7dca02fed5d10ac920752524" alt="何も設定していない状態のチャネルタブ" width="1562" height="784" data-path="images/en_ch_overview.jpg" />

### 稼働中のチャネル

**稼働中のチャネル** の数は、実際に利用者に応答しているチャネルの数です。0 は何も動いていないという意味で、チャネルを設定済みかどうかとは関係ありません。

**ビルドへ移動** ボタンを押すと Agent ビルダータブに戻り、最初のバージョンを公開できます。

## Agent Workspace

**Agent Workspace** のブロックには、Workspace の中で Agent が誰に開かれているかが出ます。

一度も公開していない Agent では、このブロックは空のまま、こう案内します。「公開済みのバージョンがありません。先にビルドタブでバージョンを公開してから、ここで公開範囲を設定してください。」

公開後は、選んだ共有範囲(自分だけ、会社や部門、FPT AI Agent コミュニティ)と、いま稼働しているバージョンが表示されます。詳しくは [公開](/ja/publishing) のページへ。

## 外部チャネル

**外部チャネル** のブロックには、Workspace の外のチャネルと、その設定状態が並びます。

<img src="https://mintcdn.com/fpt-62e894b4/OEIa1zuMs6GjYr6X/images/en_ch_overview.jpg?fit=max&auto=format&n=OEIa1zuMs6GjYr6X&q=85&s=de8518ce7dca02fed5d10ac920752524" alt="外部チャネルの一覧" width="1562" height="784" data-path="images/en_ch_overview.jpg" />

<CardGroup cols={3}>
  <Card title="Web ウィジェット" icon="globe" href="/ja/live-chat-channel">
    自社サイトでのライブチャット。初期状態は未設定です。
  </Card>

  <Card title="API" icon="code" href="/ja/api-integration">
    自社システムから直接呼び出します。初期状態は未設定です。
  </Card>

  <Card title="Zalo" icon="comment-dots" href="/ja/zalo-channel">
    Official Account。初期状態は未設定です。
  </Card>
</CardGroup>

<Warning>
  ここでチャネルを設定しても、Agent が未公開のままでは誰にも応答しません。問い合わせた顧客には「この会話は利用できません」と表示されます。先に設定しておくこと自体は問題ありません。Agent ビルダータブに戻って公開するのを忘れないでください。
</Warning>

### まだ使えないチャネル

**未提供** のブロックには、予定にあるメッセージングチャネルが並びます。何が来るか分かるように表示しているだけで、設定はできません。

<CardGroup cols={3}>
  <Card title="Messenger" icon="facebook-messenger">
    Facebook ページが Agent を通じて顧客に応答します。
  </Card>

  <Card title="WhatsApp" icon="whatsapp">
    WhatsApp Business の番号が Agent を通じて顧客に応答します。
  </Card>

  <Card title="Telegram" icon="telegram">
    Telegram のボットが Agent を通じて顧客に応答します。
  </Card>
</CardGroup>

## デプロイチャネルを追加する

<Steps>
  <Step title="設定するチャネルを選ぶ">
    外部チャネルのブロックで、**未設定** と付いたチャネルをクリックします。
  </Step>

  <Step title="設定を入力する">
    チャネルごとに必要な項目が違います。[Live Chat チャネル](/ja/live-chat-channel) や [Zalo チャネル](/ja/zalo-channel) を参照してください。
  </Step>

  <Step title="保存する">
    Web ウィジェットなら **設定を保存**、Zalo なら **接続** をクリックします。チャネルが未設定から設定済みに変わります。
  </Step>

  <Step title="公開時にチャネルをオンにする">
    Agent ビルダータブに戻り、**Publish** をクリックして、外部チャネルの中でそのチャネルにチェックを入れて公開します。
  </Step>
</Steps>

## チャネルごとに稼働バージョンを選ぶ

チャネルごとに別のバージョンを動かせます。たとえばサイトは安定した v1.0.1 のまま、Zalo だけ先に v1.0.2 を動かす、といった使い方です。

<img src="https://mintcdn.com/fpt-62e894b4/OEIa1zuMs6GjYr6X/images/en_ch_overview.jpg?fit=max&auto=format&n=OEIa1zuMs6GjYr6X&q=85&s=de8518ce7dca02fed5d10ac920752524" alt="デプロイチャネルの一覧" width="1562" height="784" data-path="images/en_ch_overview.jpg" />

<Steps>
  <Step title="変えたいチャネルを開く">
    チャネルタブで、稼働中のチャネルをクリックします。
  </Step>

  <Step title="バージョンの一覧を開く">
    リリースのセレクターをクリックします。公開済みのバージョンが、公開日とリリースノートとともに並びます。
  </Step>

  <Step title="動かすバージョンを選ぶ">
    いま動いているものには **稼働中** と付いています。別のものを選ぶと切り替わります。
  </Step>

  <Step title="確定する">
    リリースのボタンをクリックすると反映されます。見ていただけなら **キャンセル** を押してください。
  </Step>
</Steps>

<img src="https://mintcdn.com/fpt-62e894b4/OEIa1zuMs6GjYr6X/images/en_version_history.jpg?fit=max&auto=format&n=OEIa1zuMs6GjYr6X&q=85&s=5fc4232df3755e4db058c03bba341029" alt="チャネルのリリースを選ぶ" width="1562" height="784" data-path="images/en_version_history.jpg" />

<Tip>
  新しいバージョンの回答がよくないので戻したい、というときも、同じ一覧から以前のバージョンを選ぶだけです。公開したバージョンは常に残ります。
</Tip>

## チャネルの設定を編集する

設定済みのチャネルをクリックすると設定が開きます。必要なところを変えて保存してください。Web ウィジェットの見た目の変更は、コードを貼ったすべての場所にすぐ反映されます。貼り直す必要はありません。

## 技術統合のドキュメント

このページは、Console の中でチャネルを有効にし、管理する話です。開発チームがより深く組み込む場合は、統合ドキュメント一式を参照してください。

<CardGroup cols={2}>
  <Card title="Live Chat チャネル" icon="code" href="/ja/live-chat-channel">
    埋め込みコード、ウィジェットのカスタマイズ、共有リンク、自前の画面を作るチーム向けの Visitor API。
  </Card>

  <Card title="モバイル SDK" icon="mobile-screen" href="/ja/mobile-sdk">
    Android と iOS のアプリにチャット画面を組み込みます。
  </Card>

  <Card title="API 連携" icon="key" href="/ja/api-integration">
    Webhook、HMAC 署名、コールバック、会話履歴の読み込み、API キー。
  </Card>

  <Card title="技術付録" icon="table-list" href="/ja/technical-appendix">
    エラーコード表、システムの上限、本番前チェックリスト。
  </Card>
</CardGroup>

## チャネルを切り離す

チャネルでの応答を止める方法は 2 つあります。

<CardGroup cols={2}>
  <Card title="公開時にオフにする" icon="toggle-off">
    **Publish** ダイアログを開き、外部チャネルでそのチャネルのチェックを外して公開します。設定は残ったまま、応答だけ止まります。
  </Card>

  <Card title="完全に切断する" icon="link-slash">
    チャネルの設定パネルを開いて切断します。接続情報が消えるので、戻すときは入力し直しになります。
  </Card>
</CardGroup>

<Note>
  切断すると、上の **稼働中のチャネル** の数がその分減ります。変更のたびにこの数字を確認して、意図したところだけで Agent が動いていることを確かめてください。
</Note>


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