Nvidia – هستی شناسی خودکار منبع باز

نمایندگان می‌توانند اسناد و پایگاه‌های اطلاعاتی را جستجو کنند، اما قابلیت اطمینان به تجزیه و تحلیل عاملی می‌پردازد: معیار درآمدی که سریع‌تر پاسخ داده شود، اگر عدد اشتباه باشد، ارزشی ندارد. عامل ها به یک لایه زمینه نیاز دارند که به آنها بگوید داده ها در کجا زندگی می کنند، به چه معنا هستند، آیا از آن استفاده کنند، چگونه از آن استفاده کنند، از کجا آمده اند، و چه چیزی مشابه است. NVIDIA Auto Ontology یک کتابخانه باز است که آن لایه را از ابرداده های سازمانی می سازد، تعاریف را در بین سیستم ها تطبیق می دهد و آن را در معرض هر مهار عاملی از طریق MCP، CLI و API قرار می دهد. این مدل‌های معنایی را که مشتریان قبلا دارند تکمیل می‌کند.

برای اجرای یک معیار تبدیل متن به SQL مانند BIRD، به مخزن ارزیابی SQL هستی شناسی مراجعه کنید.

صدور مجوز و مشارکت هستی شناسی خودکار تحت مجوز آپاچی 2.0 توزیع شده است. مؤلفه‌های منبع باز شخص ثالث که توسط این پروژه بسته‌بندی شده، پیوند داده شده یا به‌طور دیگری استفاده می‌شود، در THIRD_PARTY_NOTICES.md فهرست شده‌اند. این پروژه در حال حاضر مشارکت خارجی را نمی پذیرد.

هستی‌شناسی خودکار از نقاط پایانی NIM NVIDIA برای استنتاج استفاده می‌کند - یا کاتالوگ NVIDIA API میزبانی‌شده (integrate.api.nvidia.com) یا NIM‌های خود میزبان. پیش فرض ها در env.example عبارتند از:

نقاط پایانی و مدل‌ها از طریق متغیرهای محیطی DEFAULT_MODELS_ENDPOINT، DEFAULT_MODELS_MODEL، EMBED_ENDPOINT و EMBED_MODEL پیکربندی می‌شوند و به DEFAULT_MODELS_API_KEY نیاز دارند.

هر نقش مدل توسط یک سه گانه از متغیرهای محیطی پیکربندی می شود - <PREFIX>_ENDPOINT (URL)، <PREFIX>_API_KEY و <PREFIX>_MODEL:

می‌توانید یک سه‌گانه کامل، فقط برخی از فیلدهای آن، یا اصلا هیچ‌کدام را تنظیم کنید - هر فیلدی که تنظیم نشده باقی بماند به DEFAULT_MODELS_<FIELD> منطبق برمی‌گردد. بنابراین ساده‌ترین راه‌اندازی این است که DEFAULT_MODELS_* را پر کنید و فیلدهای هر سه‌گانه را فقط در جایی که تفاوت دارند لغو کنید (مانند EMBED_MODEL، NON_REASONING_MODEL). *_API_KEY همچنین برای سازگاری با نسخه قبلی به NVIDIA_API_KEY قدیمی باز می گردد.

برای استقرار هستی شناسی خودکار در یک خوشه Kubernetes، به DEPLOYMENT.md مراجعه کنید.

فایل محیطی (.env) خود را از الگو ایجاد کنید و مقادیر (Credentials Postgres، DEFAULT_MODELS_API_KEY، CONNECTION_STRINGS، و غیره) را پر کنید. برای لیست کامل متغیرها به .env.example مراجعه کنید:

این تصاویر پس‌زمینه (auto_ontology) و frontend (auto-ontology-frontend) را می‌سازد، Postgres و pgAdmin را نمایش می‌دهد، کار یک‌شات frontend-migrate را برای همگام‌سازی طرح پایگاه داده اجرا می‌کند، و برنامه را شروع می‌کند (Backend، سرویس جذب، و frontend).

UI را در http://localhost:3000 باز کنید (API backend در :3001، pgAdmin در: 5050 است).

هستی شناسی خودکار پایگاه های داده منبعی را که به آنها متصل می شود از دو منبع حل می کند:

از طریق UI اضافه شد - اتصالات ایجاد شده از داخل برنامه. با استفاده از این گزینه، اعتبار اتصال به صورت متن ساده در Postgres ذخیره می شود، مگر اینکه Vault پیکربندی شده باشد:

Vault فقط زمانی فعال می شود که همه VAULT_ADDR، VAULT_NAMESPACE، VAULT_ROLE_ID، و VAULT_SECRET_ID تنظیم شده باشند (VAULT_AUTH_MOUNT و VAULT_KV_MOUNT لغو اختیاری هستند). به طور پیش فرض خاموش است. یک پیکربندی جزئی با یک هشدار نادیده گرفته می شود و به ذخیره سازی متن ساده باز می گردد.

متغیر محیطی CONNECTION_STRINGS - فهرستی از رشته های اتصال جدا شده با کاما که در زمان استقرار ارائه می شود (به عنوان مثال پرچم Helm --set connectionStrings=<CONNECTION-STRINGS>). این یک بازگشت است: فقط زمانی استفاده می شود که هیچ اتصالی با رابط کاربری اضافه نشده باشد.

هستی شناسی خودکار از SSO برای احراز هویت پشتیبانی می کند. Redirect URI باید در IdP به صورت APP_URL/api/auth/sso/callback پیکربندی شود

آن را به عنوان x-api-key در هر تماس /api/... ارسال کنید — مجوز: حامل <token> نیز کار می کند:

کلاینت‌های عمومی با گیت‌وی تأیید شده Next.js در POST /api/chat/completions تماس می‌گیرند. پاسخ یک جریان SSE است که شامل مرحله، نتیجه یا رویدادهای خطا و به دنبال آن [انجام شد] است.

برای درخواست‌های مکالمه، FastAPI حداکثر پنج نوبت تکمیل شده اخیر را بارگیری می‌کند (محدود به 12000 کاراکتر) و ورودی‌های متنی مانند «در مورد آگوست چطور؟» را بازنویسی می‌کند. قبل از اجرای گراف text-to-SQL موجود، به یک سوال مستقل بپردازید. سوالات مستقل بدون تغییر ارسال می شوند. افکار عامل داخلی، بارهای نمودار، خطاها و مجموعه نتایج خام SQL به عنوان زمینه استفاده مجدد نمی شوند.

تاریخچه مکالمه به کاربر تأیید شده Auto Ontology اختصاص دارد. تماس‌گیرندگان مرورگر و خدمات باید از دروازه Next.js استفاده کنند که کاربر را حل می‌کند و هدر x-auto-ontology-user-id داخلی را به FastAPI ارسال می‌کند. پورت FastAPI یک مرز سرویس داخلی قابل اعتماد است: نباید در معرض عموم قرار گیرد زیرا آن هدر به طور مستقل توسط FastAPI تأیید نشده است. درخواست مستقیم FastAPI بدون talk_id بدون حالت باقی می ماند. یک درخواست مستقیم با talk_id به هدر هویت مورد اعتماد نیاز دارد.

وب UI UUID را به طور خودکار مدیریت می کند. مکالمه ایجاد شده توسط API را می توان در UI در /chat?focus=<conversation_id> باز کرد که متعلق به کاربر وارد شده به سیستم باشد.

عوامل کدگذاری: از AGENTS.md شروع کنید. مهارت‌ها در مهارت‌ها زندگی می‌کنند (nvidia-ontology-setup, nvidia-ontology-management, nvidia-ontology-query). نگهدارنده ها به استفاده از CLAUDE.md ادامه می دهند.

مهارهای عاملی مانند مکان نما و کلود دسکتاپ می توانند از طریق سرور MCP موجودی خودکار اطلاعات شما را پرس و جو کنند. برای اجرای آن به mcp/ و برای جزئیات به docs/mcp.md مراجعه کنید.

Auto Ontology تحت مجوز آپاچی، نسخه 2.0 مجوز دارد. شناسه SPDX: Apache-2.0.

هر فایل منبع نویسندگان NVIDIA در این مخزن دارای یک هدر SPDX به شکل زیر است:

مؤلفه‌های منبع باز شخص ثالث که توسط Auto Ontology استفاده می‌شوند، با مجوزهای بالادستی و آدرس‌های اینترنتی پروژه، در THIRD_PARTY_NOTICES.md برشمرده شده‌اند. اجزای اضافه شده توسط تصاویر ظرف به طور جداگانه در CONTAINER_THIRD_PARTY_NOTICES.md فهرست شده است.

اخطار و سلب مسئولیت: این نرم افزار به طور خودکار مواد خارجی را بازیابی می کند، به آنها دسترسی پیدا می کند یا با آنها تعامل دارد. این مطالب بازیابی شده با این نرم افزار توزیع نمی شوند و صرفا توسط شرایط، شرایط و مجوزهای جداگانه کنترل می شوند. شما تنها مسئول یافتن، بررسی و پیروی از کلیه شرایط، شرایط و مجوزهای قابل اجرا، و تأیید امنیت، یکپارچگی و مناسب بودن هر گونه مواد بازیابی شده برای مورد استفاده خاص خود هستید. این نرم افزار همانطور که هست و بدون هیچ گونه گارانتی ارائه شده است.

نویسنده هیچ گونه نمایندگی یا ضمانتی در رابطه با مطالب بازیابی شده نمی دهد و هیچ مسئولیتی در قبال هرگونه ضرر، خسارت، تعهدات یا عواقب قانونی ناشی از استفاده یا ناتوانی شما در استفاده از این نرم افزار یا هر گونه مطالب بازیابی شده ندارد. از این نرم افزار و مواد بازیابی شده با مسئولیت خود استفاده کنید.

مواد خارجی در زمان اجرا با آنتولوژی خودکار تعامل دارد:

این پروژه در حال حاضر مشارکتی را نمی پذیرد. مشکلات، درخواست‌های کشش و وصله‌های ارسالی از خارج از تیم نگهدارنده خودکار هستی‌شناسی بررسی یا ادغام نمی‌شوند. گزارش‌های مرتبط با امنیت باید از روندی که در SECURITY.md توضیح داده شده است پیروی کنند. گردش کار Maintainer در CONTRIBUTING.md است.