Claude Agent SDK vs OpenAI Agents SDK مقارنة

// Claude Agent SDK (TypeScript) - subagent قائم على ملف + تقييد أدوات MCP
// المصدر: docs.claude.com/en/api/agent-sdk/subagents + /mcp
import { query } from "@anthropic-ai/claude-agent-sdk";

const result = query({
  prompt: "ابحث عن الاختبارات الفاشلة في المستودع وأصلحها",
  options: {
    // تعريف subagent برمجي — البديل القائم على الملفات: .claude/agents/*.md
    agents: {
      "test-fixer": {
        description: "يحلّل الاختبارات الفاشلة ويصلحها",
        prompt: "أنت مهندس اختبارات. شغّل الاختبار أولًا، ثم ابحث عن السبب الجذري.",
        tools: ["Read", "Edit", "Bash"], // tool restriction
      },
    },
    // خادم MCP: الاتصال كعملية محلية
    mcpServers: {
      github: {
        command: "npx",
        args: ["-y", "@modelcontextprotocol/server-github"],
      },
    },
    permissionMode: "default", // يدخل ترتيب hooks + deny/ask/allow حيّز التنفيذ
  },
});

for await (const message of result) {
  if (message.type === "result") {
    console.log("التكلفة الإجمالية:", message.total_cost_usd);
    console.log("استخدام النموذج:", message.modelUsage);
  }
}

# OpenAI Agents SDK (Python) - Handoff + guardrail + MCP (stdio)
# المصدر: openai.github.io/openai-agents-python/multi_agent/ + /mcp/ + /guardrails/
from agents import Agent, Runner, handoff, input_guardrail, GuardrailFunctionOutput
from agents.mcp import MCPServerStdio

async def main():
    async with MCPServerStdio(
        params={"command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"]},
    ) as github_mcp:

        @input_guardrail
        async def block_secrets(ctx, agent, input_text: str) -> GuardrailFunctionOutput:
            contains_secret = "sk-" in input_text
            return GuardrailFunctionOutput(
                output_info={"blocked": contains_secret},
                tripwire_triggered=contains_secret,
            )

        triage_agent = Agent(
            name="Triage",
            instructions="حلّل المهمة، وحوّلها إلى الوكيل الخبير المناسب.",
            input_guardrails=[block_secrets],
        )

        fixer_agent = Agent(
            name="TestFixer",
            instructions="أصلح الاختبارات الفاشلة.",
            mcp_servers=[github_mcp],
        )

        triage_agent.handoffs = [handoff(fixer_agent)]

        result = await Runner.run(triage_agent, "أصلح الاختبارات الفاشلة في المستودع")
        print(result.final_output)