وكلاء Claude المُدارة: قم بتوصيل 49 أداة MCP في تكوين واحد

لديك وكيل الترميز. يقرأ الملفات، ويجري الاختبارات، ويكتب التعليمات البرمجية. ولكن عندما تطلب ذلك تحقق مما إذا كانت شهادة SSL الخاصة بك تنتهي صلاحيتها الأسبوع المقبل، أو تحقق من صحة البريد الإلكتروني للعميل، أو قم بإنشاء رمز الاستجابة السريعة بالنسبة لعنوان URL للنشر الخاص بك، فإنه يصطدم بالحائط. ليس لديه إمكانية الوصول إلى العالم الخارجي.

يعمل MCP (بروتوكول السياق النموذجي) على إصلاح مشكلة الوصول إلى الأداة. يقوم الوكلاء المُدارون بإصلاح البنية التحتية مشكلة. بدلاً من إنشاء حلقة الوكيل الخاصة بك من خلال اكتشاف الأدوات ومعالجة الأخطاء ووضع الحماية، ترسل تكوينًا إلى Anthropic's API وتستعيد وكيلًا منسقًا بالكامل يقوم ببث النتائج على SSE.

يقوم هذا البرنامج التعليمي بتوصيل خادم botoi MCP (49 أداة مطور) إلى وكيل Claude Managed Agent. بواسطة في النهاية، سيكون لديك وكيل مستقل يمكنه البحث عن سجلات DNS والتحقق من صحة رسائل البريد الإلكتروني والتحقق من طبقة المقابس الآمنة (SSL). الشهادات، وسلاسل التجزئة، وفك تشفير JWTs، والمزيد؛ كل ذلك من خلال استدعاء API واحد.

ما هي وكلاء كلود المدارة

تم إطلاق Managed Agents في الإصدار التجريبي العام في 8 أبريل 2026. الفكرة الأساسية: Anthropic تدير الوكيل حلقة من جانب الخادم. يمكنك تحديد النموذج وموجه النظام والأدوات وخوادم MCP. مقابض أنثروبي وضع الحماية، وتنسيق الأدوات، والتنفيذ متعدد الأدوار، والبث.

يعمل الوكيل داخل الجلسة. تحصل كل جلسة على بيئة وضع الحماية الخاصة بها، ويتم تنفيذ ما يصل إلى عدد قابل للتكوين من المنعطفات، وتدفق الأحداث مرة أخرى إلى عميلك عبر SSE. عند الوكيل يحتاج إلى أداة، فإنه يستدعيها بشكل مستقل، ويقرأ النتيجة، ويستمر في التفكير.

تتطلب كافة نقاط نهاية الوكلاء المُدارين managed-agents-2026-04-01 رأس بيتا. التسعير هو معدلات رمزية Claude API القياسية بالإضافة إلى ذلك 0.08 دولار لكل ساعة جلسة. ويب البحث، إذا تم تمكينه، يكلف 10 دولارات لكل 1000 عملية بحث.

قم بإنشاء وكيل مُدار باستخدام botoi MCP

الإعداد عبارة عن استدعاء API واحد. يمكنك تمرير عنوان URL لخادم botoi MCP في ملف mcp_servers مصفوفة, ويكتشف الوكيل المُدار جميع الأدوات الـ 49 عند بداية الجلسة.

حليقة

curl https://api.anthropic.com/v1/managed_agents \\
  --header "x-api-key: \$ANTHROPIC_API_KEY" \\
  --header "anthropic-version: 2023-06-01" \\
  --header "anthropic-beta: managed-agents-2026-04-01" \\
  --header "content-type: application/json" \\
  --data '{
    "model": "claude-sonnet-4-6",
    "name": "devops-agent",
    "system": "You are a DevOps assistant. Use the available MCP tools to check infrastructure health, validate configurations, and generate reports.",
    "mcp_servers": [
      {
        "type": "streamable_http",
        "url": "https://api.botoi.com/mcp",
        "headers": {
          "Authorization": "Bearer YOUR_BOTOI_API_KEY"
        }
      }
    ],
    "max_turns": 20
  }'

تؤكد الاستجابة اتصال خادم MCP وتوضح عدد الأدوات التي تم اكتشافها:

{
  "id": "agent_01ABC123",
  "name": "devops-agent",
  "model": "claude-sonnet-4-6",
  "mcp_servers": [
    {
      "type": "streamable_http",
      "url": "https://api.botoi.com/mcp",
      "status": "connected",
      "tools_discovered": 49
    }
  ],
  "max_turns": 20,
  "created_at": "2026-04-11T10:30:00Z"
}

بدون مصادقة

لإجراء اختبار سريع، قم بتخطي مفتاح botoi API بالكامل:

"mcp_servers": [
  {
    "type": "streamable_http",
    "url": "https://api.botoi.com/mcp"
  }
]

تشغيل جلسة: مثال حقيقي

بعد إنشاء الوكيل، ابدأ الجلسة. يطلب هذا المثال من الوكيل التحقق من ثلاثة أشياء stripe.com في موجه واحد. يحدد الوكيل أدوات MCP التي يجب الاتصال بها، ويستدعيها تسلسل، ويجمع التقرير.

curl https://api.anthropic.com/v1/managed_agents/agent_01ABC123/sessions \\
  --header "x-api-key: \$ANTHROPIC_API_KEY" \\
  --header "anthropic-version: 2023-06-01" \\
  --header "anthropic-beta: managed-agents-2026-04-01" \\
  --header "content-type: application/json" \\
  --data '{
    "messages": [
      {
        "role": "user",
        "content": "Check the SSL certificate for stripe.com, validate the email security@stripe.com, and look up their DNS MX records."
      }
    ],
    "stream": true
  }'

يُظهر تدفق SSE منطق الوكيل واستدعاءات الأداة والمخرج النهائي:

event: message_start
data: {"type": "message_start", "session_id": "sess_01XYZ"}

event: content_block_delta
data: {"type": "text", "text": "I'll check three things for stripe.com. Let me start."}

event: tool_use
data: {"type": "tool_use", "name": "lookup_ssl", "input": {"domain": "stripe.com"}}

event: tool_result
data: {"type": "tool_result", "content": {"issuer": "DigiCert", "valid_to": "2027-01-15", "days_remaining": 279, "expired": false}}

event: tool_use
data: {"type": "tool_use", "name": "lookup_email", "input": {"email": "security@stripe.com"}}

event: tool_result
data: {"type": "tool_result", "content": {"valid": true, "mx_found": true, "disposable": false}}

event: tool_use
data: {"type": "tool_use", "name": "lookup_dns", "input": {"domain": "stripe.com", "type": "MX"}}

event: tool_result
data: {"type": "tool_result", "content": {"records": [{"priority": 1, "value": "aspmx.l.google.com"}, {"priority": 5, "value": "alt1.aspmx.l.google.com"}]}}

event: content_block_delta
data: {"type": "text", "text": "Here's the summary:\\n\\n1. **SSL**: Valid until Jan 15, 2027 (279 days). Issued by DigiCert.\\n2. **Email**: security@stripe.com is valid with MX records present.\\n3. **MX Records**: Stripe uses Google Workspace (aspmx.l.google.com)."}

event: message_stop
data: {"type": "message_stop", "session_id": "sess_01XYZ"}

تم استدعاء ثلاث أدوات، وتم جمع ثلاث نتائج، وإنشاء ملخص واحد. اختار الوكيل lookup_ssl, lookup_email، و lookup_dns من تلقاء نفسها على أساس موجه. لا يوجد منطق توجيه للأداة من جانبك.

أمثلة بايثون وNode.js

بايثون

import anthropic

client = anthropic.Anthropic()

# Create the agent once
agent = client.beta.managed_agents.create(
    model="claude-sonnet-4-6",
    name="devops-agent",
    system="You are a DevOps assistant. Use MCP tools to check infrastructure.",
    mcp_servers=[
        {
            "type": "streamable_http",
            "url": "https://api.botoi.com/mcp",
            "headers": {
                "Authorization": "Bearer YOUR_BOTOI_API_KEY",
            },
        }
    ],
    max_turns=20,
    betas=["managed-agents-2026-04-01"],
)

# Run a session
with client.beta.managed_agents.sessions.stream(
    agent_id=agent.id,
    messages=[
        {
            "role": "user",
            "content": "Check SSL expiry for github.com and stripe.com. Flag any cert expiring within 30 days.",
        }
    ],
    betas=["managed-agents-2026-04-01"],
) as stream:
    for event in stream:
        if event.type == "content_block_delta":
            print(event.delta.text, end="", flush=True)
        elif event.type == "tool_use":
            print(f"\\n[calling {event.name}]")

Node.js (TypeScript)

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

// Create agent
const agent = await client.beta.managedAgents.create({
  model: "claude-sonnet-4-6",
  name: "devops-agent",
  system: "You are a DevOps assistant. Use MCP tools to check infrastructure.",
  mcp_servers: [
    {
      type: "streamable_http",
      url: "https://api.botoi.com/mcp",
      headers: {
        Authorization: "Bearer YOUR_BOTOI_API_KEY",
      },
    },
  ],
  max_turns: 20,
  betas: ["managed-agents-2026-04-01"],
});

// Run a session with streaming
const stream = await client.beta.managedAgents.sessions.stream(agent.id, {
  messages: [
    {
      role: "user",
      content: "Validate the email admin@example.com and check if example.com has SPF records.",
    },
  ],
  betas: ["managed-agents-2026-04-01"],
});

for await (const event of stream) {
  if (event.type === "content_block_delta") {
    process.stdout.write(event.delta.text);
  }
}

ما تغطيه الأدوات الـ 49

خادم botoi MCP في https://api.botoi.com/mcp يعرض 49 أداة منسقة. هنا ما تتضمنه كل فئة:

كل أداة للقراءة فقط (ما عدا التشفير/فك التشفير). لا يمكن للوكيل تعديل الحالة الخارجية، والتي يجعلها آمنة للتشغيل بشكل مستقل دون بوابات الموافقة.

انهيار التكلفة

يتكون تسعير الوكلاء المُدارين من ثلاثة مكونات:

• أسعار الرمز المميز: تسعير Standard Claude API للنموذج الذي تختاره (Sonnet أو Opus أو Haiku)
• رسوم ساعة الجلسة: 0.08 USD لكل ساعة جلسة، بالتناسب مع الثانية
• البحث على شبكة الإنترنت (اختياري): 10 دولارات لكل 1000 عملية بحث

مكالمات أداة MCP إلى botoi مجانية على الجانب الإنساني. أنت تدفع فقط مقابل استخدام botoi API، و تغطي الطبقة المجانية 100 طلب يوميًا. إليك ما تبدو عليه الجلسة النموذجية:

Session duration:     3 minutes (0.05 hours)
Session-hour cost:    0.05 x \$0.08 = \$0.004
Input tokens:         12,400 (Sonnet: \$3/MTok) = \$0.037
Output tokens:        3,800 (Sonnet: \$15/MTok) = \$0.057
MCP tool calls:       6 (botoi free tier)
──────────────────────────────────
Total:                \$0.098

جلسة مدتها 3 دقائق للتحقق من شهادات SSL والتحقق من صحة رسائل البريد الإلكتروني والاستعلام عن تكاليف DNS أقل من 0.10 دولار. رسوم ساعة الجلسة (0.004 دولار لمدة 3 دقائق) لا تذكر مقارنة بتكاليف الرمز المميز.

الوكلاء المُدارون مقابل بناء حلقة الوكيل الخاصة بك

يمكنك توصيل أدوات MCP إلى Claude بنفسك باستخدام واجهة برمجة التطبيقات للرسائل مع استخدام الأداة. السؤال هو ما إذا كانت البنية التحتية العامة تستحق العناء.

# Your own agent loop (pseudocode)
while not done:
    response = call_claude(messages)
    for tool_call in response.tool_calls:
        # You handle MCP client connection
        # You handle tool discovery
        # You handle input validation
        # You handle error recovery
        # You handle sandboxing
        result = mcp_client.call(tool_call)
        messages.append(result)

# Managed Agent (one API call)
session = client.beta.managed_agents.sessions.create(
    agent_id=agent.id,
    messages=[{"role": "user", "content": prompt}],
)

إذا كنت بحاجة إلى تحكم دقيق في توجيه الأداة، أو بوابات الموافقة المخصصة، أو إعادة المحاولة غير القياسية السياسات، قم ببناء الحلقة الخاصة بك. إذا كنت تريد وكيلًا يعمل في الإنتاج باستخدام الحد الأدنى من التعليمات البرمجية، يقوم الوكلاء المُدارون بإزالة النموذج المعياري.

متى تستخدم أي نهج

• الوكلاء المدارون: أدوات داخلية، وروبوتات دردشة مع إمكانية الوصول إلى الأدوات، ونصوص أتمتة لمرة واحدة، ونماذج أولية سريعة تحتاج إلى بيانات واقعية
• الحلقة الخاصة بك: المنتجات التي تواجه المستخدم حيث تحتاج إلى تجربة مستخدم مخصصة لكل استدعاء أداة، وسير العمل الذي يتطلب موافقة الإنسان في الحلقة، ومنطق التفرع المعقد الذي لا ينبغي للوكيل أن يقرره بشكل مستقل
• كلاهما: ابدأ بالوكلاء المُدارين للنموذج الأولي، واستخرج إلى الحلقة الخاصة بك عندما تصل إلى جدار التخصيص