Skip to main content
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

1

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 ô.
2

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

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

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.
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.
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”). 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.

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

Tích hợp công cụ qua API

Tạo và quản lý các kết nối tương tự bằng lập trình.

Kết nối ứng dụng

Các kết nối dựng sẵn cho Google, Slack, HubSpot, Salesforce và Cal.com.

Thêm máy chủ MCP

Cung cấp toàn bộ máy chủ công cụ cho các tác nhân AI của bạn.

Tài liệu tham khảo API tích hợp

Mọi trường trên tài nguyên tích hợp.