پرش به محتوای اصلی
پلکسیت
API عمومی

API چت‌بات هوش مصنوعی برای اپلیکیشن و سامانهٔ شما

ویجت فقط یکی از راه‌هاست. با API عمومی پلکسیت همان دستیار را از اپلیکیشن موبایل، سایت اختصاصی یا سامانهٔ داخلی خودتان صدا بزنید و پایگاه دانش را از سیستم‌های خودتان به‌روز نگه دارید.

ساخت دستیار رایگانمرجع API
مسئله

ساختن زیرساخت RAG از صفر ماه‌ها طول می‌کشد

استخراج متن، نمایه‌سازی، جست‌وجوی معنایی، تاریخچهٔ گفت‌وگو، کنترل هزینه و امنیت کلیدها هر کدام یک پروژه‌اند. در پلکسیت همهٔ این‌ها پشت چند مسیر HTTP ساده است.

  • ۱

    گفت‌وگو با یک درخواست

    پیام را بفرستید و متن پاسخ، منابع و شناسهٔ گفت‌وگو را بگیرید؛ برای ادامه، همان شناسه را بفرستید.

  • ۲

    مدیریت اسناد از راه دور

    فایل یا متن را به پایگاه دانش اضافه کنید، وضعیت پردازش را بپرسید، فهرست اسناد را بگیرید و سند قدیمی را حذف کنید.

  • ۳

    کلیدهای امن

    کلید را در پنل بسازید؛ فقط یک بار نمایش داده می‌شود، هش‌شده نگهداری می‌شود و هر وقت خواستید باطل می‌شود.

  • ۴

    مستندات فارسی و انگلیسی

    راهنمای شروع سریع، مرجع کامل مسیرها و نمونه‌کد curl، Node.js و Python در سایت مستندات.

همان دستیار، همان دانش، در هر رابطی

API به همان دستیاری وصل است که در ویجت و گفت‌وگوی آزمایشی کار می‌کند؛ پس دانش، دستورالعمل و گزارش مصرف یکی است. هر کاربر شما با یک شناسهٔ دلخواه به نام principal مشخص می‌شود تا گفت‌وگوهای کاربران از هم جدا بمانند.

  • GET /v1/assistants
  • POST /v1/assistants/{assistantCode}/chat
  • POST /v1/assistants/{assistantCode}/documents و /documents/text
  • GET /v1/assistants/{assistantCode}/documents/jobs/{jobId}
نمونه کد

از بارگذاری سند تا گرفتن پاسخ، با چند خط کد

کلید را در هدر Authorization بفرستید؛ همهٔ مسیرها زیر /v1 هستند و پاسخ‌ها JSON. نمونه‌های بیشتر در راهنمای یکپارچه‌سازی API آمده است.

upload.sh
{ "id": "7c1e…", "status": "queued", "path": "returns-policy.pdf" }
{ "status": "ready", "resultNChunks": 42 }
assistant.ts
شروع کار

در سه قدم آماده است

  1. ۱

    کلید بسازید

    از بخش «کلیدهای API» پنل؛ کلید فقط یک بار نمایش داده می‌شود.

  2. ۲

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

    با هدر Authorization: Bearer و شناسهٔ دستیار.

  3. ۳

    پاسخ و منابع را بگیرید

    متن پاسخ، منابع و شناسهٔ گفت‌وگو در یک JSON.

کاربردها

کسب‌وکارهایی که از این امکان بیشترین سود را می‌برند

سؤالات متداول

پرسش‌های رایج دربارهٔ API برای توسعه‌دهندگان

کلید API کجا نگهداری می‌شود؟

کلید خام فقط یک بار، هنگام ساخت، نمایش داده می‌شود و پلکسیت فقط نسخهٔ هش‌شدهٔ آن را نگه می‌دارد. هر زمان خواستید کلید را باطل کنید و کلید تازه بسازید.

محدودیت تعداد درخواست دارد؟

بله؛ هر کلید در دقیقه تا ۶۰ درخواست مجاز است و پس از آن خطای 429 برمی‌گردد.

می‌توانم پایگاه دانش را از سیستم خودم به‌روز کنم؟

بله؛ با مسیرهای documents فایل (تا ۱۰ فایل و هر کدام تا ۲۵ مگابایت در هر درخواست) یا متن اضافه کنید، وضعیت پردازش را بپرسید و اسناد را حذف کنید.

مستندات API کجاست؟

راهنمای شروع سریع و مرجع کامل API در doc.plexit.ir منتشر شده است.

امکانات

امکانات دیگری که کنار این یکی می‌درخشند

دستیار هوشمند کسب‌وکارتان را همین امروز بسازید

ثبت‌نام رایگان است و به کارت بانکی نیاز ندارد. اسنادتان را بارگذاری کنید، در زمین تمرین امتحانش کنید و با یک خط کد روی سایت بگذارید.

رایگان شروع کنیدببینید چطور کار می‌کند