इस प्रोजेक्ट के बारे में

Vocion (@vocion/core) केवल प्रोटोटाइपिंग के बजाय प्रोडक्शन में AI एजेंट वर्क चलाने के लिए एक ओपन फ्रेमवर्क है। इसका README इसे उन इंजीनियरों या टेक लीड्स के लिए लक्षित करता है जो एजेंटों की एक टीम को प्रोडक्शन में ले जा रहे हैं, और स्पष्ट रूप से बताता है कि यह प्रोजेक्ट कब उपयुक्त नहीं है: जैसे कि एक सिंगल चैटबॉट, वन-ऑफ स्क्रिप्ट, या होस्टेड नो-कोड बिल्डर। यह मानता है कि आप Postgres चलाते हैं, कॉन्फ़िगरेशन को git में रखते हैं, और महत्वपूर्ण कार्यों पर मानवीय हस्तक्षेप (human in the loop) चाहते हैं। कोर पैकेज npm पर प्रकाशित नहीं है; आप रिपॉजिटरी को क्लोन करते हैं और इसे स्वयं चलाते हैं। प्लेटफॉर्म किन चीजों को जोड़ता है Vocion को Next.js ऐप, Postgres स्कीमा, MCP सर्वर और वर्कफ़्लो रनर के संयोजन के रूप में वर्णित किया गया है। आप Sources, Objects, Skills, Playbooks, Workflows, Missions, Automations, Agents और Teams को git में YAML और markdown के रूप में लिखते हैं, उन्हें डेटाबेस पर लागू करते हैं, और एक टाइप्ड रनटाइम प्राप्त करते हैं जिसमें एकीकृत ह्यूमन-रिव्यू क्यू, ऑब्जर्वेबिलिटी और एक प्लगइन इकोसिस्टम होता है। तीन वर्क मोड एक ही रनटाइम साझा करते हैं: - Workflows: अप्रूव और आस्क गेट्स के साथ नियतात्मक (deterministic) चरण। - Missions: खुले छोर वाली स्थायी जिम्मेदारियां, जहां एजेंटों की एक टीम समीक्षा के तहत योजना बनाती है, काम करती है और आर्टिफैक्ट्स तैयार करती है। - Teams: एक लीड और एक जवाबदेह इंसान के तहत समूहबद्ध कई एजेंट। अन्य क्षमताओं में Google Ads, GA4, HubSpot, Gmail, Slack और Google Drive के लिए एक बिल्ट-इन कनेक्टर पैक शामिल है; एक मल्टी-टेनेंट कंट्रोल प्लेन जिसमें टेनेंट Bearer टोकन होते हैं; एक राइट API जो REST के माध्यम से रिव्यू क्यू को एक्सपोज़ करता है; और एजेंट और टूल प्लेन के रूप में HTTP पर MCP। डिस्कवरी और म्यूटेशन अनुमतियां अलग-अलग हैं, अप्रूवल गेट्स वाला एक ऑटोनॉमी लैडर निष्पादन को नियंत्रित करता है, और क्रॉस-क्लाइंट आइसोलेशन को प्रॉम्प्ट के बजाय क्वेरी स्तर पर लागू किया जाता है। एजेंट निष्पादन को एक सिंगल सेटिंग, harness.runsOn के माध्यम से कॉन्फ़िगर किया जा सकता है। दस्तावेज़ों में ऐप प्रोसेस के अंदर, AWS Bedrock AgentCore Runtime पर प्रोजेक्ट के अपने कंटेनर में, या AWS के मैनेज्ड हार्नेस को सौंपने के विकल्प दिए गए हैं। लेयर्ड पैकेज और प्लगइन कॉन्ट्रैक्ट रिपॉजिटरी एक बड़े प्लेटफॉर्म की कोर लेयर है। SDK पैकेज स्थिर प्लगइन कॉन्ट्रैक्ट को परिभाषित करता है, जिसमें Skill और PluginManifest प्रकार और LLM क्लाइंट प्रकार शामिल हैं। कनेक्टर्स और स्किल्स अलग प्लगइन npm पैकेज के रूप में आते हैं। एक प्लगइन एक npm पैकेज है जो एक मैनिफेस्ट एक्सपोर्ट करता है; कोर बूट के समय SDK के माध्यम से मैनिफेस्ट लोड करता है। README एक नमूना स्किल परिभाषा दिखाता है जिसमें स्लग, नाम, वर्जन, प्रोवाइडर, अप्रूवल आवश्यकता, इनपुट-आउटपुट स्कीमा और एक रन फंक्शन घोषित होता है। कोड के रूप में वर्कस्पेस (Workspace as code) सभी टेनेंट कॉन्टेक्स्ट एक वर्कस्पेस में रहते हैं: YAML और markdown की एक git-ट्रैक्ड डायरेक्टरी जो रिपॉजिटरी चेकआउट के बाहर होती है, ताकि क्लाइंट कॉन्टेक्स्ट को पुल रिक्वेस्ट में रिव्यू किया जा सके और वह कोर के साथ मिक्स न हो। एक एनवायरनमेंट वेरिएबल ऐप को इसकी ओर निर्देशित करता है। दस्तावेज़ों में वर्कस्पेस मैनिफेस्ट, एजेंट, टीम, स्किल्स, प्लेबुक्स, मिशन, वर्कफ़्लो, ऑटोमेशन, ऑब्जेक्ट टाइप्स, सोर्सेज, ट्रस्ट रूल्स, लर्निंग स्टेप्स, इवल डेटासेट्स और टेनेंट-परिभाषित डैशबोर्ड पेज जैसे एंटिटी प्रकार शामिल हैं। कोर के अंदर एक बेस पैक आता है जो वर्कस्पेस के नीचे लेयर होता है: आप इसे extends डायरेक्टिव के साथ पिन करते हैं, use लिस्ट के साथ एजेंटों को सक्रिय करते हैं, और समान-स्लग फाइलों के साथ डिफॉल्ट्स को ओवरराइड करते हैं। सेटअप और ऑपरेशन्स शुरुआत करने के लिए क्लोन और इंस्टॉल, एनवायरनमेंट उदाहरण फ़ाइल को कॉपी करना और डेटाबेस URL, ऑथ सीक्रेट और कम से कम एक LLM प्रोवाइडर की सेट करना आवश्यक है। इसके बाद dev:up स्क्रिप्ट के साथ सपोर्टिंग सर्विसेज (Postgres, Langfuse, Temporal) शुरू करें, माइग्रेशन चलाएं, वर्कस्पेस स्कैफोल्ड करें, WORKSPACE_PATH सेट करें, इसे लागू करें, और फिर localhost पोर्ट 3000 पर देव सर्वर शुरू करें। Claude Code, Cursor या Zed जैसे MCP क्लाइंट्स के लिए, सिंगल डेवलपर इंस्टॉल के लिए एक लोकल stdio कमांड है, साथ ही एक रिमोट HTTP एंडपॉइंट भी है जहां ऑर्गनाइजेशन को टेनेंट Bearer टोकन से प्राप्त किया जाता है। क्रेडेंशियल्स को डैशबोर्ड पेज से मैनेज किया जाता है। इनबाउंड टोकन Vocion द्वारा मिंट किए जाते हैं और SHA-256 हैश के रूप में स्टोर किए जाते हैं। आउटबाउंड वेंडर कीज़ प्रति वर्कस्पेस प्रदान की जा सकती हैं, जिन्हें AES-256-GCM के तहत एन्क्रिप्ट किया जाता है। एन्क्रिप्शन कॉन्फ़िगरेशन डेवलपमेंट के लिए लोकल वॉल्ट मोड और वास्तविक कस्टमर कीज़ के लिए KMS मोड प्रदान करता है। रिट्रीवल फर्स्ट-पार्टी है: HNSW कोसाइन के साथ pgvector और Postgres फुल-टेक्स्ट सर्च, जिन्हें रेसिप्रोकल रैंक फ्यूजन के साथ जोड़ा गया है, और एक वैकल्पिक LLM रीरैंक है। स्टैक और इंटीग्रेशन घोषित स्टैक में Next.js 16 (App Router), React 19 और स्ट्रिक्ट TypeScript, ORM के साथ PostgreSQL 16, Auth.js / NextAuth v5, OpenAI और Anthropic (LLM प्रोवाइडर्स के रूप में), Langfuse (LLM ट्रेसेस के लिए) और OpenTelemetry शामिल हैं। इसमें Postgres पर एक इन-प्रोसेस ड्यूरेबल वर्कफ़्लो स्टेप रनर और Slack चैट सरफेस शामिल हैं। लाइसेंस प्रोजेक्ट Mozilla Public License 2.0 के तहत सोर्स-अवेलेबल है। आप इसका उपयोग, सेल्फ-होस्ट, निरीक्षण, संशोधन कर सकते हैं और इसे एक बड़े प्रोप्रायटरी सिस्टम में एम्बेड कर सकते हैं। संशोधित Vocion फाइलें वितरण के समय MPL के तहत खुली रहेंगी, जबकि आसपास का एप्लिकेशन कोड आपका रहेगा। डेटा, बिजनेस कॉन्टेक्स्ट, एजेंट कॉन्फ़िगरेशन और ऑपरेशनल आउटपुट आपके ही रहेंगे। Vocion की व्हाइट-लेबलिंग या प्रोप्रायटरी लाइसेंस के तहत वितरण के लिए एक अलग समझौते की आवश्यकता होती है। नाम और लोगो Metacto, Inc. के ट्रेडमार्क हैं। दस्तावेज़ीकरण संकेत README में गेटिंग-स्टार्टेड गाइड, कोडिंग एजेंटों के लिए एक फ़ाइल, मशीन-रीडेबल डॉक्यूमेंटेशन इंडेक्स, वर्कस्पेस ऑथरिंग गाइड, एंटिटी फील्ड रेफरेंस, ऑब्जेक्ट मॉडल पेज, डैशबोर्ड पेज गाइड और डिप्लॉयमेंट डॉक्यूमेंटेशन के लिंक दिए गए हैं। योगदान मार्गदर्शन में टूलिंग द्वारा लागू कन्वेंशन कमिट्स, DCO साइन-ऑफ और कमिट करने से पहले टाइप चेक, टेस्ट और लिंट चलाना शामिल है।