---
title: "Rời ThunderPhone"
description: "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."
ui: zeus
---

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](#export-an-agent), 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](#call-history-and-recordings), 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](#phone-numbers) |

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

<CodeGroup>
```bash cURL
curl 'https://api.thunderphone.com/v1/agents/12/export' \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -o agent-12.zip
```
</CodeGroup>

Tệ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}`](/api-reference/agents#agent-object) 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](/vi/webhooks/endpoints) 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`](/api-reference/knowledge-bases#download-the-original-file).

### 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](#call-history-and-recordings).
- **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`](/api-reference/agents#version-history).
- **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](/vi/guides/coding-agents):

```bash
npx skills add thunderphone/skills
```

Sau đó, 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_format` củ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](/vi/guides/verify-webhook-signatures) 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](/vi/guides/bring-your-own-numbers))
  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](/api-reference/phone-numbers#release-a-phone-number) số bằng
  `DELETE /v1/phone-numbers/{phone_number_id}?confirm=true` và không gửi
  `release_at_provider`.
- **Số điện thoại do ThunderPhone cung cấp.** Liên hệ
  [bộ phận hỗ trợ](mailto:support@thunderphone.com) 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/export`](/api-reference/calls#export-calls)
  trả 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 theo `agent_id` và phân trang lịch sử bằng
  `start_date` và `end_date`. Header phản hồi `X-Truncated` có giá trị `true`
  khi có nhiều cuộc gọi khớp hơn số được trả về.
- **Bản ghi âm.** [`GET /v1/calls/{call_id}/audio`](/api-reference/calls#get-recording-audio)
  trả 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.

<CodeGroup>
```bash cURL
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.json
```
</CodeGroup>

## Chi 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](/vi/guides/pricing), 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ụ](https://thunderphone.com/terms#term-termination), 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.

## Liên quan

- [Nhập tác nhân từ nền tảng khác](/vi/guides/import-agents)
- [Kỹ năng cho tác nhân lập trình](/vi/guides/coding-agents)
- [API tác nhân](/api-reference/agents)
- [API cuộc gọi](/api-reference/calls)
