الانتقال إلى المحتوى الرئيسي

Code Execution

يشغّل code_execution تحليل Python بعيدًا ومعزولًا على Responses API من xAI. وهذا يختلف عن exec المحلي:
  • يشغّل exec أوامر shell على جهازك أو عقدتك
  • يشغّل code_execution Python في sandbox البعيد الخاص بـ xAI
استخدم code_execution من أجل:
  • العمليات الحسابية
  • إعداد الجداول
  • الإحصاءات السريعة
  • التحليل على نمط الرسوم البيانية
  • تحليل البيانات التي يعيدها x_search أو web_search
لا تستخدمه عندما تحتاج إلى ملفات محلية، أو shell الخاص بك، أو المستودع، أو الأجهزة المقترنة. استخدم exec لذلك.

الإعداد

تحتاج إلى مفتاح xAI API. أي من هذه الخيارات يعمل:
  • XAI_API_KEY
  • plugins.entries.xai.config.webSearch.apiKey
مثال:
{
  plugins: {
    entries: {
      xai: {
        config: {
          webSearch: {
            apiKey: "xai-...",
          },
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
            maxTurns: 2,
            timeoutSeconds: 30,
          },
        },
      },
    },
  },
}

كيفية استخدامه

اطلب ذلك بشكل طبيعي واجعل نية التحليل واضحة:
Use code_execution to calculate the 7-day moving average for these numbers: ...
Use x_search to find posts mentioning OpenClaw this week, then use code_execution to count them by day.
Use web_search to gather the latest AI benchmark numbers, then use code_execution to compare percent changes.
تأخذ الأداة داخليًا معامل task واحدًا، لذا يجب على الوكيل إرسال طلب التحليل الكامل وأي بيانات مضمنة في مطالبة واحدة.

الحدود

  • هذا تنفيذ بعيد عبر xAI، وليس تنفيذ عمليات محلية.
  • يجب التعامل معه على أنه تحليل مؤقت، وليس دفتر ملاحظات دائم.
  • لا تفترض وجود وصول إلى الملفات المحلية أو مساحة العمل الخاصة بك.
  • للحصول على بيانات X الحديثة، استخدم x_search أولًا.

انظر أيضًا