منصة المطوّرين · دليل الإضافات
انشر الأدوات والموائمات وتكاملات المراقبة باستخدام عقد الإضافات المشترك في AgentMug. تنفّذ كل إضافة واجهة definePlugin() نفسها من @agentmug/runtime.
العمال مهام مجمّعة. توسّع الإضافات ما تستطيع بيئة التشغيل نفسها فعله. يتيح MCP لمضيف خارجي استدعاء عامل؛ بينما توسّع الإضافات قدرات العامل نفسه. وهما متكاملان — يمكن للإضافة توفير الأدوات التي يستخدمها العامل، ويعرض MCP العامل المكتمل إلى Claude Code أو Cursor أو Cline.
تُوصل الإضافات ببيئة تشغيل تستضيفها أنت. لا يوجد مسار تثبيت سحابي بعد — راجع «نشر إضافة» أدناه لمعرفة كيفية إضافة الإدخالات.
@agentmug/otelEmits LLM-call + transcription spans into your existing OTel pipeline — Honeycomb, Datadog, Tempo, Jaeger, Sentry, anything OTel-compatible.
import { runAgent, noSourcePlan } from "@agentmug/runtime";
import { OtelTracingAdapter } from "@agentmug/otel";
await runAgent({
agentId: "...",
userId: "...",
userInput: "...",
adapters: {
persistence: yourPersistence,
llm: yourLlmClient,
tracing: new OtelTracingAdapter(),
},
onEvent: () => {},
});@agentmug/mcp-bridgeExpose any AgentMug agent as a Model Context Protocol server so Claude Code, Cursor, Continue, Cline, and Claude Desktop can call it as a tool.
// In your MCP client config (.claude/settings.json):
{
"mcpServers": {
"my-agent": {
"command": "npx",
"args": [
"-y",
"@agentmug/mcp-bridge",
"https://agentmug.com/api/external/agents/<AGENT_ID>"
],
"env": { "AGENTMUG_API_KEY": "am_agent_..." }
}
}
}@agentmug/cliRun .agent files from any shell. Cloud subcommands (create / list / fork / invoke) make the runtime agent-controllable: an LLM with shell access can ship new agents into your AgentMug account.
npm install -g @agentmug/cli export AGENTMUG_API_KEY=am_user_... agentmug create --prompt "Triage my Gmail and draft replies" agentmug list agentmug invoke email-triage --input "Summarize unread"
تبدأ بنية الإضافة باستدعاء دالة واحدة: definePlugin({ name, version, tools }). ويوصل المستخدمون حزمتك باستخدام registry.loadPlugin(yourPlugin)، الذي يسجّل أدواتك.
لا يوجد مسار نشر تلقائي. انشر حزمتك على npm، ثم افتح طلب سحب يضيفها هنا مع وصف من سطر واحد — ويكون طلب السحب هو خطوة المراجعة.
ملاحظة: loadPlugin() يسجّل حاليًا أدوات فقط. يمكن للإضافة إعلان موائمات، لكن بيئة التشغيل لا تقرأها بعد — مرّر الموائمات مباشرةً إلى runAgent()، كما يفعل مثال OpenTelemetry أعلاه.