চেঞ্জলগ

এই পৃষ্ঠাটি ডেভেলপার API চুক্তির পরিবর্তনগুলো ট্র্যাক করে, যাতে আপনি আপনার ইন্টিগ্রেশন যে সারফেসের উপর নির্ভর করে তা ট্র্যাক করতে পারেন।

v1 — স্থিতিশীল (2026-06)

Cuneiform Chat ডেভেলপার API-এর প্রাথমিক পাবলিক রিলিজ। v1 হলো বর্তমান, স্থিতিশীল চুক্তি এবং এই রেফারেন্সে নথিভুক্ত সবকিছুর জন্য বেসলাইন প্রতিষ্ঠা করে:

• প্রমাণীকরণ — একটি cuk_<env>_<random> key দিয়ে ক্রেডেনশিয়াল-সুরক্ষিত অ্যাক্সেস, যা Authorization: Bearer cuk_… বা X-API-Key: cuk_… হিসেবে উপস্থাপিত। পাঁচটি scopes: knowledge:read, knowledge:write, agents:read, agents:write, agents:query।
• Knowledge — অ্যাসিঙ্ক্রোনাস ডকুমেন্ট আপলোড, তালিকা, সার্চ, আনয়ন, স্ট্যাটাস (পোল + SSE) ও মুছে ফেলা; ফোল্ডার ও tag CRUD; ডকুমেন্ট সংগঠন (ফোল্ডারে সরানো, tags যোগ/অপসারণ)।
• Agents — তৈরি, তালিকাভুক্ত, আনয়ন, আপডেট, আর্কাইভ (soft-delete) ও পুনরুদ্ধার; একটি agent-এর কনফিগারেশন পড়া ও আপডেট করা।
• Agent কোয়েরি — ব্লকিং JSON মোডে বা স্ট্রিমিং SSE মোডে একটি agent চালানো।
• কনভেনশন — অস্বচ্ছ কার্সর পেজিনেশন, Idempotency-Key চুক্তি, Stripe-শৈলীর ত্রুটি এনভেলপ এবং RateLimit-* হেডার।

চুক্তি কীভাবে বিকশিত হয়

v1 সংযোজনমূলক ও স্থিতিশীল:

• v1-এর মধ্যে নতুন ফিল্ড ও নতুন endpoints প্রবর্তিত হতে পারে।
• বিদ্যমান ফিল্ড v1-এর মধ্যে কখনো সরানো বা পুনঃব্যবহার করা হয় না।
• ত্রুটির বিভাগ কখনো পুনঃব্যবহার করা হয় না — একটি নতুন বিভাগ যোগ হতে পারে, কিন্তু একটি বিদ্যমান বিভাগ তার অর্থ ধরে রাখে, তাই ত্রুটির type-এর উপর শাখাবদ্ধ করা নিরাপদ।

একটি ব্রেকিং পরিবর্তন একটি নতুন ভার্সন প্রিফিক্সের (/v2) অধীনে প্রকাশিত হবে, কখনো v1-এর মধ্যে নীরবে নয়।