---
title: "Kết nối API"
description: "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 cuộc trò chuyện: dán lệnh cURL và trình hướng dẫn sẽ tạo định nghĩa công cụ, tham số và xác thực."
---

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 trò chuyện — tra cứu đơn hàng, tạo ticket, 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 trò chuyện 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 sẽ mở trình hướng dẫn. Dán một **lệnh cURL** mẫu,
    **đặc tả 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
    cùng nội dung 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 dự đoán được đánh dấu
    để bạn xem lại. Điều chỉnh tên, mô tả và kiểu 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 một 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 nội dung yêu cầu rồi thử lại. Khi thành
    công, kết nối được lưu cùng 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 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?
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 từng đối số mà
  tác nhân AI có thể cung cấp).
- **JSON** — cùng định nghĩa ở dạng JSON thô, để dán hoặc tinh chỉnh
  trực tiếp một đặc tả 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, đồng thời hiển thị trạng thái, độ trễ và 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.

Giá trị header chỉ có thể ghi. Sau khi lưu, chúng được mã hóa và không bao giờ hiển thị lại, trên bảng điều khiển hoặc qua API. Khi bạn chỉnh sửa một kết nối, header đã lưu sẽ hiển thị tên cùng các dấu chấm thay cho giá trị và ghi chú **Đã lưu**: giữ nguyên để dùng giá trị đã lưu hoặc nhập giá trị mới để thay thế. Yêu cầu kiểm tra và cuộc gọi thực sử dụng giá trị đã lưu. **Sao chép** sẽ sao chép các giá trị đã lưu sang kết nối mới.

<Tip>
  Hãy đặt mô tả dễ hiểu cho tham số ("Địa chỉ email khách hàng,
  ví dụ: 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, ngay trong 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 bắt đầu ở 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 tổ chức khác mà bạn
  thuộc về. Di chuyển sẽ xóa kết nối tại đây; các tác nhân AI sử dụng kết nối
  có thể cần được cấu hình lại.
- **Xóa** — thao tác 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ị các tác nhân AI
sử dụng từng kết nối, để bạn có thể nhanh chóng biết thay đổi sẽ ảnh hưởng đến đâu.

## 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">
    Kết nối dựng sẵn với 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 trong tài nguyên tích hợp.
  </Card>
</CardGroup>