انتقل إلى المحتوى
كل التوثيق

وكلاء البرمجة

إعداد Zed

لوحة الوكيل في Zed تقبل أي واجهة API متوافقة مع OpenAI كمزوّد. أضف nokeep من Agent Settings أو من settings.json، وسيقرأ Zed المفتاح من NOKEEP_API_KEY أو من سلسلة المفاتيح.

تم التحقق في 29 أكتوبر 2026

القيم

رابط API
https://nokeep.ai/v1
مفتاح API
sk-nokeep-test to test, then your own sk-nokeep-… key
النموذج
deepseek-v4.1-flash-uncensored
نافذة السياق
1000000
أقصى عدد رموز للإخراج
32768

ابدأ بمفتاح التجربة المجاني: يرد على كل طلب بسطر ثابت واحد دون استدعاء أي أدوات، وهذا يثبت أن الرابط والمفتاح صحيحان دون إنفاق أي شيء. بعدها الصق مفتاحك الخاص من لوحة التحكم. الرصيد يبدأ من 5 دولارات، دون اشتراك.

الاتصال

  1. افتح Agent Settings: شغّل agent: open settings من لوحة الأوامر.
  2. تحت LLM Providers، اضغط Add Provider.
  3. سمّه nokeep، والصق https://nokeep.ai/v1 كرابط API، وdeepseek-v4.1-flash-uncensored كمعرّف النموذج، و1000000 كنافذة السياق.
  4. الصق sk-nokeep-test كمفتاح. يحفظه Zed في سلسلة مفاتيح النظام.
  5. افتح لوحة الوكيل، واختر DeepSeek V4.1 Flash Uncensored وأرسل رسالة. الرد الذي يبدأ بـ “Connected to” يعني أن الإعداد يعمل.
  6. استبدل المفتاح بمفتاحك الخاص من لوحة التحكم.

أو اضبطه في settings.json، وهذا يفعّل أيضًا الصور واستدعاءات الأدوات المتوازية ومفتاح الكاش. لا تضع المفتاح هناك أبدًا: يقرأه Zed من سلسلة المفاتيح، أو من NOKEEP_API_KEY، وهو اسم المزوّد بالحروف الكبيرة متبوعًا بـ _API_KEY.

settings.json
{
  "language_models": {
    "openai_compatible": {
      "nokeep": {
        "api_url": "https://nokeep.ai/v1",
        "available_models": [
          {
            "name": "deepseek-v4.1-flash-uncensored",
            "display_name": "DeepSeek V4.1 Flash Uncensored",
            "max_tokens": 1000000,
            "max_output_tokens": 32768,
            "capabilities": {
              "tools": true,
              "images": true,
              "parallel_tool_calls": true,
              "prompt_cache_key": true
            }
          },
          {
            "name": "glm-5.3-flash-uncensored",
            "display_name": "GLM 5.3 Flash Uncensored",
            "max_tokens": 128000,
            "max_output_tokens": 32768,
            "capabilities": {
              "tools": true,
              "images": false,
              "parallel_tool_calls": false,
              "prompt_cache_key": false
            }
          }
        ]
      }
    }
  }
}

إعدادات تستحق المعرفة

  • max_tokens هو نافذة السياق في إعدادات Zed، وليس الحد الأقصى للرد. max_output_tokens هو الحد الأقصى لكل رد.
  • prompt_cache_key يرسل استدعاءات كل خيط إلى خادم يحتفظ ببداية هذا الخيط في الكاش. DeepSeek يقبله؛ وGLM يتجاهله.
  • images يتيح لك إضافة لقطات شاشة إلى خيط DeepSeek. GLM يقرأ النص فقط.

أي نموذج

deepseek-v4.1-flash-uncensoredglm-5.3-flash-uncensored
السياق1,000,000 رمز128,000 رمز
أطول رد131,072 رمزًا32,768 رمزًا
استدعاء الأدواتنعم، مع كل tool_choiceنعم، مع tool_choice إما auto أو none
قراءة لقطات الشاشةنعم، حتى 10 لكل طلبلا، نص فقط
التفكيرمعطّل إلا إذا طُلبدائمًا، ولفترة قصيرة
لكل مليون رمز$0.45 دخل · $0.011 مخزّن · $1.75 خرج$0.20 دخل · $0.04 مخزّن · $0.65 خرج

استخدم DeepSeek لعمل الوكلاء. مستودع كامل يتسع في سياقه، ويستدعي الأدوات بكل الصيغ، والتاريخ الذي يعيد الوكيل إرساله مع كل استدعاء يُحتسب بسعر الكاش المخزّن البالغ 0.011 دولار لكل مليون. استخدم GLM للمهام القصيرة المنفردة التي لا تعيد إرسال تاريخ طويل، حيث تكون أسعار إدخاله الجديد وإخراجه الأقل أفضل.

أُزيلت حالات الرفض من أوزان النموذجين، لذلك يحصل العمل المتصل بموضوع حساس، مثل اختبار الأمان على أنظمتك أو أدوات الإشراف، على شيفرة بدل الرفض. قارن بين النماذج.

التفكير

يجيب DeepSeek فورًا ما لم يذكر الطلب reasoning_effort، وهذا يناسب حلقة التعديل والتشغيل السريعة للوكيل. للتخطيط أو لخلل صعب، اطلب منه أن يفكّر: يقبل none وlow وhigh وmax. قيم التطبيقات الأخرى minimal وmedium وxhigh تُشغَّل على أقرب هذه القيم؛ وأي قيمة أخرى تُرفض بخطأ 400 invalid_reasoning_effort. التفكير يُحتسب كإخراج.

في Zed، أضف "reasoning_effort": "high" إلى مدخل DeepSeek. عندها يعرض Zed مفتاح تفكير في لوحة الوكيل، ويرسل هذا المستوى عند تفعيله. استخدم low أو high أو max؛ وminimal وmedium وxhigh تعمل أيضًا وتُشغَّل على أقرب هذه القيم.

تكلفة الجلسة

يرسل الوكيل المحادثة كاملة مع كل استدعاء: التعليمات، والملفات التي قرأها، وكل خطوة حتى الآن. لنفترض أن الاستدعاء يرسل 60,000 رمز، منها 55,000 بداية مطابقة لآخر استدعاء، ويكتب 1,000. على DeepSeek يكلف هذا الاستدعاء نحو 0.0046 دولار، فتكون 200 استدعاء نحو 0.92 دولار. بدون كاش، سيكون الاستدعاء نفسه 0.0288 دولار.

  • الكاش تلقائي: لا يوجد ما تفعّله. البداية التي تبلغ نحو 1,000 رمز أو أكثر، وتتكرر خلال دقائق قليلة، تُحتسب بسعر المخزّن.
  • كل استدعاء يحجز أقصى تكلفة محتملة، أي المطالبة وأقصى إخراج، ثم يُسوّى على ما استُخدم فعلًا. عند أقصى إخراج 32,768 رمزًا، يبلغ جزء الإخراج من الحجز نحو 0.0573 دولار.
  • تعرض لوحة التحكم الرموز الفعلية لكل استدعاء، والرموز المخزّنة، والرصيد المستهلك. قد لا يعرف عداد التكلفة في الوكيل سعر الكاش، فيُظهر رقمًا أعلى.

كيف تعمل الفوترة.

إذا لم يعمل

ما يعرضه الوكيلالحل
401المفتاح خاطئ أو مُلغى. الصقه من جديد، دون مسافات أو علامات اقتباس.
402نفد الرصيد المدفوع في الحساب. أعد التعبئة من 5 دولارات في لوحة التحكم، وفعّل Auto top-up هناك حتى لا تتوقف مهمة طويلة في منتصفها: حين ينخفض الرصيد عن المبلغ الذي تختاره، يضيف رصيدًا من بطاقتك المحفوظة.
429تجاوزت 120 طلبًا في الدقيقة على مفتاح واحد، أو تجاوزت حدًا يوميًا وضعته على المفتاح. الوكلاء الذين يشغّلون عدة وكلاء فرعيين معًا يصطدمون بهذا أولًا. انتظر الثواني في Retry-After، أو ارفع الحد من لوحة التحكم، أو امنح كل وكيل مفتاحه الخاص.
400 invalid_reasoning_effortأرسل الوكيل مستوى تفكير لا يقبله النموذج. يقبل DeepSeek: none وlow وhigh وmax؛ ويقبل GLM: low أو high.
404الرابط خاطئ أو تكرر فيه المسار. استخدم https://nokeep.ai/v1 بدون /chat/completions، وتحقق من معرّف النموذج في /v1/models.
503النموذج مشغول. أعد المحاولة بعد ثوانٍ؛ لم يُخصم أي شيء.
سطر التجربة الثابتالإعداد يعمل. استبدل بمفتاحك الخاص لتحصل على ردود حقيقية.

كل خطأ مدرج مع حله في الأخطاء.

أسئلة

هل يُحفظ الكود الخاص بي؟

لا. نحتفظ بصف واحد من العدادات لكل استدعاء: الوقت والمفتاح والنموذج والرموز والرصيد والحالة. لا نحتفظ أبدًا بالمطالبة أو الملفات أو الرد. ما نحتفظ به.

لماذا يكلف الاستدعاء الثاني أقل من الأول؟

الاستدعاء الثاني يبدأ كما بدأ الأول، فتُقرأ تلك البداية من الكاش بسعر 0.011 دولار لكل مليون رمز بدلًا من 0.45 دولار. معظم دخل الوكيل يكون مخزّنًا بعد استدعائه الأول.