Soạn tin nhắn
Một yêu cầu chứa model, messages và max_tokens; hướng dẫn hệ thống được gửi trong trường system riêng. Giữ nguyên vai trò và thứ tự tin nhắn để lần thử lại có thể tái tạo ngữ cảnh.
Lệnh gọi HTTP thô dùng https://cicora.ai/api/v1/messages, còn Messages SDK chỉ nhận URL gốc của cổng API https://cicora.ai/api và tự nối /v1/messages.
Yêu cầu Messages API
bash
curl --request POST https://cicora.ai/api/v1/messages \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "anthropic/claude-sonnet-5",
"max_tokens": 500,
"system": "Answer with a compact checklist.",
"messages": [{"role": "user", "content": "Prepare a release plan."}]
}'Công cụ và phát trực tiếp
- Chỉ thêm tools và tool_choice cho mô hình hỗ trợ chúng.
- Xử lý chế độ phát trực tiếp như chuỗi sự kiện thay vì một đối tượng JSON.
- Xác nhận cấu trúc đối số công cụ trước khi thực hiện hành động.
Chọn định dạng
Không trộn trường từ hai định dạng trong một yêu cầu. Chọn chat hoặc messages tại ranh giới ứng dụng khách và chuẩn hóa lịch sử nội bộ một lần.
Kiểm thử việc chuyển đổi bằng cuộc hội thoại đã lưu và loại bỏ thông tin nhận dạng, gồm kết quả công cụ và ngữ cảnh dài.