AgentScope - منصة تطوير متعددة الوكلاء مرنة وقوية

نظرة عامة على المشروع

AgentScope هي منصة مبتكرة متعددة الوكلاء، مصممة خصيصًا للمطورين لبناء تطبيقات متعددة الوكلاء تعتمد على نماذج اللغة الكبيرة (LLM). تعتمد المنصة على تبادل الرسائل كآلية اتصال أساسية، مما يقلل بشكل كبير من عتبة التطوير والفهم.

عنوان GitHub: https://github.com/agentscope-ai/agentscope

الميزات الأساسية

1. مبادئ التصميم الصديقة للمطورين

• الأولوية للشفافية: شفافة تمامًا للمطورين، بما في ذلك هندسة المطالبات، استدعاءات واجهة برمجة التطبيقات (API)، بناء الوكلاء، وتنسيق سير العمل، وكلها مرئية وقابلة للتحكم.
• التحكم في الوقت الفعلي: يمكن مقاطعة الوكيل في أي لحظة وتخصيص طريقة المعالجة.
• استقلالية النموذج: برمجة لمرة واحدة، تعمل مع جميع النماذج.
• بناء الوكلاء بأسلوب LEGO: جميع المكونات معيارية ومستقلة.

2. تصميم موجه نحو الوكلاء المتعددين

• تمرير الرسائل الصريح: مصمم خصيصًا للوكلاء المتعددين، ويدعم تمرير الرسائل الواضح وتنسيق سير العمل.
• لا تغليف عميق: يتجنب التغليف المعقد، ويحافظ على قابلية قراءة الكود وصيانته.
• قابلية تخصيص عالية: الأدوات، المطالبات، الوكلاء، سير العمل، المكتبات الخارجية، والتصور كلها تدعم التخصيص.

3. آلية قوية لتحمل الأخطاء

يوفر AgentScope آليات تحمل أخطاء مدمجة وقابلة للتخصيص، بالإضافة إلى دعم على مستوى النظام لإدارة واستخدام البيانات متعددة الوسائط والأدوات والمعرفة الخارجية. يشمل ذلك:

• آلية إعادة المحاولة على مستوى الخدمة لضمان موثوقية واجهة برمجة التطبيقات (API).
• أدوات تصحيح قائمة على القواعد لمعالجة مشكلات التنسيق في استجابات نماذج اللغة الكبيرة (LLM).
• إعدادات تحمل الأخطاء القابلة للتخصيص (مثل parse_func، fault_handler، max_retries).
• نظام تسجيل خاص بتطبيقات الوكلاء المتعددين.

4. دعم المعمارية الموزعة

• إطار عمل موزع قائم على الفاعلين (Actor-based): يدعم التحويل السهل بين النشر المحلي والموزع.
• التحسين المتوازي التلقائي: يحقق التحسين المتوازي دون جهد إضافي.
• دعم المحاكاة واسعة النطاق: قادر على محاكاة مليون وكيل على 4 أجهزة.

الميزات الجديدة في AgentScope 1.0

دعم التنفيذ غير المتزامن

• يتبنى بالكامل نمط التنفيذ غير المتزامن.
• يوفر العديد من الميزات والتحسينات الجديدة.

وظائف الوحدات الأساسية

الوحدة	الوظيفة	الوصف
النموذج (Model)	دعم الاستدعاء غير المتزامن	يدعم الاستدعاءات غير المتزامنة لمختلف نماذج اللغة الكبيرة (LLM).
الأداة (Tool)	تكامل الأدوات	مكتبة غنية بوظائف الأدوات.
بروتوكول التحكم بالنموذج (MCP)	بروتوكول التحكم بالنموذج	يدعم تكامل بروتوكول التحكم بالنموذج.
التتبع (Tracing)	مراقبة التتبع	تتبع وتنفيذ التطبيق وتصوره.
الذاكرة (Memory)	الذاكرة طويلة الأمد	إدارة الذاكرة طويلة الأمد للوكلاء.
الجلسة (Session)	إدارة الجلسات	إدارة الحالة والجلسات.
التقييم (Evaluation)	نظام التقييم	تقييم أداء الوكلاء.
منسق المطالبات (Prompt Formatter)	تنسيق المطالبات	أداة ذكية لتنسيق المطالبات.

البنية التقنية

آلية تبادل الرسائل

يعتمد AgentScope آلية اتصال قائمة على الرسائل:

from agentscope.message import Msg


message_from_alice = Msg("Alice", "Hi!")
message_with_media = Msg("Bob", "What about this picture?", url="/path/to/picture.jpg")

إنشاء الوكيل

from agentscope.agent import ReActAgent, UserAgent
from agentscope.model import DashScopeChatModel
from agentscope.formatter import DashScopeChatFormatter
from agentscope.memory import InMemoryMemory
from agentscope.tool import Toolkit, execute_python_code

import os, asyncio

async def main():
    toolkit = Toolkit()
    toolkit.register_tool_function(execute_python_code)
    
    agent = ReActAgent(
        name="Friday",
        sys_prompt="You're a helpful assistant named Friday.",
        model=DashScopeChatModel(
            model_name="qwen-max",
            api_key=os.environ["DASHSCOPE_API_KEY"],
            stream=True,
        ),
        memory=InMemoryMemory(),
        formatter=DashScopeChatFormatter(),
        toolkit=toolkit,
    )
    
    user = UserAgent(name="user")
    
    msg = None
    while True:
        msg = await agent(msg)
        msg = await user(msg)
        if msg.get_text_content() == "exit":
            break

asyncio.run(main())

المسارات وسير العمل

from agentscope.pipeline import MsgHub, sequential_pipeline
from agentscope.message import Msg

async def multi_agent_conversation():
 
    agent1 = ...
    agent2 = ...
    agent3 = ...
    
   
    pipeline = sequential_pipeline([agent1, agent2, agent3])
    result = await pipeline(initial_message)

تكامل بروتوكول التحكم بالنموذج (MCP)

from agentscope.mcp import HttpStatelessClient
from agentscope.tool import Toolkit
import os

async def fine_grained_mcp_control():

    client = HttpStatelessClient(
        name="gaode_mcp",
        transport="streamable_http",
        url=f"https://mcp.amap.com/mcp?key={os.environ['GAODE_API_KEY']}",
    )
    
  
    func = await client.get_callable_function(func_name="maps_geo")
    

    await func(address="Tiananmen Square", city="Beijing")
    

    toolkit = Toolkit()
    toolkit.register_tool_function(func)

دعم البيانات متعددة الوسائط

يستخدم AgentScope استراتيجية التحميل المتأخر، ويفصل نقل البيانات متعددة الوسائط عن التخزين من خلال توفير خاصية موحدة قائمة على عنوان URL في الرسائل. يدعم:

• معالجة بيانات النصوص والصور والصوت والفيديو.
• الإشارة إلى البيانات بناءً على عنوان URL.
• آلية التحميل عند الطلب.

نظام الأدوات والخدمات البيئي

وظائف الخدمة المدمجة

• تنفيذ كود بايثون.
• البحث عبر الويب.
• عمليات الملفات.
• تكامل المعرفة الخارجية.

دعم RAG (التوليد المعزز بالاسترجاع)

• وحدة معالجة المعرفة الشاملة (من البداية إلى النهاية).
• نظام استرجاع عالي التكوين.
• مكونات معالجة المعرفة القابلة للمشاركة.

التثبيت والاستخدام

متطلبات النظام

• بايثون 3.10 أو أحدث.

طرق التثبيت

التثبيت من المصدر (موصى به)

git clone -b main https://github.com/agentscope-ai/agentscope.git


cd agentscope
pip install -e .

التثبيت من PyPI

pip install agentscope

AgentScope Studio

npm install -g @agentscope/studio
as_studio

دعم النماذج

يدعم AgentScope مجموعة واسعة من نماذج اللغة الكبيرة:

واجهات برمجة التطبيقات السحابية (Cloud APIs)

• سلسلة OpenAI GPT
• DashScope (علي بابا كلاود)
• جوجل جيميني
• ZhipuAI
• واجهة برمجة تطبيقات LiteLLM

النشر المحلي

• Ollama
• Flask + Transformers/ModelScope
• FastChat
• vLLM

سيناريوهات التطبيق

المحاكاة واسعة النطاق

• محاكاة الأسواق المالية.
• نمذجة التخطيط الحضري.
• تحليل تأثيرات السياسات.
• دراسات السلوك الاجتماعي.

المهام التعاونية

• محاكاة فرق تطوير البرمجيات.
• أنظمة الحوار متعددة الأدوار.
• حل المشكلات المعقدة.
• معالجة المعرفة التعاونية.

تطبيقات الشركات

• أتمتة خدمة العملاء.
• تحسين العمليات التجارية.
• دعم اتخاذ القرار الذكي.
• نمذجة إدارة المخاطر.

المجتمع والدعم

• الوثائق الرسمية: https://doc.agentscope.io/
• مستودع GitHub: https://github.com/agentscope-ai/agentscope
• حزمة PyPI: https://pypi.org/project/agentscope/
• الدروس التعليمية والأمثلة: وثائق تعليمية كاملة وأكواد أمثلة غنية.

يمثل AgentScope تقدمًا كبيرًا في تطوير أنظمة الوكلاء المتعددين، ويوفر للباحثين والمطورين منصة قوية ومرنة وسهلة الاستخدام لإطلاق العنان لإمكانات الوكلاء بالكامل.