آموزش گام‌به‌گاممدیریت اسناد و بایگانی
پایگاه دانش آماده هوش مصنوعی: ۱۰ قاعده نوشتن مقاله‌ای که چت‌بات و دستیار درست بخوانند
دستیارها و چت‌بات‌های مبتنی بر بازیابی، اسناد را به قطعههای کوچک تقسیم می‌کنند و هر قطعه ممکن است جدا خوانده شود. برای همین، کیفیت پاسخ به نحوه نوشتن محتوا وابسته است. ده قاعده: یک موضوع در هر مقاله، عنوان پرسشی یا دقیق، تاریخ اعتبار و نسخه، مالک مشخص، جمله‌های خودبسنده، جدول متنی به‌جای تصویر، اصطلاحات یک‌دست، عدد و شرط صریح، بخش پرسش و پاسخ و سطح دسترسی مشخص. بازنویسی را از مقاله‌های پاسخ‌دهنده به پرسشهای پرتکرار شروع کنید.
خلاصه در چند نکته
- ۷۸٪ سازمان‌های دارای ایجنت عملیاتی در گزارش Contentstack با مشکل آمادگی محتوا روبه‌رو شدند.
- دستیار اسناد را قطعه‌قطعه می‌خواند؛ هر بند باید خودبسنده باشد.
- نسخه منسوخ مهم‌ترین علت پاسخ نادرست است؛ فقط یک نسخه معتبر نگه دارید.
- هر مقاله یک موضوع، یک مالک و تاریخ بازبینی داشته باشد.
- جدول را متنی بسازید، نه تصویر.
- سطح دسترسی را در فراداده مقاله ثبت کنید.
- بازنویسی را از پرسشهای پرتکرار شروع کنید.
فهرست مطالب
سازمان‌هایی که دستیار یا چت‌بات هوش مصنوعی را روی پایگاه دانش خود راه‌اندازی می‌کنند، اغلب در هفته‌های اول با پدیده‌ای عجیب روبه‌رو می‌شوند: پاسخ‌هایی که نیمه‌درست‌اند، از نسخه قدیمی یک دستورالعمل آمده‌اند یا دو بخش نامرتبط از یک سند را به هم چسبانده‌اند. واکنش اول معمولاً این است که «مدل ضعیف است». اما در بیشتر موارد، مشکل در نحوه نوشتن محتواست، نه در مدل.
در گزارش «سازمان عامل‌محور ۲۰۲۶» شرکت Contentstack، ۷۸ درصد سازمان‌هایی که ایجنت‌ها را به بهره‌برداری رسانده بودند گفتند با مشکلات آمادگی محتوا و داده روبه‌رو شده‌اند که به بازکاری جدی یا کندی استقرار انجامیده است؛ و رایج‌ترین مشکلات محتوایی، نبود برچسب و بافت کافی برای داده و قالب‌بندی ناهماهنگ محتوا بود.
این راهنما ده قاعده عملی برای نوشتن مقاله‌های پایگاه دانش ارائه میکند که هم انسان و هم ماشین درست بخوانند. تمرکز ما بر خوانایی برای ماشین است. اگر به دنبال مفهوم ویکی سازمانی، ساختار کلی و فرهنگ مستندسازی هستید، مقاله ویکی سازمانی و پایگاه دانش چیست را بخوانید.
ماشین چگونه پایگاه دانش را می‌خواند؟
برای فهم این قواعد، باید بدانید دستیارهای مبتنی بر بازیابی (RAG) چگونه کار می‌کنند. سامانه اسناد را به قطعههای کوچک‌تر تقسیم میکند، برای هر قطعه یک نمایه معنایی می‌سازد و وقتی کاربر پرسشی می‌پرسد، چند قطعه مرتبط را پیدا میکند و به مدل میدهد تا پاسخ را بر پایه آن‌ها بسازد.
این فرایند سه پیامد مهم دارد:
- هر قطعه ممکن است جدا از بقیه سند خوانده شود. اگر یک بند به «موارد بالا» اشاره کند و آن موارد در قطعه دیگری باشند، معنا گم میشود.
- سامانه به عنوان‌ها و ساختار تکیه میکند. عنوان روشن کمک میکند قطعه درست پیدا شود.
- سامانه نمیداند کدام نسخه معتبر است، مگر اینکه به او گفته شود.
با این سه نکته، قواعد زیر معنای روشن‌تری پیدا می‌کنند.
ده قاعده نوشتن برای پایگاه دانش آماده هوش مصنوعی
قاعده ۱: هر مقاله، یک موضوع
مقاله‌ای با عنوان «قوانین منابع انسانی» که از مرخصی تا وام و ارزیابی عملکرد را در بر می‌گیرد، برای انسان شاید قابل تحمل باشد، اما برای ماشین مشکل‌ساز است. قطعههای مربوط به موضوعات مختلف با هم قاطی می‌شوند و پاسخ ممکن است ترکیبی نادرست باشد.
به‌جای: «آیین‌نامه جامع امور کارکنان» بنویسید: «مرخصی استحقاقی: سقف، نحوه ثبت و انتقال به سال بعد»، «وام ضروری: شرایط، سقف و مدارک»
قاعده ۲: عنوان پرسشی یا توصیفی دقیق
عنوان‌ها را به شکل پرسشی که کاربر واقعاً می‌پرسد یا توصیف دقیق محتوا بنویسید. این کار هم جستجوی معنایی و هم جستجوی کلیدواژه‌ای را بهتر میکند.
به‌جای: «نکات مهم» بنویسید: «چگونه رمز عبور ایمیل سازمانی را تغییر دهم؟»
قاعده ۳: تاریخ اعتبار و نسخه را بالای مقاله بنویسید
هر مقاله باید تاریخ آخرین بازبینی، تاریخ اعتبار (در صورت وجود) و شماره نسخه داشته باشد. وقتی نسخه جدید منتشر میشود، نسخه قدیمی باید بایگانی شود و از دسترس دستیار خارج شود. این مهم‌ترین قاعده برای جلوگیری از پاسخ‌های منسوخ است.
قاعده ۴: مالک مشخص
بالای هر مقاله نام واحد یا نقش مسئول را بنویسید: «مالک: واحد منابع انسانی». مالک کسی است که با تغییر رویه، مقاله را به‌روز میکند و اگر دستیار پاسخ نادرستی داد، اصلاح را انجام میدهد.
قاعده ۵: جمله‌های خودبسنده
هر بند را طوری بنویسید که اگر جدا خوانده شود، معنا داشته باشد. از ارجاع‌های مبهم مثل «طبق موارد فوق»، «همان‌طور که گفته شد» یا «این مورد» پرهیز کنید.
به‌جای: «این مورد برای آن‌ها هم صدق میکند.» بنویسید: «سقف سه روز مرخصی ازدواج برای کارکنان قراردادی هم اعمال میشود.»
قاعده ۶: جدول واقعی، نه تصویر جدول
جدول‌هایی که به‌صورت تصویر یا اسکن در سند قرار گرفته‌اند، برای ماشین یا خوانده نمی‌شوند یا با خطا خوانده می‌شوند. جدول را به‌صورت جدول متنی واقعی در ویرایشگر بسازید. اگر جدول بسیار پیچیده است، اطلاعات کلیدی آن را در چند جمله هم بنویسید.
قاعده ۷: اصطلاحات را یک‌دست و تعریف‌شده به کار ببرید
اگر در یک سند «مرخصی استحقاقی»، در سند دیگر «مرخصی سالانه» و در سومی «مرخصی عادی» آمده، ماشین ممکن است نفهمد این‌ها یکی‌اند. یک واژه را برگزینید و در یک واژه‌نامه، معادل‌ها را ثبت کنید. نام واحدها، کدها و سامانه‌های داخلی را هم همیشه یکسان بنویسید.
قاعده ۸: عددها، سقف‌ها و شرط‌ها را صریح بنویسید
«مبلغ مناسب» یا «در صورت لزوم» برای ماشین قابل استفاده نیست. عدد، واحد، شرط و استثنا را صریح بنویسید.
به‌جای: «وام در موارد خاص با سقف معقول پرداخت میشود.» بنویسید: «وام ضروری حداکثر تا سقف تعیین‌شده در جدول سالانه رفاهی و فقط برای موارد درمان، ازدواج و حوادث پرداخت میشود.»
قاعده ۹: پرسشهای متداول را به‌صورت پرسش و پاسخ بنویسید
بخش پرسش و پاسخ در انتهای هر مقاله، دقیقاً همان قالبی است که دستیار با آن کار میکند. پرسش را با زبان کاربر بنویسید، حتی اگر کمی محاوره‌ای باشد، و پاسخ را کوتاه و کامل.
قاعده ۱۰: سطح دسترسی را مشخص کنید
برخی مقاله‌ها فقط برای مدیران، برخی فقط برای یک واحد و برخی برای همه‌اند. سطح دسترسی را در فراداده مقاله ثبت کنید تا دستیار هنگام پاسخ، مجوز کاربر را رعایت کند. اطلاعات محرمانه را در مقاله عمومی ننویسید.
جدول خلاصه قواعد
| قاعده | اشتباه رایج | اثر بر دستیار |
|---|---|---|
| یک موضوع در هر مقاله | سند جامع چندموضوعی | ترکیب نادرست پاسخ |
| عنوان دقیق | «نکات مهم» | پیدا نشدن قطعه درست |
| تاریخ و نسخه | چند نسخه هم‌زمان | پاسخ از نسخه منسوخ |
| مالک مشخص | بدون مسئول | به‌روز نشدن |
| جمله خودبسنده | «طبق موارد فوق» | گم‌شدن معنا در قطعه |
| جدول متنی | تصویر جدول | خوانده نشدن داده |
| اصطلاح یک‌دست | سه نام برای یک چیز | عدم تطابق |
| عدد و شرط صریح | «مبلغ مناسب» | پاسخ مبهم |
| پرسش و پاسخ | فقط متن پیوسته | تطابق ضعیف با پرسش کاربر |
| سطح دسترسی | همه‌چیز برای همه | نشت اطلاعات |
گام‌به‌گام بازنویسی پایگاه دانش موجود
نیازی نیست همه پایگاه دانش را یک‌باره بازنویسی کنید. این ترتیب پیشنهاد میشود:
- فهرست پرسشهای پرتکرار را بگیرید از تیکت‌ها، ایمیل‌ها و گزارش جستجوهای بی‌نتیجه.
- مقالههایی که به این پرسش‌ها پاسخ میدهند را پیدا کنید و اولویت را به آن‌ها بدهید.
- نسخههای تکراری و منسوخ را بایگانی کنید و فقط یک نسخه معتبر نگه دارید.
- ده قاعده را روی هر مقاله اولویت‌دار اعمال کنید: تقسیم، عنوان، تاریخ، مالک، جمله‌ها، جدول‌ها، اصطلاح، عدد، پرسش و پاسخ، دسترسی.
- با پرسشهای واقعی آزمون کنید و پاسخ دستیار را با کارشناس بسنجید.
- چرخه بازبینی تعریف کنید؛ مثلاً هر شش ماه یا با هر تغییر آیین‌نامه.
اگر رویه‌ها و دستورالعمل‌های فرایندی دارید، قالب پیشنهادی را در مقاله مستندسازی فرایند و قالب SOP ببینید؛ همان قالب با این قواعد به‌خوبی سازگار است. برای ساختار پوشه‌ها و نام‌گذاری فایل‌ها هم مقاله ساختار پوشه و نام‌گذاری اسناد کمک میکند.
نمونه پیش و پس از بازنویسی
پیش از بازنویسی (بخشی از یک سند جامع):
طبق موارد فوق، همکاران محترم می‌توانند در صورت لزوم از مرخصی استفاده نمایند. ضمناً این مورد برای همکاران قراردادی نیز با شرایط خاص قابل اجراست. جدول مربوط در پیوست آمده است.
پس از بازنویسی (مقاله مستقل):
عنوان: مرخصی استحقاقی کارکنان قراردادی: سقف و نحوه ثبت مالک: واحد منابع انسانی | آخرین بازبینی: آبان ۱۴۰۵ | نسخه: ۳
کارکنان قراردادی مانند کارکنان رسمی از مرخصی استحقاقی سالانه برخوردارند. درخواست مرخصی باید حداقل سه روز کاری پیش از تاریخ شروع از طریق پرتال کارکنان ثبت شود و به تأیید مدیر مستقیم برسد.
پرسش: اگه قراردادم وسط سال شروع شده باشه، چقدر مرخصی دارم؟ پاسخ: مرخصی به نسبت ماه‌های کارکرد در همان سال محاسبه میشود.
(این نمونه فرضی است و قواعد واقعی باید از آیین‌نامه همان سازمان بیاید.)
پیوند با چت‌بات و دستیار داخلی
این قواعد پایه هر پروژه دستیار یا چت‌بات داخلی‌اند. مراحل راه‌اندازی چنین دستیاری را در مقاله چت‌بات داخلی کارکنان و انواع چت‌بات را در مقاله چت‌بات هوش مصنوعی چیست شرح داده‌ایم.
رویکرد آریا آی‌تی
در دانشنامه سازمانی آریا آی‌تی، مقاله‌ها و اسناد در یک فضای کاری با نقش و دسترسی مدیریت می‌شوند و مخزن اسناد نسخه منتشرشده را از پیش‌نویس جدا نگه می‌دارد تا پاسخ دستیار به نسخه منسوخ استناد نکند. دستیار هوش مصنوعی سازمانی روی همین دانش و با رعایت نقش کاربر، پاسخ ترکیبی با ارجاع به منبع میدهد. ده قاعده این راهنما، کیفیت پاسخ‌ها را در هر سامانه‌ای، از جمله آریا آی‌تی، بالا می‌برد.
جمع‌بندی
پایگاه دانش آماده هوش مصنوعی، پایگاه دانشی است که هر مقاله آن یک موضوع، عنوان دقیق، تاریخ و نسخه، مالک مشخص، جمله‌های خودبسنده، جدول متنی، اصطلاحات یک‌دست، عدد و شرط صریح، بخش پرسش و پاسخ و سطح دسترسی روشن داشته باشد. این قواعد ساده‌اند، اما بیشتر از تغییر مدل یا ابزار، کیفیت پاسخ دستیار را بهبود میدهند.
مشاوره رایگان: برای ارزیابی آمادگی پایگاه دانش سازمانتان برای دستیار هوش مصنوعی، با کارشناسان آریا آی‌تی صحبت کنید.
مراحل انجام کار
استخراج پرسشهای پرتکرار
از تیکت‌ها، ایمیل‌ها و جستجوهای بی‌نتیجه فهرست پرسش‌ها را بگیرید.
یافتن مقاله‌های مرتبط
مقالههایی که به این پرسش‌ها پاسخ میدهند را اولویت‌بندی کنید.
حذف نسخههای منسوخ
نسخههای تکراری و قدیمی را بایگانی و فقط یک نسخه معتبر نگه دارید.
اعمال ده قاعده
هر مقاله اولویت‌دار را از نظر موضوع، عنوان، تاریخ، مالک، جمله، جدول، اصطلاح، عدد، پرسش و پاسخ و دسترسی بازنویسی کنید.
آزمون با پرسش واقعی
پاسخ دستیار را با کارشناس هر حوزه بسنجید.
تعریف چرخه بازبینی
بازبینی دوره‌ای یا با هر تغییر آیین‌نامه را برنامه‌ریزی کنید.
پرسشهای متداول
چرا دستیار هوش مصنوعی از نسخه قدیمی سند پاسخ میدهد؟
+
چون سامانه نمیداند کدام نسخه معتبر است، مگر اینکه نسخههای قدیمی بایگانی و از دسترس خارج شوند یا نسخه و تاریخ اعتبار در فراداده ثبت شود.
آیا باید همه پایگاه دانش را بازنویسی کنیم؟
+
خیر. از مقالههایی شروع کنید که به پرسشهای پرتکرار پاسخ میدهند. بازنویسی همین بخش کوچک معمولاً بیشترین اثر را بر کیفیت پاسخ دستیار دارد.
چرا جملههایی مثل «طبق موارد فوق» مشکلسازند؟
+
چون دستیار اسناد را به قطعههای کوچک تقسیم میکند و ممکن است قطعهای که «موارد فوق» در آن است جدا خوانده شود. در این صورت معنای جمله گم میشود.
تفاوت این راهنما با راهنمای ویکی سازمانی چیست؟
+
راهنمای ویکی سازمانی به مفهوم، ساختار و فرهنگ مستندسازی میپردازد. این راهنما مخصوص خوانایی محتوا برای ماشین و دستیارهای مبتنی بر بازیابی است.
