cicora.ai
Đặc tả APIGọi hàm

Công cụ và gọi hàm

Mô tả hàm bằng JSON Schema, thực thi lệnh gọi trong ứng dụng và trả kết quả về cuộc hội thoại.

Tài liệu tham khảo tích hợp: chọn tham số và năng lực khả dụng từ cài đặt API tài khoản và danh mục mô hình cho môi trường của bạn.

Mô tả hợp đồng hàm

Một công cụ gồm tên, mô tả rõ ràng và JSON Schema cho tham số. Mô tả cho biết khi nào nên chọn công cụ, còn lược đồ giới hạn các đối số.

Mô hình đề xuất một lệnh gọi; bản thân mô hình không có quyền truy cập mạng, cơ sở dữ liệu hoặc tệp của bạn.

Công cụ hàm trong yêu cầu trò chuyện
json
{
  "model": "openai/gpt-5.6-sol",
  "messages": [{"role": "user", "content": "What is the weather in Tashkent?"}],
  "tools": [{
    "type": "function",
    "function": {
      "name": "get_weather",
      "description": "Read current weather for a city.",
      "parameters": {
        "type": "object",
        "properties": {"city": {"type": "string"}},
        "required": ["city"],
        "additionalProperties": false
      }
    }
  }],
  "tool_choice": "auto"
}

Thực thi ở phía bạn

  • Kiểm tra tên công cụ theo danh sách cho phép.
  • Kiểm tra tính hợp lệ của đối số theo lược đồ trước khi gọi dịch vụ nội bộ.
  • Áp dụng cơ chế cấp quyền, thời gian chờ và tính lũy đẳng của bạn cho hành động công cụ.

Trả kết quả

Thêm tin nhắn công cụ có tool_call_id và kết quả tuần tự hóa ngắn gọn, rồi tiếp tục cuộc hội thoại với cùng ngữ cảnh.

Giữ lỗi thực thi công cụ riêng với lỗi mô hình: trả về lý do có cấu trúc để mô hình có thể giải thích cho người dùng.