Gọi công cụ
Mô hình đề xuất tên công cụ và tham số JSON. Máy chủ của bạn, không phải mô hình, sẽ xác minh quyền và thực hiện thao tác cơ sở dữ liệu, mạng hoặc ghi dữ liệu.
Khai báo công cụ
bash
# Bắt đầu với công cụ chỉ đọc để kiểm tra khả năng tương thích của mô hình một cách an toàn.
curl https://sprelaytoken.com/v1/chat/completions \
-H "Authorization: Bearer $SPRELAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.6-sol",
"messages": [
{"role": "user", "content": "Thời tiết hôm nay ở London thế nào?"}
],
"tools": [
{
"type": "function",
"function": {
"name": "get_weather",
"description": "Lấy thông tin thời tiết của một thành phố",
"parameters": {
"type": "object",
"properties": {
"city": {"type": "string", "description": "Tên thành phố"}
},
"required": ["city"],
"additionalProperties": false
}
}
}
]
}'| Trường | Ý nghĩa |
|---|---|
tools | Các công cụ mô hình có thể yêu cầu trong lần gọi này |
type: function | Khai báo công cụ kiểu hàm |
name | Tên ổn định dùng để chọn trình xử lý của bạn |
description | Giúp mô hình quyết định thời điểm dùng công cụ |
parameters | JSON Schema của các tham số được phép |
required | Các tham số bắt buộc phải có |
additionalProperties: false | Từ chối tham số chưa khai báo |
JSON không thể chứa chú thích, vì vậy hãy giữ nguyên dấu câu khi chỉnh sửa.
Vòng lặp thực thi
- Gửi tin nhắn và định nghĩa công cụ.
- Kiểm tra mô hình có trả về lời gọi công cụ hay không.
- Kiểm tra tên theo danh sách cho phép và tham số theo Schema.
- Áp dụng phân quyền nghiệp vụ và thời gian chờ.
- Thực thi trình xử lý phía máy chủ đã được duyệt.
- Gửi kết quả trở lại cùng ID lời gọi công cụ ban đầu.
- Đọc câu trả lời cuối của mô hình.
Coi mọi tham số do mô hình tạo là dữ liệu không đáng tin cậy. Không nối trực tiếp chúng vào SQL, lệnh shell hoặc URL không giới hạn. Yêu cầu xác nhận hoặc idempotency cho thao tác ghi, giới hạn vòng lặp gọi công cụ và không trả thông tin đăng nhập hoặc stack trace nội bộ.