Omazy Plugin SDK आपको MCP-संगत plugins शिप करने देता है जिन्हें Omazy पर कोई भी व्यवसाय install कर सकता है — अपने internal tools जोड़ने के लिए, AI agents के सामने private APIs उजागर करने के लिए, या ऐसे workflow automate करने के लिए जो stock integration से मेल नहीं खाते।
दो दर्शक
चाहे आप हजारों workspaces में plugin शिप कर रहे हों या अपने व्यवसाय के लिए एक निजी बना रहे हों — एक ही SDK, एक ही runtime।
एक बार बनाएं। हर Omazy workspace ग्राहक बन जाता है। Omazy auth, billing, signing, rate limits संभालता है।
पहले से Omazy पर हैं लेकिन इसे अपने in-house CRM, ERP, या internal API से बात करवानी है? कुछ दिनों में एक private plugin बनाएं।
PLUGIN ANATOMY
ग्यारह component प्रकार। जिनकी ज़रूरत हो चुनें — Python module पर decorators से declare करें।
Functions जिन्हें AI agent call करता है: shopify.search_products, crm.lookup_account.
Read-only addressable data: shopify://products/{id}.
Plugin active होने पर agent system prompt में जुड़ने वाले text fragments.
@plugin.on_webhook — downstream system या Omazy core की events पर react करें।
Cron-driven reconcile jobs। Product catalog pull, inventory reindex।
Lifecycle: on_install, on_uninstall, on_activate। OAuth provision, defaults लिखें।
Workspace UI में buttons: 'Sync now', 'Reconnect'।
Plugin के साथ शिप होने वाले pre-built RFC 2202 chains।
5-MINUTE QUICKSTART
एक plugin scaffold करें, एक tool register करें, locally चलाएं, dev-omazy CLI से hit करें।
Step 1
uv run omazy-plugin new my-pluginStep 2
from omazy_plugin_sdk import Plugin
plugin = Plugin(slug="my-plugin", version="1.0.0", scopes=["my-plugin:read"])
@plugin.tool(
name="my.search",
description="Search the customer's catalog",
billable_meter="tool_call",
)
async def search(ctx, query: str, limit: int = 5) -> dict:
return {"results": [...] }
app = plugin.fastapi()Step 3
docker compose up dev-omazy
uv run --package omazy-plugin-my-plugin uvicorn my_plugin.main:app --port 8082Step 4
uv run dev-omazy call \
--target http://localhost:8082/tools/call \
--tool my.search \
--args '{"query":"hello"}'प्रकाशन के लिए तैयार होने पर, listing omazy.com/marketplace/submit पर submit करें। समीक्षा ~3 कार्य-दिवस लेती है।
प्रारंभिक एक्सेस प्राप्त करें →RUNTIME ARCHITECTURE
Omazy हर request sign करता है, हर event record करता है, हर scope लागू करता है।
Workspace agent एक tool call trigger करता है
intent → harness tool चुनता है → call enqueue
MCP gateway sign करता है और forward करता है
Per-vendor key से sign किया JWT · scope check · rate limit
Vendor plugin call को handle करता है
आपकी FastAPI app · vendor-stored creds · JSON return
Usage event record, response stream back
Billing meter बढ़ता है · trace store · agent जारी
Vendor-hosted
आप plugin अपने infra पर चलाते हैं। Omazy कभी vendor code execute नहीं करता।
Cred isolation
Downstream OAuth tokens (Shopify, आदि) आपके storage में रहते हैं, Omazy के नहीं।
Replayable
हर call Omazy trace store में है — customer ticket से debug करें, सिर्फ अपने logs से नहीं।
TRUST + BILLING
हर Omazy → plugin request एक per-vendor key से sign किया JWT रखती है।
Agent केवल वही tools call कर सकता है जिन्हें workspace ने स्पष्ट रूप से allowlist किया है।
Omazy billing, taxes, refunds और payouts संभालता है। आपके connected Stripe account में मासिक transfer।
Per-vendor rate limits और एक circuit breaker दोनों पक्षों की रक्षा करते हैं।
OPERATOR USE CASES
Plugins केवल marketplace के लिए नहीं हैं। वही SDK private plugins को भी power करता है।
अपने internal /orders, /customers endpoints को plugin के रूप में wrap करें।
Salesforce / HubSpot stock हैं। आपका in-house CRM नहीं। 200-line plugin बनाएं।
Insurance claim triage, multi-warehouse inventory routing, in-house compliance check।
प्रारंभिक एक्सेस · बीटा
अपना ईमेल दें और बताएं आप क्या बनाना चाहते हैं। पहले 50 plugin authors के लिए हम vendor onboarding, signing keys, और SDK team से सीधा संपर्क fast-track करेंगे।
आप सूची में हैं।
जब आपका एक्सेस तैयार होगा, हम ईमेल करेंगे।