CodeAct

يتيح CodeAct لعامل حل مهمة عن طريق كتابة التعليمات البرمجية وتنفيذها من خلال أداة execute_code . بدلا من مطالبة النموذج بطرح استدعاء أداة واحدة في كل مرة، تمنحه CodeAct مكانا معزولا لدمج تدفق التحكم وتحويل البيانات وتنسيق الأدوات داخل خطوة تنفيذ واحدة.

في إطار عمل العامل، يتم عرض CodeAct من خلال حزم خلفية خاصة بدلا من نوع أساسي مضمن واحد. يمكن للموصل إضافة execute_code الأداة، وحقن إرشادات وقت التشغيل، وعرض الأدوات المملوكة للموفر التي يمكن استدعاها من داخل بيئة الاختبار المعزولة اختياريا.

لماذا CodeAct

غالبا ما لا ياختناق وكلاء الذكاء الاصطناعي الحديثون من خلال جودة النموذج، ولكن من خلال الحمل التزامني. عندما يقوم العامل بسلاسل العديد من استدعاءات الأدوات الصغيرة معا، تتطلب كل خطوة عادة تحويل نموذج آخر، ما يزيد من زمن الانتقال واستخدام الرمز المميز.

يطوي CodeAct هذا النموذج -> الأداة -> حلقة النموذج. بدلا من مطالبة النموذج باختيار أداة واحدة في كل مرة، يمكن ل Agent Framework كشف أداة واحدة execute_code والسماح للنموذج بالتعبير عن الخطة الكاملة كبرنامج قصير. تظل الأدوات كما هي، والنموذج يبقى كما هو، والتغيير الرئيسي هو أن الخطة تعمل مرة واحدة داخل بيئة الاختبار المعزولة بدلا من أن تكون مبعثرة عبر العديد من من منعطفات استدعاء الأدوات.

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

عندما يكون CodeAct مناسبا

استخدم CodeAct عندما تستفيد مهمة من:

  • الجمع بين استدعاءات أدوات متعددة مع التكرارات الحلقية أو التفريع أو التصفية أو التجميع
  • تحويل نتائج الأداة قبل إرجاع إجابة نهائية
  • إنشاء مخرجات أو بيانات اصطناعية منظمة أكبر كجزء من التشغيل
  • الاحتفاظ ببعض الأدوات متاحة فقط داخل بيئة تنفيذ خاضعة للرقابة
  • طي العديد من عمليات البحث الصغيرة القابلة للتسلسل أو الحسابات الخفيفة في خطوة تنفيذ واحدة

ابق مع استدعاء الأداة المباشرة عندما:

  • تحتاج المهمة إلى استدعاء واحد أو اثنين فقط من الأدوات، لذلك هناك القليل من حمل التنسيق لإزالته
  • كل مكالمة لها آثار جانبية يجب أن تظل مرئية بشكل فردي للنموذج والمستخدم
  • تحتاج إلى مطالبات الموافقة لكل مكالمة بدلا من قرار موافقة واحد حول التشغيل بأكمله execute_code

كيفية ملاءمة CodeAct في إطار عمل العامل

يقوم موصل CodeAct عادة بأربعة أشياء للتشغيل:

  1. execute_code إضافة أداة إلى سطح الأداة التي تواجه النموذج.
  2. يوفر إرشادات لوقت تشغيل بيئة الاختبار المعزولة المكونة.
  3. يعرض اختياريا الأدوات المملوكة لموفر الخدمة من خلال call_tool(...).
  4. تطبيق حدود القدرة مثل الوصول إلى نظام الملفات أو قوائم السماح بالشبكة الصادرة.

نظرا لأن الموصل يمتلك تكوين وقت التشغيل، تعتمد تفاصيل الإعداد الدقيقة على الخلفية التي تختارها.

القيود الحالية

CodeAct مناسب جدا لسير العمل كثيف الأدوات، ولكن هناك بعض القيود الحالية التي يجب وضعها في الاعتبار:

  • موصل إطار عمل العامل الموثق اليوم هو Hyperlight CodeAct، متوفر لكل من Python .NET (في المعاينة).
  • تنطبق الموافقات حاليا على execute_code المكالمة ككل. إذا كنت بحاجة إلى الموافقة على العمليات الفردية واحدا تلو الآخر، فاحتفظ بهذه العمليات كأدوات عامل مباشر بدلا من الاعتماد على call_tool(...).
  • الأدوات التي تم الوصول إليها لا call_tool(...) تزال تنفذ في عملية المضيف. استخدم أدوات المضيف الضيقة والمراجعة للإداء/الإخراج الحساس بدلا من توسيع الوصول إلى بيئة الاختبار المعزولة دون داع.
  • تعمل CodeAct بشكل أفضل عندما يهيمن حمل التنسيق. بالنسبة للمهام الصغيرة مع استدعاء واحد أو اثنين فقط من الأدوات، قد لا يشتريك التجريد المضاف كثيرا.
  • أسماء الأدوات وبيانات تعريف المعلمة وإرجاع الأشكال مهمة أكثر هنا لأن النموذج يكتب التعليمات البرمجية مقابل هذا العقد بدلا من الاختيار من استدعاء أداة مباشرة واحدة في كل مرة.

Get started

على سبيل .NET، الموصل الموثق اليوم هو Hyperlight CodeAct، يتم شحنه كحزمةMicrosoft.Agents.AI.Hyperlight.

توفر الحزمة:

  • HyperlightCodeActProvider AIContextProvider— الذي يضخ execute_code وإرشادات CodeAct لكل تشغيل
  • HyperlightExecuteCodeFunction — مستقل AIFunction عن الأسلاك الثابتة/اليدوية عند إصلاح تكوين بيئة الاختبار المعزولة
  • الأدوات التي يديرها الموفر والتي تظل متوفرة داخل بيئة الاختبار المعزولة من خلال call_tool(...)
  • CodeActApprovalMode والتكامل ApprovalRequiredAIFunction للموافقات
  • تكوين نظام الملفات الاختياري (FileMountsو HostInputDirectory) والشبكة الصادرة (AllowedDomains) لوقت تشغيل بيئة الاختبار المعزولة

Important

حزمة .NET قيد المعاينة وتعتمد على Hyperlight.HyperlightSandbox.Api NuGet، والتي لم يتم نشرها بعد على nuget.org. راجع Hyperlight CodeAct للحصول على تحذيرات التثبيت الحالية ومتطلبات النظام الأساسي.

راجع Hyperlight CodeAct للتثبيت والأمثلة والإرشادات الخاصة بوقت التشغيل.

Get started

على سبيل Python، الموصل الموثق اليوم هو Hyperlight CodeAct.

توفر حزمة Hyperlight ما يلي:

  • HyperlightCodeActProvider بالنسبة إلى عمليات التشغيل المستندة إلى موفر السياق
  • HyperlightExecuteCodeTool عندما تريد السلك execute_code مباشرة
  • الأدوات التي يديرها الموفر والتي تظل متوفرة داخل بيئة الاختبار المعزولة من خلال call_tool(...)
  • نظام الملفات الاختياري وتكوين الشبكة الصادرة لوقت تشغيل بيئة الاختبار المعزولة

راجع Hyperlight CodeAct للتثبيت والأمثلة والإرشادات الخاصة بوقت التشغيل مثل وقت الاستخدام print(...) و /output/والقيود الحالية الخاصة ب Hyperlight.

Note

سيتوفر الدعم لهذه الميزة قريبا. راجع مستودع Agent Framework Go للحصول على أحدث حالة.

الخطوات التالية

أمان العامل

المحتوى ذو الصلة

  • Last updated on