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

# Xuất bản

> Đưa Agent lên một phiên bản chạy thật, chọn nơi Agent phục vụ và ghi lại những gì đã thay đổi

Khi Agent đã sẵn sàng, xuất bản để tạo ra một phiên bản chạy thật. Bạn có thể xuất bản nhiều lần; mỗi lần xuất bản tạo ra một phiên bản mới, và bạn chọn phiên bản nào đang phục vụ ở từng kênh triển khai.

<Info icon="rocket">
  Trước khi xuất bản, Agent chỉ chạy trong màn hình thử nghiệm của bạn. Sau khi xuất bản, Agent mới thực sự trả lời người dùng qua Agent Workspace hoặc qua các kênh ngoài.
</Info>

## Mở hộp thoại xuất bản

<Steps>
  <Step title="Mở Agent và vào tab Dựng Agent">
    Ở góc trên bên phải, bấm nút **Publish**.
  </Step>

  <Step title="Đọc lại thông tin phiên bản">
    Hộp thoại hiển thị số thay đổi, số hiệu phiên bản và nơi Agent sẽ phục vụ.
  </Step>

  <Step title="Bấm Publish để hoàn tất">
    Agent được đóng gói thành một phiên bản cố định. Phiên bản này không thay đổi nữa, kể cả khi bạn tiếp tục sửa Agent.
  </Step>
</Steps>

<img src="https://mintcdn.com/fpt-62e894b4/ia7V2FSrpeYV4o83/images/pub_dialog.jpg?fit=max&auto=format&n=ia7V2FSrpeYV4o83&q=85&s=531b6de02543f2a7c1b1197763bdf0f1" alt="Hộp thoại xuất bản" width="1568" height="706" data-path="images/pub_dialog.jpg" />

## Các phần trong hộp thoại

### Changes - Danh sách thay đổi

Phần **Changes** liệt kê mọi thay đổi kể từ phiên bản trước: Instructions, Model, Kỹ năng, Kết nối, Guardrails, Agent hỗ trợ... Bấm vào tiêu đề để mở rộng và xem chi tiết. Con số bên cạnh cho biết có bao nhiêu thay đổi sẽ được đóng gói vào phiên bản này.

### Version - Số hiệu phiên bản

Lần xuất bản đầu tiên luôn là **v1.0.0**. Từ lần thứ hai trở đi, bạn tự chọn mức tăng:

| Mức tăng | Khi nào dùng | Ví dụ |
| - | - | - |
| **Patch** | Sửa lỗi nhỏ, chỉnh câu chữ, không đổi hành vi | v1.0.0 thành v1.0.1 |
| **Minor** | Thêm kỹ năng, thêm kết nối, bổ sung hướng dẫn | v1.0.1 thành v1.1.0 |
| **Major** | Thay đổi lớn về vai trò hoặc cách Agent làm việc | v1.1.0 thành v2.0.0 |

### Release notes - Ghi chú phát hành

Ô ghi chú cho phép nhập tối đa 2.000 ký tự. Đây là nội dung người dùng Agent sẽ đọc, nên hãy viết ngắn gọn theo hướng "phiên bản này có gì mới".

<Tip icon="wand-magic-sparkles">
  Bấm **Write from changes** để hệ thống tự soạn ghi chú từ danh sách thay đổi. Bạn vẫn sửa lại được trước khi xuất bản.
</Tip>

### Publish to - Nơi Agent phục vụ

Tích vào **Publish to** để mở rộng phần chọn nơi phục vụ. Khi Agent chưa từng được xuất bản, huy hiệu bên cạnh hiển thị **Not published**.

<img src="https://mintcdn.com/fpt-62e894b4/ia7V2FSrpeYV4o83/images/pub_targets.jpg?fit=max&auto=format&n=ia7V2FSrpeYV4o83&q=85&s=6c1cea27bbe3e403a418c5e76657cc0b" alt="Chọn nơi Agent phục vụ" width="1568" height="706" data-path="images/pub_targets.jpg" />

## Xuất bản lên Agent Workspace

Agent Workspace là nơi người dùng nội bộ trò chuyện với Agent. Chọn một trong ba phạm vi sau.

### Only me - Chỉ mình tôi

Chỉ bạn dùng được Agent. Agent được thêm thẳng vào mục **My agents** trong Workspace.

Dùng phạm vi này khi Agent còn đang hoàn thiện, hoặc khi Agent phục vụ đúng công việc cá nhân của bạn.

### Company / department - Công ty hoặc phòng ban

Chia sẻ Agent cho cả một công ty, một phòng ban, hoặc một số nhân sự được chọn.

Khi chọn phạm vi này, một cây tổ chức sẽ mở ra:

<Steps>
  <Step title="Tìm nhanh bằng ô tìm kiếm">
    Gõ tên công ty, phòng ban hoặc tên người vào ô **Search companies, departments or people**.
  </Step>

  <Step title="Tích chọn theo cấp">
    Tích ở cấp công ty để chia sẻ cho toàn bộ công ty. Tích ở cấp phòng ban để chia sẻ cho riêng phòng ban đó. Con số bên cạnh mỗi dòng là số nhân sự thuộc phạm vi đó.
  </Step>

  <Step title="Mở rộng để chọn từng người">
    Bấm mũi tên ở một phòng ban để xem danh sách nhân sự và tích chọn từng người.
  </Step>
</Steps>

<img src="https://mintcdn.com/fpt-62e894b4/ia7V2FSrpeYV4o83/images/pub_company_tree_v2.jpg?fit=max&auto=format&n=ia7V2FSrpeYV4o83&q=85&s=864818771ea52c434dcdaffa95c1f1cb" alt="Cây tổ chức khi chia sẻ Agent" width="1568" height="706" data-path="images/pub_company_tree_v2.jpg" />

<Note>
  Bạn có thể kết hợp nhiều lựa chọn trong cùng một lần xuất bản, ví dụ chọn cả một phòng ban và thêm vài người ở phòng ban khác.
</Note>

### FPT AI Agent community - Cộng đồng FPT AI Agent

Xuất bản Agent cho mọi người dùng FPT AI Agent, bao gồm cả người ngoài công ty bạn.

<Warning>
  Đây là phạm vi rộng nhất. Hãy rà lại Instructions, dữ liệu trong Kỹ năng và Guardrails trước khi chọn, để chắc chắn Agent không để lộ thông tin nội bộ.
</Warning>

## Xuất bản lên kênh ngoài

Phần **External channels** liệt kê các kênh bên ngoài Workspace. Tích chọn kênh nào thì phiên bản vừa xuất bản sẽ phục vụ ở kênh đó.

### Kênh đã hỗ trợ

<CardGroup cols={3}>
  <Card title="Web widget" icon="globe" href="/kenh-live-chat">
    Khung chat nổi nhúng vào website của bạn. Cấu hình ở tab Channels.
  </Card>

  <Card title="API" icon="code" href="/tich-hop-api">
    Gọi Agent trực tiếp từ hệ thống của bạn. Cấu hình ở tab Channels.
  </Card>

  <Card title="Zalo" icon="comment-dots" href="/kenh-zalo">
    Official Account trả lời khách tự động. Cấu hình ở tab Channels.
  </Card>
</CardGroup>

### Kênh sắp có

Ba kênh dưới đây hiển thị trong khối **Not available yet** để bạn hình dung lộ trình, hiện 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>

<Info icon="sliders">
  Hộp thoại xuất bản chỉ bật hoặc tắt kênh. Mọi thiết lập chi tiết của kênh nằm ở tab **Channels**. Bấm **Manage** ở góc dưới bên phải để đi thẳng sang đó, hoặc xem [Quản lý kênh triển khai](/quan-ly-kenh-trien-khai).
</Info>

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

Phần trên là hướng dẫn bật và cấu hình kênh ngay 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>

## Xuất bản phiên bản đầu tiên

<img src="https://mintcdn.com/fpt-62e894b4/vc1HifpBTpQOuJhR/images/publish_first_version.jpg?fit=max&auto=format&n=vc1HifpBTpQOuJhR&q=85&s=d32043a44b58ff9577b27ba547a5486c" alt="Xuất bản phiên bản đầu tiên" width="1470" height="623" data-path="images/publish_first_version.jpg" />

Lần đầu tiên, hộp thoại ghi rõ "First release - v1.0.0 becomes the version you serve". Bạn không cần chọn mức tăng, chỉ cần viết ghi chú phát hành và chọn nơi phục vụ, rồi bấm **Publish v1.0.0**.

## Xuất bản phiên bản tiếp theo

<img src="https://mintcdn.com/fpt-62e894b4/vc1HifpBTpQOuJhR/images/publish_next_version.jpg?fit=max&auto=format&n=vc1HifpBTpQOuJhR&q=85&s=508374306ad824b25a4b1ded45ac565e" alt="Xuất bản phiên bản tiếp theo" width="1470" height="623" data-path="images/publish_next_version.jpg" />

<Steps>
  <Step title="Mở lại hộp thoại xuất bản">
    Bấm **Publish** ở góc trên bên phải tab Dựng Agent.
  </Step>

  <Step title="Chọn mức tăng phiên bản">
    Chọn Patch, Minor hoặc Major theo mức độ thay đổi.
  </Step>

  <Step title="Viết ghi chú phát hành">
    Nhập tay, hoặc bấm **Write from changes** rồi chỉnh lại.
  </Step>

  <Step title="Rà lại nơi phục vụ">
    Kiểm tra lại phạm vi Agent Workspace và các kênh ngoài đang được tích chọn.
  </Step>

  <Step title="Bấm Publish để phát hành">
    Phiên bản mới được tạo. Các phiên bản cũ vẫn được giữ lại và có thể đưa trở lại phục vụ.
  </Step>
</Steps>

## Sau khi xuất bản

<CardGroup cols={2}>
  <Card title="Quản lý kênh triển khai" icon="tower-broadcast" href="/quan-ly-kenh-trien-khai">
    Xem kênh nào đang chạy, phiên bản nào đang phục vụ ở từng kênh và đổi phiên bản khi cần.
  </Card>

  <Card title="Kênh Live Chat" icon="comments" href="/kenh-live-chat">
    Nhúng Agent vào website: whitelist domain, đường dẫn chia sẻ và tùy biến giao diện widget.
  </Card>

  <Card title="Kênh Zalo" icon="comment-dots" href="/kenh-zalo">
    Kết nối Official Account để Agent tự động trả lời tin nhắn trên Zalo.
  </Card>

  <Card title="Lịch sử phiên bản" icon="clock-rotate-left" href="/quan-ly-kenh-trien-khai">
    Mọi phiên bản đã xuất bản đều được lưu lại kèm ghi chú phát hành.
  </Card>
</CardGroup>


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