होस्टेड एजेंट

होस्टेड एजेंट आपको एक निजी एजेंट रनटाइम देते हैं जो आपके टूल से जुड़ता है और एम्पिरियोलैब्स मॉडल पर चलता है। प्रत्येक एजेंट अलग-थलग है, अपना स्वयं का लगातार भंडारण रखता है, और EmpirioLabs API या आपके कनेक्टेड चैनलों के माध्यम से पहुंचा जा सकता है।

होस्टेड एजेंट क्यों

ओपनक्लॉ और हेमीज़

योजनाओं

त्वरित शुरुआत

$
curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "name": "My Assistant",
>
    "agent_type": "openclaw",
>
    "plan_slug": "hosted-agent-basic"
>
  }'

$
curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

एपीआई के साथ परिनियोजित और प्रबंधित करें

सभी अनुरोध आपकी EmpirioLabs API कुंजी का उपयोग एक वाहक टोकन के रूप में करते हैं। आधार URL https://api.empiriolabs.ai है, और प्रत्येक एजेंट समापन बिंदु /v1/hosted-agents के अंतर्गत रहता है।

एक एजेंट तैनात करें

agent_type openclaw या hermes है; plan_slug hosted-agent-basic या hosted-agent-pro है। डिफ़ॉल्ट रूप से, एजेंट EmpirioLabs मॉडल पर चलता है; किसी विशिष्ट को चुनने के लिए default_model सेट करें, या इसे अपने स्वयं के प्रदाता पर इंगित करने के लिए poe या custom करने के लिए default_provider करें।

$
curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "name": "My Assistant",
>
    "agent_type": "openclaw",
>
    "plan_slug": "hosted-agent-basic",
>
    "default_model": "qwen3-7-plus"
>
  }'

अपने एजेंटों की सूची बनाएं

$
curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

एक एजेंट प्राप्त करें

$
curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

एक संदेश भेजें

$
curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/message \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "messages": [{ "role": "user", "content": "What is on my calendar today?" }]
>
  }'

प्रारंभ करें, रोकें, पुनरारंभ करें

क्रिया अंतिम पथ खंड है: start, stop, restart या refresh।

$
curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/restart \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

एजेंट का नाम बदलें

$
curl -X PATCH https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{ "name": "Renamed Assistant" }'

किसी एजेंट को हटाना

$
curl -X DELETE https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

एपीआई से हर सेटिंग कॉन्फ़िगर करें

डैशबोर्ड में आप जो कुछ भी बदल सकते हैं वह एपीआई से भी नियंत्रित होता है, इसलिए आप एजेंटों को पूरी तरह से प्रोग्रामेटिक रूप से प्रबंधित कर सकते हैं।

मॉडल या प्रदाता बदलें

एजेंट के मॉडल को जगह में स्विच करें (कोई पुन: तैनाती नहीं)। provider empirio, poe या custom है।

$
curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/model \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{ "provider": "empirio", "model": "qwen3-7-plus" }'

कौशल

कौशल पुन: प्रयोज्य प्लेबुक हैं जिनका एजेंट अनुसरण करता है। आधिकारिक रजिस्ट्री खोजें (OpenClaw ClawHub का उपयोग करता है, हेमीज़ skills.sh का उपयोग करता है) और इसके संदर्भ से एक कौशल जोड़ें, या अपना खुद का पेस्ट करें।

$
# List installed skills
$
curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
$
$
# Add an official skill (OpenClaw: clawhub:<slug>, Hermes: hermes:<id>)
$
curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{ "slug": "hermes:openai/skills/pdf" }'
$
$
# Add your own pasted skill
$
curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{ "custom": { "name": "House Style", "body": "Always answer in a concise, friendly tone." } }'
$
$
# Remove a skill
$
curl -X DELETE "https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills?slug=hermes:openai/skills/pdf" \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

कनेक्टर्स (एमसीपी)

एजेंट उपकरण और डेटा देने के लिए एक दूरस्थ MCP सर्वर संलग्न करें।

$
curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/mcp \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{ "name": "my-tools", "url": "https://example.com/mcp" }'

चैनल

एक टोकन-आधारित मैसेजिंग चैनल कनेक्ट करें (उदाहरण के लिए telegram, discord या slack) ताकि लोग वहां एजेंट से बात कर सकें। टेलीग्राम, डिस्कॉर्ड, स्लैक और मैट्रिक्स ओपनक्लॉ और हेमीज़ एजेंटों पर काम करते हैं। मैटरमोस्ट और Microsoft टीमें केवल ओपनक्लॉ हैं। WhatsApp को डैशबोर्ड से इस टोकन एंडपॉइंट के बजाय QR कोड के साथ जोड़ा गया है।

$
curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/integrations \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{ "kind": "telegram", "secret": "YOUR_BOT_TOKEN" }'

चैनल व्यवहार प्रत्येक कनेक्टर पर छोटे चैट संकेतों को नियंत्रित करता है। डिफ़ॉल्ट रूप से, टाइपिंग संकेतक और न्यूनतम संसाधन प्रतिक्रियाएं चालू हैं, पढ़ने की रसीदें बंद हैं, और लाइव उत्तर पूर्वावलोकन बंद है। लाइव उत्तर पूर्वावलोकन जहां उपलब्ध हो, प्लेटफ़ॉर्म-मूल संपादन या ड्राफ्ट पूर्वावलोकन समर्थन का उपयोग करता है; यह मॉडल एपीआई स्ट्रीमिंग से अलग है।

$
curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/integrations/telegram/behavior \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "behavior": {
>
      "reaction_level": "minimal",
>
      "typing": true,
>
      "read_receipts": false,
>
      "streaming": false
>
    }
>
  }'

बॉट को कौन संदेश भेज सकता है

mode open (कोई भी) या restricted है (केवल वे मैसेजिंग आईडी जिनकी आप अनुमति देते हैं). restricted और बिना आईडी के होने पर, संदेश भेजने वाला पहला व्यक्ति मालिक बन जाता है। एक कनेक्टेड चैनल के लिए नियम सेट करने के लिए kind शामिल करें।

$
curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/access \
>
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>
  -H "Content-Type: application/json" \
>
  -d '{ "kind": "telegram", "mode": "restricted", "allow": { "telegram": ["123456789"] } }'

मूल्य निर्धारण

होस्टेड एजेंटों को आपके द्वारा चुनी गई योजना के आधार पर प्रति एजेंट मासिक बिल दिया जाता है। बेसिक 15 USD प्रति माह है और प्रो 30 USD प्रति माह है। योजना एजेंट रनटाइम को कवर करती है। एजेंट द्वारा उपयोग किए जाने वाले मॉडल मानक मॉडल दरों पर अलग से बिल किए जाते हैं।

सीमाएं

प्रत्येक खाता एक बार में सीमित संख्या में तैनात एजेंटों को चला सकता है। आपकी डैशबोर्ड सेटिंग्स आपकी प्रभावी सीमा दिखाती हैं। [us](mailto:support@empiriolabs.ai से संपर्क करें) अपनी सीमा बढ़ाने के लिए।

सफेद लेबलिंग

आप अपने स्वयं के उत्पाद में होस्ट किए गए एजेंटों का निर्माण कर सकते हैं और उन्हें पूरी तरह से अपने ब्रांड के तहत चला सकते हैं। एपीआई अनब्रांडेड है: आप /v1/hosted-agents/* को अपनी EmpirioLabs API कुंजी से कॉल करते हैं और एजेंट को अपनी इच्छानुसार सतह पर लाते हैं, इसलिए आपके अंतिम उपयोगकर्ता आपके उत्पाद के साथ इंटरैक्ट करते हैं, हमारे साथ नहीं। एपीआई प्रतिक्रियाओं में या एजेंट के उत्तरों में कोई एम्पिरियोलैब्स ब्रांडिंग नहीं है। उच्च एजेंट सीमा, समर्पित क्षमता, या कस्टम वाणिज्यिक व्यवस्था के लिए, ईमेल support@empiriolabs.ai।

अगले चरण