Custom API Tools

Custom API Tools phù hợp khi bạn có một HTTP API đơn giản và muốn assistant gọi API đó khi cần. Ví dụ: lookup order, tạo support ticket, kiểm tra inventory, lấy appointment hoặc gửi data vào internal system.

Tạo Tool

Mở Admin Dashboard.
Chọn assistant.
Vào Tools.
Nhấn New Tool.
Điền tool details.
Nhấn Create hoặc Save.

Fields

Field	Ý nghĩa
Name	Tên ngắn gọn để assistant nhận biết tool. Nên dùng tên mô tả action, ví dụ `lookup_order`
Description	Mô tả khi nào nên dùng tool. Phần này rất quan trọng vì AI dùng nó để quyết định có call tool hay không
Method	HTTP method: GET, POST, PUT, PATCH hoặc DELETE
API URL	Endpoint mà Assistant Core sẽ call
Parameters	Data assistant cần lấy từ user trước khi call API
Strict	Khi bật, parameter schema được kiểm soát chặt hơn để giảm unexpected input

Parameters

Mỗi parameter gồm:

Field	Ý nghĩa
Name	Parameter name gửi đến API
Type	Data type: string, number, integer, boolean hoặc array
Description	Giải thích rõ parameter này là gì
Required	Bắt buộc hay không
Enum values	Allowed values nếu assistant chỉ nên chọn trong một số option
Items type	Item type nếu parameter là array

Request Format

Method	Parameter format
GET	Query string
DELETE	Query string
POST	JSON body
PUT	JSON body
PATCH	JSON body

Ví Dụ

Một order lookup tool có thể cấu hình:

Field	Value
Name	`lookup_order`
Description	Tìm shipping status theo order ID khi user hỏi về trạng thái giao hàng
Method	GET
API URL	`https://api.example.com/orders/status`
Parameter	Required string parameter tên `order_id`

Khi user hỏi “đơn hàng A123 của tôi tới đâu rồi?”, assistant có thể call API với order_id=A123, rồi summarize result cho user.

Security Notes

Không đặt API key trực tiếp trong URL nếu URL có thể bị lộ.
Nên tạo proxy endpoint nếu original API cần authentication phức tạp.
Tool description càng rõ, assistant càng ít call nhầm.
Nếu một tool có thể thay đổi data, hãy ghi rõ trong description để assistant chỉ call khi user thật sự muốn thực hiện action.