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

# Kết nối API

> Biến bất kỳ HTTP API nào thành một hàm mà tác nhân AI của bạn có thể gọi trong khi trò chuyện — dán lệnh cURL và để trình hướng dẫn xử lý phần còn lại.

Kết nối API là các hàm HTTP tùy chỉnh mà tác nhân AI của bạn có thể gọi trong
một cuộc hội thoại — tra cứu đơn hàng, tạo phiếu hỗ trợ, lấy trạng thái tài khoản
từ backend của riêng bạn. Bạn chỉ cần định nghĩa endpoint một lần trong
**Kết nối → API** (`/dashboard/api-connections`); các tác nhân AI đã được
gắn kết nối sau đó có thể gọi kết nối bất cứ khi nào cuộc hội thoại cần đến.

Có hai cách để tạo kết nối: dán nội dung để trình hướng dẫn phân tích,
hoặc thiết lập kết nối thủ công.

## Cách nhanh: dán và phân tích

<Steps>
  <Step title="Nhấp vào Kết nối API mới">
    Hộp thoại mở ở trình hướng dẫn. Dán một **lệnh cURL** mẫu,
    **spec OpenAPI/Swagger**, **bản xuất Postman**, **giao diện
    TypeScript**, hoặc **schema Zod** vào ô.
  </Step>

  <Step title="Nhấp vào Phân tích">
    ThunderPhone suy luận toàn bộ kết nối từ nội dung bạn dán — URL,
    phương thức, header và schema tham số được tạo từ các tham số truy vấn
    và phần thân yêu cầu mà hệ thống tìm thấy. Các header bạn dán (bao gồm
    header xác thực) được đưa vào cấu hình endpoint.
  </Step>

  <Step title="Xác nhận các trường được đánh dấu">
    Cấu hình được suy luận sẽ mở ra với các trường được dự đoán được đánh dấu
    để bạn xem lại. Điều chỉnh tên, mô tả và loại tham số để tác nhân AI
    hiểu khi nào và cách gọi hàm — mô tả là nội dung mà mô hình đọc.
  </Step>

  <Step title="Xác thực & Lưu">
    Khi lưu, hệ thống sẽ chạy yêu cầu kiểm thử trực tiếp đến endpoint của bạn trước.
    Nếu yêu cầu thất bại, kết nối sẽ không được lưu — hãy sửa URL, header xác thực
    hoặc phần thân rồi thử lại. Khi thành công, kết nối được lưu với nhãn
    **Đã xác thực**.
  </Step>
</Steps>

Nếu trình hướng dẫn không tìm thấy URL yêu cầu trong nội dung bạn dán, hệ thống sẽ thông báo —
hãy thêm một endpoint `http(s)` đầy đủ rồi thử lại.

## Thiết lập thủ công

Nhấp vào **Thiết lập thủ công →** trong trình hướng dẫn (hoặc **Muốn AI suy luận mục này?
Thử Trình hướng dẫn →** để quay lại). Trình tạo thủ công có hai trình chỉnh sửa:

* **Trực quan** — các trường biểu mẫu cho tên hiển thị, tên hàm, **URL**
  yêu cầu, **phương thức** (`POST`, `GET`, `PUT`, `PATCH`, `DELETE`),
  **header** tùy chỉnh và schema tham số (**Thêm thuộc tính** cho mỗi
  đối số mà tác nhân AI có thể cung cấp).
* **JSON** — cùng định nghĩa dưới dạng JSON thô, để dán hoặc tinh chỉnh
  trực tiếp spec công cụ.

Bảng **Yêu cầu kiểm thử** (không bắt buộc) cho phép bạn gửi yêu cầu đã cấu hình
trước khi lưu và hiển thị trạng thái, độ trễ cùng bản xem trước phản hồi.
**Xác thực & Lưu** luôn chạy kiểm thử này và chỉ lưu khi thành công.

<Tip>
  Cung cấp cho tham số các mô tả bằng ngôn ngữ đơn giản ("Địa chỉ email khách hàng,
  ví dụ: [jane@example.com](mailto:jane@example.com)"). Tác nhân AI chọn đối số dựa trên các mô tả này
  theo thời gian thực, giữa cuộc gọi.
</Tip>

## Quản lý kết nối của bạn

Mỗi hàng kết nối hiển thị trạng thái xác thực — **Đã xác thực**,
**Chưa kiểm thử** hoặc **Lỗi** — tên hàm và các tác nhân AI sử dụng kết nối đó.
Từ menu thao tác của hàng, bạn có thể:

* **Chỉnh sửa** — mở lại cấu hình.
* **Nhân bản** — sao chép làm điểm bắt đầu (bản sao sẽ ở trạng thái
  Chưa kiểm thử).
* **Lịch sử phiên bản** — xem các phiên bản trước đó và khôi phục một phiên bản vào
  trình chỉnh sửa.
* **Chuyển** — sao chép hoặc di chuyển kết nối sang một tổ chức khác mà bạn
  thuộc về. Việc di chuyển sẽ xóa kết nối ở đây; các tác nhân AI đã dùng kết nối đó
  có thể cần cấu hình lại.
* **Xóa** — vĩnh viễn; các tác nhân AI sử dụng kết nối sẽ cần được
  cấu hình lại.

## Gắn kết nối vào tác nhân AI

Thêm kết nối vào tác nhân AI trong phần kết nối API của trình tạo
([Tạo tác nhân AI](/vi/guides/build-an-agent)). Danh sách hiển thị tác nhân AI nào
sử dụng từng kết nối, để bạn có thể nhanh chóng biết một thay đổi ảnh hưởng đến điều gì.

## Bước tiếp theo

<CardGroup cols={2}>
  <Card title="Tích hợp công cụ qua API" icon="code" href="/vi/guides/build-tool-integration">
    Tạo và quản lý các kết nối tương tự bằng lập trình.
  </Card>

  <Card title="Kết nối ứng dụng" icon="cable" href="/vi/guides/connect-apps">
    Các kết nối dựng sẵn cho Google, Slack, HubSpot, Salesforce và Cal.com.
  </Card>

  <Card title="Thêm máy chủ MCP" icon="server" href="/vi/guides/mcp-servers">
    Cung cấp toàn bộ máy chủ công cụ cho các tác nhân AI của bạn.
  </Card>

  <Card title="Tài liệu tham khảo API tích hợp" icon="book" href="/api-reference/integrations">
    Mọi trường trên tài nguyên tích hợp.
  </Card>
</CardGroup>