Open in
Rời ThunderPhone
Xuất tác nhân AI dưới dạng tệp mở, xây dựng lại trên LiveKit Agents, Pipecat, Vapi hoặc Retell bằng kỹ năng tác nhân lập trình, rồi tải xuống lịch sử cuộc gọi và bản ghi âm của bạn.
Bạn có thể rời ThunderPhone bất cứ khi nào bạn muốn. Mọi tác nhân AI đều có thể xuất dưới dạng gói zip gồm các tệp mở, miễn phí, và một kỹ năng giúp tác nhân AI lập trình của bạn xây dựng lại nó trên LiveKit Agents, Pipecat, Vapi hoặc Retell. Trang này trình bày những gì bạn có thể mang theo, cách xuất và những gì bạn cần thực hiện lại ở nền tảng khác.
Những gì bạn có thể mang theo
| Nội dung | Cách thực hiện |
|---|---|
| Một tác nhân AI: hướng dẫn, công cụ, số chuyển cuộc gọi, bước, cài đặt, định tuyến số và webhook | Xuất tác nhân AI, một gói zip cho mỗi tác nhân AI |
| Tệp kiến thức của tác nhân AI | Có trong bản xuất tác nhân AI |
| Lịch sử cuộc gọi và bản chép lời | Xuất cuộc gọi, tối đa 1.000 cuộc gọi mỗi yêu cầu |
| Bản ghi âm | Một bản ghi âm mỗi yêu cầu, theo cuộc gọi |
| Số điện thoại tại nhà cung cấp của riêng bạn | Chúng chưa từng rời khỏi nhà cung cấp của bạn. Xem Số điện thoại |
Xuất tác nhân
Trong Zeus
Mở tác nhân rồi chuyển đến phần cài đặt của tác nhân (Xử lý cuộc gọi trong trình chỉnh sửa tác nhân). Ở cuối trang, trong mục Xuất, sao chép hoặc xóa, chọn Xuất. Tệp zip sẽ được tải xuống máy tính của bạn.
Với API
curl 'https://api.thunderphone.com/v1/agents/12/export' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o agent-12.zipTệp zip được tạo khi bạn yêu cầu. Bất kỳ ai có thể đọc tác nhân đều có thể
xuất tác nhân đó. Kiến thức, số điện thoại và webhook chỉ được đưa vào khi
thông tin xác thực có thể đọc chúng: token OAuth cần knowledge:read,
numbers:read và integrations:read, còn webhook cũng cần quyền quản trị viên hoặc
chủ sở hữu. Mọi phần bị bỏ qua đều được liệt kê trong omitted của manifest.json.
API trả về 429 khi vượt quá 30 lượt xuất mỗi phút.
| Tham số truy vấn | Mô tả |
|---|---|
include_url_paths | true giữ lại đường dẫn của từng URL trong bản xuất, chẳng hạn như endpoint của công cụ. Theo mặc định, mọi URL đều bị cắt chỉ còn máy chủ. Tên người dùng, mật khẩu và chuỗi truy vấn luôn bị xóa khỏi URL |
Dùng include_url_paths=true khi bạn sắp xây dựng lại tác nhân ở nơi khác,
vì tại đó cần các endpoint của công cụ. Không bật tùy chọn này cho bản sao bạn
dự định chia sẻ.
Tệp zip chứa gì
| Tệp | Nội dung |
|---|---|
manifest.json | Định dạng (thunderphone.agent-export/v1), nội dung được đưa vào và danh sách omitted nêu mọi nội dung bị bỏ qua cùng lý do |
agent.json | Tác nhân theo dữ liệu mà GET /v1/agents/{agent_id} trả về, đã loại bỏ thông tin xác thực |
prompt.md | Hướng dẫn hiện hành |
knowledge/index.json và các tệp bên cạnh | Kiến thức của tác nhân. Mỗi tài liệu là tệp gốc nếu có lưu tệp, nếu không là văn bản đã trích xuất |
numbers.json | Các số điện thoại được định tuyến đến tác nhân này, cả gọi vào và gọi ra, cùng mọi phiên bản hoặc biến thể được ghim |
webhooks.json | Các endpoint webhook thuộc phạm vi của tác nhân này, không bao gồm bí mật của chúng |
README.md | Nội dung của từng tệp |
Tệp kiến thức lớn hơn 25 MB sẽ bị bỏ qua, cũng như mọi nội dung vượt quá
100 MB cho toàn bộ bản xuất. Mỗi mục đều được liệt kê trong manifest.json cùng
endpoint để tải xuống,
GET /v1/knowledge/documents/{document_id}/original.
Nội dung không bao giờ được đưa vào
- Giá trị thông tin xác thực. Header của một công cụ chỉ được liệt kê theo tên. Giá trị header chỉ có thể ghi trong ThunderPhone: không có phản hồi API nào trả về chúng, nên bản xuất cũng không thể có. Bạn cần nhập lại chúng ở phía bên kia. Điều này áp dụng cho thông tin xác thực mà ThunderPhone lưu dưới dạng thông tin xác thực. Hướng dẫn và tệp kiến thức của bạn được sao chép chính xác như khi bạn viết hoặc tải lên, vì vậy nếu một khóa từng được dán vào prompt hoặc tài liệu, khóa đó sẽ nằm trong tệp zip. Hãy kiểm tra trước khi chia sẻ.
- Lịch sử cuộc gọi và bản ghi. Chúng có bản xuất riêng; xem Lịch sử cuộc gọi và bản ghi.
- Lịch sử phiên bản. Bản xuất chứa tác nhân ở trạng thái hiện hành. Các phiên bản trước
vẫn được liệt kê tại
GET /v1/agents/{agent_id}/versions. - Các tác nhân khác mà tác nhân này chuyển tiếp đến. Xuất từng tác nhân theo cùng cách.
Chuyển sang nền tảng khác
Skill migrate-off-thunderphone hướng dẫn coding agent của bạn trong quá trình
chuyển đổi. Cài đặt skill của ThunderPhone:
npx skills add thunderphone/skillsSau đó, yêu cầu coding agent của bạn chuyển một tác nhân AI khỏi ThunderPhone và nêu tên đích đến: LiveKit Agents, Pipecat, Vapi hoặc Retell. Skill này tải xuống bản xuất, hỏi bạn từng thông tin xác thực, xây dựng lại tác nhân AI từ ánh xạ dành cho đích đến đó và kiểm thử tại đó trước khi bất kỳ số nào được chuyển đi. Quá trình chuyển đổi chạy trong coding agent của bạn, bằng key của riêng bạn. ThunderPhone không bao giờ ghi vào tài khoản của bạn trên nền tảng khác.
Những nội dung được chuyển, dưới dạng tệp mà skill ánh xạ cho bạn:
- Hướng dẫn, bao gồm hướng dẫn dùng chung và các bước.
- Công cụ: cùng endpoint, phương thức và schema tham số.
request_formatcủa từng công cụ ghi lại cấu trúc body mà endpoint của bạn mong đợi. - Số chuyển cuộc gọi cùng cài đặt kết thúc cuộc gọi và bàn phím.
- Tệp kiến thức.
- Cài đặt hộp thư thoại, khoảng lặng và thời lượng cuộc gọi.
- Những số mà tác nhân AI trả lời và dùng để thực hiện cuộc gọi.
Những nội dung bạn cần làm lại ở phía bên kia:
- Nhà cung cấp giọng nói, mô hình ngôn ngữ và âm thanh. Bạn chọn các nhà cung cấp này tại đích đến. Không có gì đảm bảo một giọng nói, hoặc âm thanh của cuộc gọi, sẽ khớp.
- Thông tin xác thực. Giá trị header của công cụ và secret webhook.
- Điện thoại. Cách số điện thoại kết nối đến tác nhân AI được thiết lập khác nhau trên mỗi nền tảng.
- Các bước và chuyển giao. Đích đến có tính năng luồng hoặc chuyển giao sẽ xây dựng lại chúng tại đó. Ở nơi khác, skill gộp các bước vào hướng dẫn và thông báo cho bạn.
- Cài đặt ThunderPhone không có tương đương. Cài đặt thông minh, nghe và tốc độ phản hồi, công cụ email và tin nhắn tích hợp sẵn, cùng chấm điểm cuộc gọi, bản tóm tắt và nhãn kết quả sẽ không được chuyển trừ khi bạn xây dựng lại chúng.
- Chữ ký request. ThunderPhone ký các request công cụ và webhook mà nó gửi. Nền tảng khác ký theo cách riêng, vì vậy một endpoint xác minh chữ ký ThunderPhone cần kiểm tra mới.
- Kiểm thử. Kiểm thử tác nhân AI đã xây dựng lại tại đích đến trước khi chuyển một số điện thoại.
Giữ tác nhân AI ThunderPhone tại chỗ cho đến khi tác nhân AI mới vượt qua các kiểm thử của bạn. Đây là cách để bạn quay lại.
Số điện thoại
Chuyển số sau cùng, sau khi tác nhân AI mới vượt qua các kiểm thử.
- Số điện thoại trên nhà mạng của riêng bạn (một kết nối VoIP)
vẫn ở lại với nhà mạng đó. Trỏ số đến nền tảng mới trong console của nhà
mạng. Sau đó chọn Phát hành trên số trong ThunderPhone và không tích
Cũng hủy số này trong tài khoản … của tôi: số sẽ bị ngắt kết nối khỏi
ThunderPhone và vẫn ở trong tài khoản nhà mạng của bạn. Qua API,
phát hành số bằng
DELETE /v1/phone-numbers/{phone_number_id}?confirm=truevà không gửirelease_at_provider. - Số điện thoại do ThunderPhone cung cấp. Liên hệ bộ phận hỗ trợ trước khi bạn phát hành một số muốn giữ lại. Việc phát hành số ThunderPhone là vĩnh viễn: số sẽ trở về nhóm số và có thể được cấp cho khách hàng khác.
Lịch sử cuộc gọi và bản ghi âm
Các nội dung này tách biệt với bản xuất tác nhân AI.
- Cuộc gọi.
GET /v1/calls/exporttrả về tối đa 1.000 cuộc gọi mỗi request dưới dạng CSV (metadata) hoặc JSON (kèm bản chép lời). Lọc theoagent_idvà phân trang lịch sử bằngstart_datevàend_date. Header phản hồiX-Truncatedcó giá trịtruekhi có nhiều cuộc gọi khớp hơn số được trả về. - Bản ghi âm.
GET /v1/calls/{call_id}/audiotrả về URL tồn tại trong thời gian ngắn cho bản ghi âm của một cuộc gọi. Không có tính năng tải xuống hàng loạt bản ghi âm.
curl 'https://api.thunderphone.com/v1/calls/export?export_format=json&agent_id=12&start_date=2026-10-01T00:00:00Z&end_date=2026-11-01T00:00:00Z' \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-o calls-2026-10.jsonChi phí
Không tốn gì. Xuất tác nhân, xuất cuộc gọi và tải xuống bản ghi đều miễn phí. ThunderPhone là dịch vụ trả theo mức sử dụng, không có phí thuê bao và không có phí theo chỗ ngồi. Một số ThunderPhone sẽ ngừng tính phí khi bạn giải phóng số đó.
Sau khi bạn rời đi
Không có thời hạn cố định. Bạn có thể chấm dứt thỏa thuận bằng thông báo bằng văn bản gửi đến legal@thunderphone.com, từ email quản trị của tài khoản hoặc một kênh xác minh được khác. Việc chậm thanh toán có thể khiến dịch vụ bị tạm ngừng; bản thân việc này không bao giờ chấm dứt thỏa thuận hoặc kích hoạt việc xóa Dữ liệu Khách hàng. Về dữ liệu, Điều khoản nêu: "Sau khi chấm dứt chính thức, Nhà cung cấp sẽ hoàn trả hoặc xóa Dữ liệu Khách hàng trong vòng sáu mươi (60) ngày, tùy thuộc vào quyền xuất dữ liệu của Khách hàng, chu kỳ sao lưu, yêu cầu lưu giữ pháp lý, việc lưu giữ theo yêu cầu pháp luật, DPA và mọi BAA đã được ký kết."
Toàn văn nằm trong Điều khoản Dịch vụ, mục Thời hạn dịch vụ; tạm ngừng; chấm dứt. Điều khoản có hiệu lực chi phối; đây là bản tóm tắt.