Connect tools & data

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

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

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

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

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

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.

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