P Pitchbar مستندات

ساخت دستیار فروش

انواع سایت و پیش‌تنظیمات عمودی

دستیاران فروش Pitchbar با نوع سایتی که روی آن اجرا می‌شوند، تطبیق می‌یابند. وقتی یک دستیار فروش راه‌اندازی می‌کنید، سیستم می‌تواند به‌طور خودکار تشخیص دهد که آیا یک فروشگاه اینترنتی، یک سایت مستندات، یک محصول نرم‌افزاری، یک مرکز راهنما، یک سایت بازاریابی یا یک پایگاه دانش داخلی را اجرا می‌کنید — و یک پیش‌تنظیم عمودی را که برای آن زمینه تنظیم شده است، بارگذاری می‌کند.

تغییرات پیش‌تنظیم

هر پیش‌تنظیم چهار نوع پیش‌فرض را بسته‌بندی می‌کند:

  • قطعه راهنمای سیستم — در هر نوبت به راهنمای سیستم هوش مصنوعی اضافه می‌شود. پس از داده‌های بازیابی و قبل از هر راهنمای سیستم سفارشی که می‌نویسید قرار می‌گیرد، بنابراین دستورالعمل‌های سفارشی شما همیشه برنده هستند.
  • پیام‌های شروع — تراشه‌هایی که بازدیدکنندگان در اولین باز مشاهده می‌کنند. برای دستیاران فروش جدید پر می‌شوند. اگر قبلاً لیست خود را انتخاب کرده‌اید، دست نخورده باقی می‌مانند.
  • برچسب راه‌انداز — فراخوان روی کره بسته ویجت (مثلاً "مرور فروشگاه ما"، "جستجوی مستندات").
  • قابلیت‌ها — لیستی از قابلیت‌های UI غنی که ویجت در زمان راه‌اندازی می‌خواند. نمایش‌دهنده‌های فاز ۳ امروزه برای کارت‌های محصول، کارت‌های قیمت‌گذاری، کارت‌های مطالعه موردی و دکمه ارجاع ارسال می‌شوند (مشاهده کنید resources/widget/src/ui/blocks.tsx)؛ نمایش‌دهنده‌های بیشتری (بلوک‌های کد، آکاردئون‌های سوالات متداول و غیره) با رشد لیست قابلیت‌ها دنبال می‌شوند.

هفت عمودی

نامکبرای سایت‌هایی که…قابلیت‌ها (قفل‌شده در این نسخه)
ecommerce محصول می‌فروشند. قیمت‌گذاری، موجودی، بازگشت کالا، ارسال. product_card، price_inline، shipping_estimate، cart_handoff، order_status، ticket_escalation
documentation مستندات فنی، مراجع API، راهنماهای SDK منتشر می‌کنند. code_block، api_reference_card، version_picker، troubleshoot_steps، ticket_escalation
saas نرم‌افزار با قیمت‌گذاری، قابلیت‌ها و ثبت‌نام می‌فروشند. pricing_card، signup_handoff، feature_compare، account_status، ticket_escalation
help_center یک سطح پشتیبانی عمومی / سوالات متداول با جریان‌های مقاله و تیکت اجرا می‌کنند. ticket_escalation، kb_article_card، sentiment_routing، ticketing
marketing مشتریان بالقوه را جذب می‌کنند، مطالعات موردی اجرا می‌کنند، محتوای بالای مسیر تولید می‌کنند. lead_capture_inline، demo_booking، case_study_card، ticket_escalation
internal_kb یک ویکی کارمندان، کتابچه‌های عملیاتی یا مستندات انطباق را ارائه می‌دهند. policy_lookup، team_handoff، auth_aware، ticket_escalation
generic هیچ‌کدام از موارد بالا، یا همه چیز را خودتان پیکربندی می‌کنید. فقط ticket_escalation — هر عمودی این را در معرض دید قرار می‌دهد تا هوش مصنوعی همیشه بتواند به یک انسان ارجاع دهد.

تشخیص خودکار

در طول شروع کار (پس از چسباندن آدرس وب‌سایت خود)، Pitchbar صفحه اصلی را دریافت می‌کند، مجموعه‌ای از سیگنال‌های ساختاریافته را امتیازدهی کرده و بالاترین امتیاز را انتخاب می‌کند. سیگنال‌هایی که وزن می‌کند:

  • تگ متا og:type (مثلاً product، website، article)
  • مقادیر @type JSON-LD (نهادهای Schema.org مانند Product، SoftwareApplication، FAQPage، TechArticle)
  • متا generator (Shopify، WooCommerce، Docusaurus، Mintlify، Zendesk، WordPress…)
  • الگوهای مسیر آدرس (/products، /docs، /help، /api)
  • سیگنال‌های نام میزبان (زیردامنه‌های app. / dashboard. برای SaaS؛ .local / .internal برای پایگاه دانش)
  • وجود تگ‌های <article> و بلوک‌های <pre><code>

هر سیگنال وزنی دارد؛ عمودی با بیشترین مجموع برنده می‌شود. اگر هیچ عمودی آستانه اطمینان ۰.۲۵ را پاک نکند، تشخیص‌دهنده به generic بازگشته و از شما می‌خواهد به‌صورت دستی انتخاب کنید.

تشخیص خودکار با بهترین تلاش انجام می‌شود. SPAهای سنگین JS که HTML SSR خالی ارسال می‌کنند، یا میزبان‌های پشت دیوار احراز هویت، به generic بازمی‌گردند — همیشه می‌توانید یک عمودی را به‌صورت دستی از کارت‌های رادیویی انتخاب کنید.

تغییر عمودی بعداً

/app/agents/{id}/vertical را از کاشی‌های ناوبری دستیار فروش باز کنید. می‌توانید:

  • تشخیص مجدد اگر سایت شما تغییر کرده است (مثلاً یک فروشگاه شاپیفای به یک سایت قبلاً فقط محتوایی اضافه کرده‌اید).
  • انتخاب یک عمودی متفاوت از طریق شبکه رادیویی. اگر سفارشی‌سازی‌های شما بازنویسی شوند، یک دیالوگ تأیید دقیقاً توضیح می‌دهد که چه چیزی جایگزین می‌شود.

قطعه راهنمای سیستم در زمان اجرا اعمال می‌شود — در رکورد دستیار فروش نصب نمی‌شود، بنابراین تغییر عمودی فوراً راهنما را با بدون متن کهنه تغییر می‌دهد. قابلیت‌ها نیز در زمان اجرا هستند: ویجت لیست زنده را در هر فراخوانی /init دریافت می‌کند. پیام‌های شروع و برچسب راه‌انداز در زمان اعمال در رکورد دستیار فروش ادغام می‌شوند، بنابراین می‌توانید آنها را در سفارشی‌سازی بدون از دست دادن کار خود در دفعه بعدی که همان عمودی را دوباره اعمال می‌کنید، ویرایش کنید.

لغو قابلیت‌ها

هر دستیار فروش یک ستون JSON اختیاری vertical_overrides دارد. vertical_overrides.capabilities = [...] را تنظیم کنید تا لیست قابلیت‌های پیش‌تنظیم را با لیست خود جایگزین کنید. ویجت لغو را می‌خواند؛ هوش مصنوعی هنوز قطعه سیستم پیش‌تنظیم را می‌بیند، بنابراین لغوهای شما به‌طور تصادفی قرارداد راهنما را تضعیف نمی‌کنند.

فضاهای کاری و امنیت

هر دو نقطه پایانی (POST /app/agents/{agent}/vertical/detect و POST /app/agents/{agent}/vertical/apply) توسط AgentPolicy::update محافظت می‌شوند — فقط اعضای فضای کاری دستیار فروش می‌توانند آنها را فراخوانی کنند. دسترسی بین فضاهای کاری ۴۰۳ برمی‌گرداند. vertical_signals آخرین تشخیص را در ردیف دستیار فروش کش می‌کند تا رابط مدیریت بتواند "تشخیص خودکار در …" را بدون دریافت مجدد نشان دهد.

مرحله بعدی چیست

فاز ۱ مدل داده، تشخیص، پیش‌تنظیم‌ها، تجربه کاربری مدیریت را ارسال کرده و capabilities را در معرض ویجت قرار می‌دهد. فاز ۲ (فراخوانی ابزار / تابع) تا حدی ارسال شده است — ToolRegistry در app/Services/Tools/ToolRegistry.php متصل شده است و اولین ابزار (EscalateToHumanTool) با محافظت از قابلیت ticket_escalation ارسال می‌شود. ابزارهای خاص عمودی (product_lookup برای تجارت الکترونیک و غیره) با فرود یکپارچه‌سازی‌ها دنبال می‌شوند. فاز ۳ (نمایش‌دهنده‌های پیام غنی در ویجت) تا حدی ارسال شده است — resources/widget/src/ui/blocks.tsx بلوک‌های محصول، قیمت‌گذاری، مطالعه موردی و ارجاع را که هوش مصنوعی از طریق نشانگرهای XML درون‌خطی منتشر می‌کند، نمایش می‌دهد؛ نمایش‌دهنده‌های بیشتری با گسترش لیست قابلیت‌ها دنبال می‌شوند.

زبان خود را انتخاب کنید