> ## 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.

# Quản lý kênh triển khai

> Xem Agent đang phục vụ ở đâu, phiên bản nào đang chạy trên từng kênh và thay đổi khi cần

Tab **Channels** là nơi tập trung toàn bộ điểm chạm của Agent: Agent Workspace và các kênh ngoài. Ở đây bạn biết được kênh nào đang sống, kênh nào chưa cấu hình và phiên bản nào đang phục vụ ở từng kênh.

## Kiến trúc tích hợp

Nền tảng cung cấp hai kênh để đưa Agent tới khách hàng cuối. Hai kênh dùng chung một bộ Agent, một kho tri thức và một lịch sử hội thoại; chúng chỉ khác nhau ở chỗ ai sở hữu giao diện chat.

```mermaid theme={null}
flowchart LR
  subgraph KH["Hệ thống của khách hàng"]
    U1["Khách hàng<br/>trình duyệt / ứng dụng"]
    W["Website của bạn<br/>+ Widget nhúng"]
    U2["Khách hàng<br/>Zalo, app, web riêng"]
    CA["Core App của bạn"]
    WH["Webhook Server của bạn"]
  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="Kênh Live Chat" icon="comments" href="/kenh-live-chat">
    Chúng tôi cung cấp sẵn giao diện chat. Bạn dán một đoạn mã nhúng vào website, hoặc gọi SDK trong ứng dụng di động.
  </Card>

  <Card title="Kênh API" icon="code" href="/tich-hop-api">
    Bạn giữ nguyên giao diện chat sẵn có. Tin nhắn của khách được đẩy tới chúng tôi qua webhook; câu trả lời gửi ngược lại webhook của bạn bằng callback.
  </Card>
</CardGroup>

## Mở tab Channels

Mở Agent, chọn tab **Channels** trên thanh điều hướng của Agent. Đầu trang hiển thị dòng mô tả "Where this agent serves, and which version is running".

<img src="https://mintcdn.com/fpt-62e894b4/sAzvTCFJP3YW5VsB/images/ch_overview_empty.jpg?fit=max&auto=format&n=sAzvTCFJP3YW5VsB&q=85&s=2da369a185e41dc517ac37e0f336f344" alt="Tab Channels khi chưa cấu hình kênh nào" width="1568" height="706" data-path="images/ch_overview_empty.jpg" />

### Live channels

Con số **Live channels** cho biết đang có bao nhiêu kênh thực sự phục vụ người dùng. Khi con số bằng 0, nghĩa là chưa có kênh nào chạy, dù bạn đã cấu hình kênh hay chưa.

Nút **Go to Build** đưa bạn trở lại tab Dựng Agent để xuất bản phiên bản đầu tiên.

## Agent Workspace

Khối **Agent Workspace** cho biết Agent đang mở cho những ai trong Workspace.

Khi Agent chưa từng được xuất bản, khối này ở trạng thái rỗng với dòng nhắc: "No published version yet. Publish a version on the Build tab first, then come back here to open it to people."

Sau khi xuất bản, khối này hiển thị phạm vi chia sẻ đã chọn (chỉ mình bạn, công ty hoặc phòng ban, hoặc cộng đồng FPT AI Agent) và phiên bản đang phục vụ. Xem thêm ở trang [Xuất bản](/publish-agent).

## Kênh ngoài

Khối **External channels** liệt kê các kênh bên ngoài Workspace kèm trạng thái cấu hình.

<img src="https://mintcdn.com/fpt-62e894b4/sAzvTCFJP3YW5VsB/images/ch_overview.jpg?fit=max&auto=format&n=sAzvTCFJP3YW5VsB&q=85&s=69af546141aa4ef236766bb96c808f39" alt="Danh sách kênh ngoài" width="1568" height="706" data-path="images/ch_overview.jpg" />

<CardGroup cols={3}>
  <Card title="Web widget" icon="globe" href="/kenh-live-chat">
    Live chat trên website. Trạng thái ban đầu: Not configured.
  </Card>

  <Card title="API" icon="code" href="/tich-hop-api">
    Gọi trực tiếp từ hệ thống của bạn. Trạng thái ban đầu: Not configured.
  </Card>

  <Card title="Zalo" icon="comment-dots" href="/kenh-zalo">
    Official Account. Trạng thái ban đầu: Not configured.
  </Card>
</CardGroup>

<Warning>
  Một kênh được cấu hình ở đây vẫn chưa trả lời được ai nếu Agent chưa xuất bản: khách hàng nhắn vào sẽ nhận được thông báo "This conversation is unavailable". Cấu hình trước vẫn hợp lệ, nhưng hãy nhớ quay lại tab Dựng Agent để xuất bản.
</Warning>

### Kênh chưa mở

Khối **Not available yet** liệt kê các kênh nhắn tin đang trong lộ trình phát triển. Các kênh này hiển thị để bạn hình dung lộ trình, chưa bấm cấu hình được.

<CardGroup cols={3}>
  <Card title="Messenger" icon="facebook-messenger">
    Trang Facebook trả lời khách bằng Agent.
  </Card>

  <Card title="WhatsApp" icon="whatsapp">
    Số WhatsApp Business trả lời khách bằng Agent.
  </Card>

  <Card title="Telegram" icon="telegram">
    Bot Telegram trả lời khách bằng Agent.
  </Card>
</CardGroup>

## Thêm một kênh triển khai

<Steps>
  <Step title="Chọn kênh cần cấu hình">
    Trong khối External channels, bấm vào kênh đang ở trạng thái **Not configured**.
  </Step>

  <Step title="Điền thông tin cấu hình">
    Mỗi kênh có bộ thông tin riêng. Xem [Kênh Live Chat](/kenh-live-chat) hoặc [Kênh Zalo](/kenh-zalo).
  </Step>

  <Step title="Lưu cấu hình">
    Bấm **Save configuration** với Web widget, hoặc **Connect** với Zalo. Trạng thái kênh chuyển từ Not configured sang đã cấu hình.
  </Step>

  <Step title="Bật kênh khi xuất bản">
    Quay lại tab Dựng Agent, bấm **Publish**, tích kênh vừa cấu hình trong phần External channels rồi xuất bản.
  </Step>
</Steps>

## Chọn phiên bản phục vụ cho từng kênh

Mỗi kênh có thể chạy một phiên bản khác nhau. Ví dụ bạn có thể để website chạy phiên bản ổn định v1.0.1 trong khi Zalo đã chạy v1.0.2.

<img src="https://mintcdn.com/fpt-62e894b4/vc1HifpBTpQOuJhR/images/manage_channels.jpg?fit=max&auto=format&n=vc1HifpBTpQOuJhR&q=85&s=1346ad3a4348df7375c98ca1116456e4" alt="Danh sách kênh triển khai" width="1470" height="623" data-path="images/manage_channels.jpg" />

<Steps>
  <Step title="Mở kênh cần đổi phiên bản">
    Trong tab Channels, bấm vào kênh đang chạy.
  </Step>

  <Step title="Mở danh sách phiên bản">
    Bấm nút chọn phiên bản phát hành. Danh sách liệt kê mọi phiên bản đã xuất bản, kèm ngày phát hành và ghi chú.
  </Step>

  <Step title="Chọn phiên bản muốn phục vụ">
    Phiên bản đang chạy được đánh dấu **Đang phục vụ**. Chọn phiên bản khác nếu muốn đổi.
  </Step>

  <Step title="Xác nhận">
    Bấm nút phát hành để áp dụng. Bấm **Hủy** nếu chỉ muốn xem.
  </Step>
</Steps>

<img src="https://mintcdn.com/fpt-62e894b4/MLGg3fcpvPErRgBt/images/edit_channel.jpg?fit=max&auto=format&n=MLGg3fcpvPErRgBt&q=85&s=2882c1725fa9f4d70ea2587283c8d1bb" alt="Chọn phiên bản phát hành cho kênh" width="1470" height="623" data-path="images/edit_channel.jpg" />

<Tip>
  Cần quay lại phiên bản cũ vì phiên bản mới trả lời chưa tốt? Chọn lại phiên bản cũ trong danh sách này. Các phiên bản đã xuất bản luôn được giữ lại.
</Tip>

## Sửa cấu hình một kênh

Bấm vào kênh đã cấu hình để mở lại bảng thiết lập. Sửa các trường cần đổi rồi lưu lại. Với Web widget, thay đổi giao diện widget có hiệu lực ngay ở mọi nơi đã nhúng mã, không cần nhúng lại.

## Tài liệu tích hợp kỹ thuật

Trang này hướng dẫn bật và quản lý kênh trong Console. Khi đội kỹ thuật cần nhúng sâu vào hệ thống của bạn, xem bộ tài liệu tích hợp:

<CardGroup cols={2}>
  <Card title="Kênh Live Chat" icon="code" href="/kenh-live-chat">
    Mã nhúng, tùy biến widget, chia sẻ qua đường dẫn và Visitor API cho bên tự xây giao diện.
  </Card>

  <Card title="SDK di động" icon="mobile-screen" href="/sdk-di-dong">
    Đưa khung chat vào ứng dụng Android và iOS.
  </Card>

  <Card title="Tích hợp API" icon="key" href="/tich-hop-api">
    Webhook, ký HMAC, callback, đọc lại lịch sử hội thoại và khóa API.
  </Card>

  <Card title="Phụ lục kỹ thuật" icon="table-list" href="/phu-luc-ky-thuat">
    Bảng mã lỗi, bảng giới hạn hệ thống và danh mục kiểm tra trước Production.
  </Card>
</CardGroup>

## Ngắt một kênh

Có hai cách dừng phục vụ trên một kênh:

<CardGroup cols={2}>
  <Card title="Tắt kênh khi xuất bản" icon="toggle-off">
    Mở hộp thoại **Publish**, bỏ tích kênh đó trong phần External channels rồi xuất bản. Cấu hình của kênh vẫn được giữ, chỉ ngừng phục vụ.
  </Card>

  <Card title="Ngắt kết nối hẳn" icon="link-slash">
    Mở bảng cấu hình của kênh và ngắt kết nối. Cách này xóa thông tin kết nối, khi cần dùng lại bạn phải nhập lại từ đầu.
  </Card>
</CardGroup>

<Note>
  Sau khi ngắt, con số **Live channels** ở đầu trang giảm tương ứng. Hãy kiểm tra lại con số này mỗi lần thay đổi để chắc chắn Agent đang phục vụ đúng nơi bạn muốn.
</Note>


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