> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Tham chiếu cài đặt tác nhân AI thoại
> Giải thích mọi cài đặt tác nhân AI thoại của ThunderPhone: gói, giọng nói, ngôn ngữ, xác nhận, công cụ, thứ tự nói, thư thoại, thông báo xin phép, xử lý im lặng, kiểm thử và triển khai.
Mở **Tác nhân AI thoại**, chọn một tác nhân AI và dùng tab **Cấu hình** để kiểm soát
cách tác nhân AI phát âm, suy luận, bắt đầu cuộc gọi, sử dụng công cụ, xử lý khoảng lặng và hộp thư thoại,
cũng như liên hệ người gọi. Thay đổi tự động lưu vào bản nháp; lưu lượng thực tế không
thay đổi cho đến khi bạn chọn **Triển khai**.
Trang này là tài liệu tham khảo đầy đủ về dashboard. Để xem tên trường và ví dụ
yêu cầu, hãy dùng [tài liệu tham khảo API Tác nhân AI](/api-reference/agents).
## Prompt và danh tính
Tên tác nhân AI dùng để nhận diện tác nhân AI trên toàn bộ dashboard, báo cáo, lịch sử cuộc gọi,
và cổng khách hàng. Prompt là kịch bản vận hành của tác nhân AI: cá tính,
thông tin doanh nghiệp, câu hỏi bắt buộc, chính sách chuyển tuyến và hành động cuộc gọi.
Trình chỉnh sửa prompt hiển thị số token ước tính và đánh dấu các vấn đề phổ biến như
prompt trống, phần giữ chỗ mẫu chưa được giải quyết, thiếu đường chuyển tuyến hoặc
prompt quá dài. **5.000 token ước tính đầu tiên** được bao gồm; prompt dài hơn áp dụng
[giá phụ thu theo khối](/vi/guides/pricing).
Bạn có thể viết trực tiếp việc chuyển cuộc gọi, bấm phím, cách xử lý chờ và quyết định ngắt cuộc gọi
vào prompt. Đính kèm công cụ API, ứng dụng, MCP hoặc kiến thức khi tác nhân AI
cần dữ liệu hoặc hành động bên ngoài.
## Gói mô hình
| Gói | Giá cơ bản | Phù hợp nhất |
| --------- | ---------: | ----------------------------------------------- |
| **Spark** | 2¢/phút | Cuộc gọi đơn giản, cần tối ưu chi phí. |
| **Bolt** | 5¢/phút | Phản hồi nhanh và quy trình hằng ngày cân bằng. |
| **Storm** | 9¢/phút | Hướng dẫn phức tạp, hiểu âm thanh và suy luận. |
Storm cung cấp hai tùy chọn điều khiển:
* **Xác nhận** — **Không có** sẽ im lặng khi chuẩn bị phản hồi đầy đủ;
**Tích tắc** phát âm thanh chờ nhẹ; **Bằng lời nói** đưa ra xác nhận ngắn
và thêm **2¢/phút**. Văn bản xác nhận bằng lời nói có thể được tạo từ prompt chính hoặc
cung cấp thủ công qua API.
* **Suy luận bổ sung** — thêm khả năng suy luận sâu hơn cho cuộc gọi phức tạp và
**3¢/phút**.
Trình tạo liên tục hiển thị **tổng chi phí mỗi phút** của tác nhân AI, bao gồm
gói, đường dẫn giọng nói/ngôn ngữ, độ dài prompt, xác nhận bằng lời nói, suy luận bổ sung
và giám sát.
## Giọng nói, âm nền và ngôn ngữ
Chọn giọng nói và phát mẫu của giọng nói đó trước khi triển khai. Bộ chọn chỉ cung cấp
các giọng nói tương thích với mọi ngôn ngữ đã chọn và đánh dấu các kết hợp cao cấp
cùng khoản phụ thu. Giọng nói tùy chỉnh của bạn xuất hiện trong cùng bộ chọn sau khi sẵn sàng.
Xem [Thư viện giọng nói và giọng nói tùy chỉnh](/vi/guides/voice-library).
**Nhạc nền** có thể là:
* **Không có** — không có âm thanh môi trường.
* **Tổng đài** — âm thanh môi trường của tổng đài, có bản xem trước trong dashboard.
Đặt một **ngôn ngữ chính**, sau đó thêm số lượng bất kỳ **ngôn ngữ bổ sung**. Tác nhân AI
tự động phát hiện khi người gọi chuyển sang ngôn ngữ đã chọn và phản hồi bằng ngôn ngữ đó.
Một số kết hợp giọng nói/ngôn ngữ thêm **3¢/phút**; xem danh mục
[Ngôn ngữ được hỗ trợ](/vi/guides/supported-languages) được tạo tự động.
## Khả năng đã kết nối
Tab Cấu hình có bốn phần khả năng có thể đính kèm độc lập:
| Phần | Dùng cho |
| ----------------------- | ------------------------------------------------------------------------------------------------------ |
| **Ứng dụng đã kết nối** | Thao tác được phê duyệt trong Google Calendar, Google Sheets, Slack, HubSpot, Salesforce hoặc Cal.com. |
| **Kết nối API** | Điểm cuối HTTP của riêng bạn, được mô tả dưới dạng hàm có thể gọi. |
| **Kiến thức** | Tệp hoặc nội dung web mà tác nhân AI có thể tìm kiếm trong cuộc gọi. |
| **Máy chủ MCP** | Công cụ được lưu đệm, phát hiện từ máy chủ Model Context Protocol từ xa. |
Một mục đính kèm là một phần của bản nháp và sẽ khả dụng cho cuộc gọi thực tế
sau khi triển khai. Trước tiên, hãy cấu hình tài nguyên trong **Kết nối** hoặc
**Kiến thức**, sau đó đính kèm chúng vào tác nhân AI.
## Điểm cuối điện thoại và web
Trong **Số điện thoại**, hãy đính kèm một số hiện có, cấp một số demo hoặc
nhập một số qua kết nối VoIP. Một số có thể sử dụng các tác nhân AI khác nhau
cho chiều gọi đến và gọi đi.
Trong **Tiện ích web**, hãy đính kèm một tiện ích để khách truy cập có thể nói chuyện với tác nhân AI từ
một trang web. Bạn cũng có thể bật hoặc tắt khả năng sử dụng tiện ích như một phần của cấu hình tác nhân AI.
## Hành vi cuộc gọi nâng cao
Mở rộng **Nâng cao** ở cuối mục Cấu hình để dùng các tùy chọn sau.
### Giám sát
Khi được bật, một tác nhân AI giám sát thứ hai sẽ kiểm tra từng lượt của tác nhân theo
hướng dẫn và có thể can thiệp một cách im lặng. Giám sát thêm **8¢/phút** và không
khả dụng trên Bolt.
### Âm báo kết nối
Phát một âm báo ngắn ngay sau khi cuộc gọi kết nối và trước khi bất kỳ bên nào
nói.
### Âm thanh công cụ
Chọn âm thanh do công cụ âm thanh có thể gọi từ prompt phát ra:
* **Không có** — công cụ không được cung cấp.
* **Chime**, **Ding** hoặc **Beep** — có thể xem trước từng âm thanh trong trình tạo.
### Ai nói trước
Cấu hình riêng cho cuộc gọi đến và cuộc gọi đi:
* **Cuộc gọi đến:** tác nhân nói trước hoặc người gọi nói trước.
* **Cuộc gọi đi:** tác nhân nói trước hoặc người được gọi nói trước.
Cài đặt này hữu ích cho trình quay số gọi đi cần chờ một người hoặc
menu điện thoại trước khi bắt đầu kịch bản.
### Xử lý thư thoại
Chọn điều xảy ra khi cuộc gọi đi đến thư thoại:
| Tùy chọn | Hành vi |
| -------------------------------- | ----------------------------------------------------------- |
| **Để tác nhân quyết định** | Prompt và ngữ cảnh hội thoại xác định việc nói hay gác máy. |
| **Gác máy im lặng** | Kết thúc mà không để lại lời nhắn. |
| **Để lại lời nhắn, rồi gác máy** | Phát lời nhắn đã cấu hình và kết thúc cuộc gọi. |
Lời nhắn thư thoại có thể chứa tối đa **2.000 ký tự** và hỗ trợ
`{agent_name}` và `{org_name}`. Xem
[Giá](/vi/guides/pricing) để biết cách thời lượng cuộc gọi được
tính phí.
### Thông báo về sự đồng ý
Theo mặc định, một thông báo ngắn ở đầu mỗi cuộc gọi sẽ cho người gọi biết
họ đang nói chuyện với một trợ lý AI và cuộc gọi được ghi âm. Bạn có thể chỉnh sửa
văn bản thông báo, tối đa **2.000 ký tự**; văn bản sẽ được phát nguyên văn
bằng ngôn ngữ của tác nhân.
Việc tắt thông báo trên một tác nhân đủ điều kiện yêu cầu quản trị viên tổ chức
xác nhận rằng tổ chức sẽ cung cấp mọi thông báo được pháp luật yêu cầu và
có được mọi sự đồng ý được pháp luật yêu cầu. Việc bật lại rồi tắt sau đó
yêu cầu một xác nhận mới. Xem lại
[hướng dẫn về luật đồng ý ghi âm](/vi/guides/recording-consent-laws) trước khi thay đổi
cài đặt này.
### Kiểm tra im lặng
Khi được bật, tác nhân sẽ kiểm tra xem người gọi còn ở đó không sau một khoảng
thời gian im lặng, lặp lại đến giới hạn của bạn, rồi gác máy:
* **Số giây trước khi kiểm tra:** 10–120 giây.
* **Số lần kiểm tra tối đa:** 1–10.
Mặc định là 15 giây và 3 lần kiểm tra.
## Thẻ trình tạo và vòng đời
| Thẻ hoặc thao tác | Mục đích |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------- |
| **Trực tiếp / Trò chuyện** | Nói chuyện với bản nháp hiện tại trong trình duyệt của bạn và kiểm tra bản chép lời cũng như hoạt động của công cụ. |
| **Cuộc gọi** | Xem lại các cuộc gọi do tác nhân này xử lý. |
| **A/B** | Tạo các biến thể prompt hoặc cấu hình và so sánh kết quả thực tế. |
| **Mô phỏng** | Chạy các kịch bản người gọi AI đã lưu hoặc tức thời với bản nháp. |
| **Xác thực** | Phát lại các lượt từ cuộc gọi thực đã được cố định với bản nháp trước khi triển khai. |
| **Lịch sử** | So sánh các bản sửa đổi đã triển khai và khôi phục một bản vào bản nháp. |
| **Hủy thay đổi** | Hoàn nguyên mọi cài đặt bản nháp đang chờ về phiên bản đã triển khai. |
| **Triển khai** | Đưa toàn bộ bản nháp lên triển khai một cách nguyên tử và tạo một bản sửa đổi. |
Nếu một người chỉnh sửa khác lưu cùng tác nhân sau khi bạn đã tải tác nhân đó,
ThunderPhone sẽ chặn thao tác lưu hoặc triển khai xung đột và yêu cầu bạn tải lại
thay vì ghi đè các thay đổi của họ.
## Quản lý tác nhân từ danh sách
Trang **Tác nhân giọng nói** cũng hỗ trợ các thao tác vòng đời ở cấp tổ chức:
* **Nhân bản** một tác nhân làm điểm khởi đầu mới trong cùng tổ chức.
* **Chuyển** một tác nhân sang tổ chức khác mà bạn thuộc về. **Sao chép** giữ lại tác nhân nguồn; **Di chuyển** xóa tác nhân khỏi tổ chức hiện tại và yêu cầu quyền quản trị viên.
* Chọn một hoặc nhiều tác nhân rồi xuất cấu hình đang hiển thị của các tác nhân đó dưới dạng **CSV** hoặc **JSON**.
* Xóa một tác nhân hoặc xóa hàng loạt các tác nhân đã chọn sau khi xác nhận.
Việc sao chép hoặc di chuyển một tác nhân giữa các tổ chức không tự động cấp cho tổ chức đích quyền truy cập vào các kết nối chỉ có ở tổ chức nguồn. Hãy xem lại các liên kết ứng dụng, API, kiến thức, MCP, số điện thoại và tiện ích của tác nhân đã sao chép trước khi triển khai tác nhân đó tại tổ chức đích.
## Trang liên quan
Hướng dẫn ngắn gọn toàn diện để tạo tác nhân.
Các gói cơ bản, tiện ích bổ sung, tính phí cuộc gọi, số điện thoại và khoản phí một lần.
Đóng băng các lượt thoại từ cuộc gọi thực và phát lại trước khi triển khai.
Trường yêu cầu, bản nháp, triển khai, phiên bản và ví dụ.