Hub documentation
البناء باستخدام SDK
البناء باستخدام SDK
ابنِ وكلاءً مدعومين بـ MCP باستخدام حزم Hugging Face البرمجية الوكيلة. توفر مكتبتا huggingface_hub (لغة بايثون) و@huggingface/tiny-agents (لغة جافاسكربت) كل ما تحتاجه لربط نماذج اللغة الكبيرة بأدوات MCP.
التثبيت
pip install "huggingface_hub[mcp]"npm install @huggingface/tiny-agents
# or
pnpm add @huggingface/tiny-agentsالبدء السريع: تشغيل وكيل
أسرع طريقة للبدء هي من خلال واجهة سطر الأوامر tiny-agents:
tiny-agents run julien-c/flux-schnell-generator
npx @huggingface/tiny-agents run "julien-c/flux-schnell-generator"يحمّل هذا الأمر وكيلًا من مجموعة tiny-agents، ويتصل بخوادم MCP الخاصة به، ويبدأ محادثة تفاعلية.
استخدام فئة الوكيل
تدير فئة Agent حلقة الدردشة وتنفيذ أدوات MCP. وتستخدم مزودي الاستدلال لتشغيل نموذج LLM.
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())راجع مرجع الوكيل لجميع الخيارات.
import { Agent } from "@huggingface/tiny-agents";
const agent = new Agent({
model: "Qwen/Qwen2.5-72B-Instruct",
provider: "novita",
apiKey: process.env.HF_TOKEN,
servers: [
{
type: "sse",
url: "https://evalstate-flux1-schnell.hf.space/gradio_api/mcp/sse"
}
]
});
await agent.loadTools();
for await (const chunk of agent.run("Generate an image of a sunset")) {
if ("choices" in chunk) {
const delta = chunk.choices[0]?.delta;
if (delta.content) {
console.log(delta.content);
}
}
}راجع توثيق tiny-agents لجميع الخيارات.
استخدام MCPClient مباشرة
للحصول على مزيد من التحكم، استخدم MCPClient لإدارة خوادم MCP واستدعاءات الأدوات مباشرةً.
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 لجميع الخيارات.
يستخدم حزمة تطوير JavaScript فئة Agent للتفاعلات مع MCP. للحصول على تحكم أدنى مستوى، راجع حزمة @huggingface/mcp-client.
شارك وكيلك
ساهم في إضافة وكلاء إلى مجموعة tiny-agents على الـ Hub. تتضمن:
agent.json- تكوين الوكيل (مطلوب)PROMPT.mdأوAGENTS.md- موجه النظام (اختياري)EXAMPLES.md- أمثلة على الأوامر والاستخدامات (اختياري)
التعرف على المزيد
- مرجع huggingface_hub MCP - مرجع واجهة برمجة التطبيقات بلغة بايثون
- توثيق tiny-agents - مرجع واجهة برمجة تطبيقات JavaScript
- مزودو الاستدلال - مزودو نماذج اللغة الكبيرة المتاحة
- مجموعة tiny-agents - تصفح وكلاء المجتمع
- دليل خادم MCP - الاتصال بخادم Hugging Face MCP