POST /v1/agents/{agent_id}/chat وPOST /v1/agents/{agent_id}/chat/stream، تتطلبان ترويسة Idempotency-Key. الطلب من دونها يُرجع 422 validation_error.
اختيار المفتاح
أي قيمة من 1-255 حرفًا تكون فريدة لكل طلب منطقي. أبسط خيار هو UUID يُولَّد لحظة قرارك إرسال الرسالة. المفاتيح محصورة في نطاق مفتاح API الخاص بك، فلا داعي للقلق من التصادم مع مفاتيح أخرى.ما الذي تُرجعه إعادة المحاولة
إعادة المحاولة بنفسIdempotency-Key وبنفس الجسم تُرجع النتيجة المخزّنة: request_id الأصلي، ونفس رسالة المساعد، ونفس usage. لا يُولَّد رد ثانٍ ولا يُخصم شيء مرة أخرى.
تبقى السجلات 24 ساعة. بعد ذلك يبدأ المفتاح نفسه طلبًا جديدًا.
النتيجة المخزّنة هي ما حفظته بيئة التشغيل على أي حال: رسالة المساعد الموسومة بمعرّف الطلب واستهلاك النموذج المفوتر تحت ذلك المعرّف. لذلك لا تستدعي إعادة التشغيل النموذج أبدًا ولا تمس الرصيد، حتى لو توقفت المحاولة الأولى في منتصف الطريق.
التعارضات
الرد المتدفق والانقطاعات
القواعد نفسها تنطبق على نقطة نهاية الرد المتدفق. إذا انقطع اتصال عميلك في منتصف التدفق، يستمر توليد الرد وتخزينه. إعادة المحاولة بنفس المفتاح تبثresponse.created ثم مباشرة response.completed حاملًا النتيجة المخزّنة، من دون إعادة الأجزاء. راجع الرد المتدفق.