Hub documentation

البناء باستخدام SDK

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

البناء باستخدام SDK

ابنِ وكلاءً مدعومين بـ MCP باستخدام حزم Hugging Face البرمجية الوكيلة. توفر مكتبتا huggingface_hub (لغة بايثون) و@huggingface/tiny-agents (لغة جافاسكربت) كل ما تحتاجه لربط نماذج اللغة الكبيرة بأدوات MCP.

التثبيت

Python
JavaScript
pip install "huggingface_hub[mcp]"

البدء السريع: تشغيل وكيل

أسرع طريقة للبدء هي من خلال واجهة سطر الأوامر tiny-agents:

Python
JavaScript
tiny-agents run julien-c/flux-schnell-generator

يحمّل هذا الأمر وكيلًا من مجموعة tiny-agents، ويتصل بخوادم MCP الخاصة به، ويبدأ محادثة تفاعلية.

استخدام فئة الوكيل

تدير فئة Agent حلقة الدردشة وتنفيذ أدوات MCP. وتستخدم مزودي الاستدلال لتشغيل نموذج LLM.

Python
JavaScript
from huggingface_hub import Agent
import asyncio

agent = Agent(
    model="Qwen/Qwen2.5-72B-Instruct",
    provider="novita",
    servers=[
        {
            "type": "sse",
            "url": "https://evalstate-flux1-schnell.hf.space/gradio_api/mcp/sse"
        }
    ]
)

async def main():
    async for chunk in agent.run("Generate an image of a sunset"):
        if hasattr(chunk, 'choices'):
            delta = chunk.choices[0].delta
            if delta.content:
                print(delta.content, end="")

asyncio.run(main())

راجع مرجع الوكيل لجميع الخيارات.

استخدام MCPClient مباشرة

للحصول على مزيد من التحكم، استخدم MCPClient لإدارة خوادم MCP واستدعاءات الأدوات مباشرةً.

Python
JavaScript
import asyncio
from huggingface_hub import MCPClient

async def main():
    async with MCPClient(
        model="Qwen/Qwen2.5-72B-Instruct",
        provider="novita",
    ) as client:
        # Connect to an MCP server
        await client.add_mcp_server(
            type="sse", 
            url="https://evalstate-flux1-schnell.hf.space/gradio_api/mcp/sse"
        )
        
        # Process a request with tools
        messages = [{"role": "user", "content": "Generate an image of a sunset"}]
        
        async for chunk in client.process_single_turn_with_tools(messages):
            if hasattr(chunk, 'choices'):
                delta = chunk.choices[0].delta
                if delta.content:
                    print(delta.content, end="")

asyncio.run(main())

راجع مرجع MCPClient لجميع الخيارات.

شارك وكيلك

ساهم في إضافة وكلاء إلى مجموعة tiny-agents على الـ Hub. تتضمن:

  • agent.json - تكوين الوكيل (مطلوب)
  • PROMPT.md أو AGENTS.md - موجه النظام (اختياري)
  • EXAMPLES.md - أمثلة على الأوامر والاستخدامات (اختياري)

التعرف على المزيد

Update on GitHub