প্রকল্প সম্পর্কে

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: ডিটারমিনিস্টিক স্টেপস যাতে অ্যাপ্রুভ এবং আস্ক গেট থাকে। - Missions: ওপেন-এন্ডেড স্থায়ী দায়িত্ব, যেখানে এজেন্টদের একটি টিম পরিকল্পনা করে, কাজ করে এবং রিভিউয়ের অধীনে আর্টিফ্যাক্ট তৈরি করে। - Teams: একজন লিড এবং একজন দায়বদ্ধ মানুষের অধীনে গ্রুপ করা একাধিক এজেন্ট। অন্যান্য সক্ষমতার মধ্যে রয়েছে Google Ads, GA4, HubSpot, Gmail, Slack এবং Google Drive-এর জন্য একটি বিল্ট-ইন কানেক্টর প্যাক; টেন্যান্ট Bearer টোকেন সহ একটি মাল্টি-টেন্যান্ট কন্ট্রোল প্লেন; REST-এর মাধ্যমে রিভিউ কিউ এক্সপোজ করার একটি রাইট API; এবং এজেন্ট ও টুল প্লেন হিসেবে HTTP-র মাধ্যমে MCP। ডিসকভারি এবং মিউটেশন পারমিশন আলাদা করা হয়েছে, একটি অটোনমি ল্যাডার এবং অ্যাপ্রুভাল গেট এক্সিকিউশন নিয়ন্ত্রণ করে এবং কুয়েরি লেভেলে ক্রস-ক্লায়েন্ট আইসোলেশন নিশ্চিত করা হয়। এজেন্ট এক্সিকিউশন একটি একক সেটিংস, harness.runsOn-এর মাধ্যমে কনফিগার করা যায়। ডকুমেন্ট করা অপশনগুলোর মধ্যে রয়েছে অ্যাপ প্রসেসের ভেতরে এজেন্ট লুপ চালানো, AWS Bedrock AgentCore Runtime-এ প্রজেক্টের নিজস্ব কন্টেইনারে চালানো, অথবা AWS-এর ম্যানেজড হার্নেস-এ হস্তান্তর করা। লেয়ারড প্যাকেজ এবং প্লাগইন কন্ট্রাক্ট রিপোজিটরিটি একটি বৃহত্তর প্ল্যাটফর্মের কোর লেয়ার। SDK প্যাকেজটি একটি স্থিতিশীল প্লাগইন কন্ট্রাক্ট সংজ্ঞায়িত করে, যার মধ্যে Skill এবং PluginManifest টাইপ এবং LLM ক্লায়েন্ট টাইপ অন্তর্ভুক্ত। কানেক্টর এবং স্কিলগুলো আলাদা প্লাগইন npm প্যাকেজ হিসেবে আসে। একটি প্লাগইন হলো একটি npm প্যাকেজ যা একটি ম্যানিফেস্ট এক্সপোর্ট করে; কোর বুট করার সময় SDK-র মাধ্যমে ম্যানিফেস্টগুলো লোড করে। README-তে একটি স্যাম্পল স্কিল ডেফিনিশন দেখানো হয়েছে যা একটি স্কিমা ভ্যালিডেশন লাইব্রেরি দিয়ে তৈরি, যেখানে slug, name, version, provider, অ্যাপ্রুভাল রিকোয়ারমেন্ট, ইনপুট এবং আউটপুট স্কিমা এবং একটি run ফাংশন ঘোষণা করা হয়েছে। কোড হিসেবে ওয়ার্কস্পেস (Workspace as code) সমস্ত টেন্যান্ট কনটেক্সট একটি ওয়ার্কস্পেসে থাকে: এটি YAML এবং markdown-এর একটি git-ট্র্যাকড ডিরেক্টরি যা রিপোজিটরি চেকআউটের বাইরে থাকে (সাধারণত নিজস্ব রিপো), যাতে ক্লায়েন্ট কনটেক্সট পুল রিকোয়েস্টে রিভিউ করা যায় এবং কোরের সাথে মিশে না যায়। একটি এনভায়রনমেন্ট ভেরিয়েবল অ্যাপটিকে এর দিকে নির্দেশ করে। ডকুমেন্ট করা এনটিটি টাইপগুলোর মধ্যে রয়েছে ওয়ার্কস্পেস ম্যানিফেস্ট, এজেন্ট, টিম, স্কিল, প্লেবুক, মিশন, API দ্বারা তৈরি ওয়ার্কফ্লো রান, অটোমেশন, অবজেক্ট টাইপ, সোর্স, ট্রাস্ট রুলস, লার্নিং স্টেপস, ইভাল ডেটাসেট এবং টেন্যান্ট-ডিফাইনড ড্যাশবোর্ড পেজ। কোর-এর ভেতরে একটি বেস প্যাক থাকে যা ওয়ার্কস্পেসের নিচে লেয়ার হিসেবে কাজ করে। ডাটাবেসে একটি ওয়ার্কস্পেস প্রয়োগ করলে একটি অডিট রো রেকর্ড হয় এবং টুল কলগুলো একটি ওয়ার্কস্পেস হ্যাশ স্ট্যাম্প করে যাতে আউটপুটগুলো কোন প্রম্পট থেকে এসেছে তা ট্রেস করা যায়। সেটআপ এবং অপারেশনস শুরু করার প্রক্রিয়াটি ক্লোন এবং ইনস্টল, এনভায়রনমেন্ট এক্সাম্পল ফাইল কপি করে ডাটাবেস URL, অথ সিক্রেট এবং অন্তত একটি LLM প্রোভাইডার কি সেট করা, dev:up স্ক্রিপ্টের মাধ্যমে সাপোর্টিং সার্ভিস (Postgres, Langfuse, Temporal) চালু করা, মাইগ্রেশন চালানো, একটি ওয়ার্কস্পেস স্ক্যাফোল্ড করা, WORKSPACE_PATH সেট করা এবং লোকালহোস্ট পোর্ট ৩০০০-এ ডেভ সার্ভার চালু করা হিসেবে ডকুমেন্ট করা হয়েছে। Claude Code, Cursor বা Zed-এর মতো MCP ক্লায়েন্টদের জন্য একটি লোকাল stdio কমান্ড এবং একটি রিমোট HTTP এন্ডপয়েন্ট রয়েছে। ক্রেডেনশিয়ালগুলো ড্যাশবোর্ড পেজ থেকে ম্যানেজ করা হয়। ইনবাউন্ড টোকেনগুলো Vocion দ্বারা তৈরি এবং SHA-256 হ্যাশ হিসেবে সংরক্ষিত হয়। আউটবাউন্ড ভেন্ডর কি-গুলো প্রতি ওয়ার্কস্পেস অনুযায়ী সরবরাহ করা যায় এবং AES-256-GCM দিয়ে এনক্রিপ্ট করা হয়। এনক্রিপশন কনফিগারেশনে ডেভেলপমেন্টের জন্য লোকাল ভল্ট মোড এবং রিয়েল কাস্টমার কি-র জন্য KMS মোড রয়েছে। রিট্রিভাল (Retrieval) ফার্স্ট-পার্টি: pgvector (HNSW cosine) এবং Postgres ফুল-টেক্সট সার্চ, যা রেসিপ্রোকাল র‍্যাঙ্ক ফিউশন (RRF) এবং ঐচ্ছিক LLM রি-র‍্যাঙ্ক দিয়ে সমন্বিত। স্ট্যাক এবং ইন্টিগ্রেশন ব্যবহৃত স্ট্যাক হলো Next.js 16 (App Router), React 19 এবং স্ট্রিক্ট TypeScript, PostgreSQL 16, Auth.js / NextAuth v5, OpenAI এবং Anthropic (LLM প্রোভাইডার হিসেবে), Langfuse (LLM ট্রেস), এবং OpenTelemetry। এতে Postgres-এর উপর একটি ইন-প্রসেস ডিউরেবল ওয়ার্কফ্লো স্টেপ রানার এবং Slack চ্যাট সারফেস রয়েছে। লাইসেন্স প্রজেক্টটি Mozilla Public License 2.0-এর অধীনে সোর্স-অ্যাভেইলেবল। আপনি এটি ব্যবহার, সেলফ-হোস্ট, পরিদর্শন, পরিবর্তন এবং একটি বৃহত্তর প্রোপরাইটারি সিস্টেমে এমবেড করতে পারেন। তবে Vocion-কে হোয়াইট-লেবেলিং করা বা প্রোপরাইটারি লাইসেন্সের অধীনে বিতরণ করার জন্য আলাদা চুক্তির প্রয়োজন। নাম এবং লোগো Metacto, Inc.-এর ট্রেডমার্ক। ডকুমেন্টেশন পয়ন্টারস README-তে একটি গেটিং-স্টার্টেড গাইড, কোডিং এজেন্টদের জন্য একটি ফাইল, একটি মেশিন-রিডেবল ডকুমেন্টেশন ইনডেক্স, ওয়ার্কস্পেস অথরিং গাইড, এনটিটি ফিল্ড রেফারেন্স, অবজেক্ট মডেল পেজ, ড্যাশবোর্ড পেজ গাইড এবং ডেপ্লয়মেন্ট ডকুমেন্টেশনের লিঙ্ক দেওয়া হয়েছে।