الوكلاء

إعدادات وكلاء البرمجة

اختر وكيلك والخيارات لتحصل على أمر التثبيت وملفات الإعداد وطريقة للتحقق من أن الوكيل يستخدم Beam بالفعل. يستند إلى دليل البدء السريع لوكلاء البرمجة من Reflection.

OpenCode
الوكيل
مستوى الاستدلال الافتراضي
موقع الإعداد
وكيل طرفية مفتوح المصدر، اختبرته Reflection باستخدام OpenCode 1.18.34. يوجّه interleaved.field الوكيل إلى إرسال reasoning_content مجددًا. أبقِ "model" في الإعداد، وإلا فقد يبدأ OpenCode باستخدام نموذج من مزوّد آخر.
  1. تثبيت

    bash
    curl -fsSL https://opencode.ai/install | bash
    # or: npm install -g opencode-ai
  2. إعداد

    أوامر الطرفية
    export REFLECTION_API_KEY="<your API key>"
    
    # Check the key: the list should include Beam-501B-A23B
    curl https://api.reflection.ai/openai/v1/models -H "Authorization: Bearer $REFLECTION_API_KEY"
    opencode.json
    {
      "$schema": "https://opencode.ai/config.json",
      "provider": {
        "reflection": {
          "npm": "@ai-sdk/openai-compatible",
          "name": "Reflection",
          "options": {
            "baseURL": "https://api.reflection.ai/openai/v1",
            "apiKey": "{env:REFLECTION_API_KEY}"
          },
          "models": {
            "Beam-501B-A23B": {
              "name": "Beam-501B-A23B",
              "modalities": {
                "input": [
                  "text"
                ],
                "output": [
                  "text"
                ]
              },
              "limit": {
                "context": 262144,
                "output": 131072
              },
              "reasoning": true,
              "interleaved": {
                "field": "reasoning_content"
              },
              "variants": {
                "xhigh": {
                  "reasoningEffort": "xhigh"
                },
                "max": {
                  "reasoningEffort": "max"
                }
              }
            }
          }
        }
      },
      "model": "reflection/Beam-501B-A23B",
      "permission": {
        "bash": "ask",
        "edit": "ask"
      }
    }
  3. التحقق من النموذج

    bash
    opencode models reflection
    # prints: reflection/Beam-501B-A23B
  4. تشغيل

    bash
    cd your-project
    opencode
    # one-shot: opencode run --variant high "<prompt>" </dev/null

المشكلات المعروفة

400: المعلمة المطلوبة reasoning_content غير موجودة

أعادت الجلسة خطوة assistant من دون الاستدلال الخاص بها. ابدأ جلسة جديدة (/new، أو opencode run من دون -c). في Hermes، تحقق من أن model.reasoning_echo هي true.

يستخدم الوكيل نموذجًا مختلفًا

تحقّق من اسم النموذج الذي يطبعه الوكيل عند بدء التشغيل. في Mirror، شغّل /model reflection؛ وفي Pi وOpenCode، تحقّق من المزوّد الافتراضي والنموذج في ملف الإعدادات.

404 أو لم يتم العثور على النموذج

يجب أن ينتهي عنوان URL الأساسي بـ /openai/v1، من دون أي شيء بعده، ويجب أن يكون معرّف النموذج Beam-501B-A23B تمامًا.

تأخّر طويل قبل ظهور المخرجات

يجري Beam الاستدلال قبل الإجابة، وقد تستغرق المهام الكبيرة بعض الوقت. عند تكرار أخطاء 502 أو 503، أعد محاولة تنفيذ المهمة.

المصدر: developers.reflection.ai/coding-agents-quickstart