اتصال یک دستیار هوش مصنوعی

هر دستیاری که بتواند درخواست HTTP بفرستد، مثل Claude Code یا Codex، می‌تواند از راه API با لُب کار کند: مسیرها را از سند OpenAPI لُب یاد می‌گیرد و هر درخواست را با توکنی می‌فرستد که برایش ساخته‌اید.

پیش از شروع

• برای دستیار توکنی جداگانه بسازید، فقط با دسترسی‌هایی که کارش لازم دارد و، اگر دقیقه خرج می‌کند، با سقف روزانه. توکن‌ها و دسترسی‌ها را ببینید.
• «حالت توسعه‌دهنده» را روشن نگه دارید. تا وقتی خاموش است، هر درخواستی که دستیار بفرستد پاسخ 403 DEVELOPER_MODE_OFF می‌گیرد؛ حالت توسعه‌دهنده را ببینید.

راه‌اندازی

export LOBBE_TOKEN=lobbe_…

# Then tell your agent:
#   Use the Lobbe API at https://app.lobbe.ai/api/v1 with the bearer token in $LOBBE_TOKEN.
#   Its OpenAPI document: https://app.lobbe.ai/api/v1/openapi.json
#   Ask for a meeting's status no more than once a minute.

توکن را در متغیر محیطی LOBBE_TOKEN بگذارید، در همان محیطی که دستیار در آن اجرا می‌شود. بعد سطرهای پس از # Then tell your agent: را به دستیار بدهید: در دستورالعمل‌هایش، یا در آغاز گفت‌وگو. این سطرها فقط نام متغیر را دارند، نه خود توکن را. در برنامه هم «اتصال‌ها» › «دستیارها» همین سطرها را نشان می‌دهد.

دستیار چه چیزهایی را می‌تواند بخواند

• سند OpenAPI، یعنی https://app.lobbe.ai/api/v1/openapi.json: همهٔ مسیرها، فیلدها و خطاهایشان. خواندن آن توکن لازم ندارد. هر عملیات در این سند می‌گوید چه دسترسی‌هایی لازم دارد (x-lobbe-scopes)، دقیقه خرج می‌کند یا نه (x-lobbe-spends)، و سقف درخواست‌هایش چقدر است (x-lobbe-rate-limit). همین سند در این مستندات هم در /openapi.json هست.
• همین مستندات، به‌صورت Markdown. llms.txt همهٔ صفحه‌ها را فهرست می‌کند، هر کدام با لینکی به نسخهٔ Markdown آن، و llms-full.txt همهٔ صفحه‌ها را در یک فایل دارد؛ این دو فایل به انگلیسی‌اند. هر صفحه، به هر دو زبان، در نشانی خودش به‌صورت Markdown هم هست، با .md به‌جای / پایانی: https://docs.lobbe.ai/fa/guides/lifecycle.md یا https://docs.lobbe.ai/guides/lifecycle.md. دو صفحهٔ آغازین استثنا هستند: https://docs.lobbe.ai/fa/index.md و https://docs.lobbe.ai/index.md.

سطرهای بالا فقط سند OpenAPI را نام می‌برند. اگر می‌خواهید دستیار راهنماها را هم بخواند، https://docs.lobbe.ai/llms.txt را هم به او بگویید.

قاعده‌هایی برای دستیار

این قاعده‌ها را هم به دستیار بگویید:

• وضعیت جلسه را بیش از یک بار در دقیقه نپرسد. بیشتر جلسه‌ها در چند دقیقه آماده می‌شوند. برای دنبال کردن چند جلسه، به‌جای آن فید رویدادها را بخواند. با پاسخ 429، به اندازهٔ ثانیه‌هایی که Retry-After می‌گوید صبر کند.
• در NAMING، naming.url را به شخص بدهد و خودش نام گوینده‌ها را حدس نزند. این لینک نام‌گذاری گوینده‌های جلسه را در برنامه برای صاحب جلسه باز می‌کند، و آن‌وقت تصمیم‌ها و اقدام‌های لُب به نام واقعی افراد نوشته می‌شوند. فقط وقتی شخص خودش بخواهد، از نام‌گذاری رد شود؛ نام‌گذاری گوینده‌ها را ببینید.
• پیش از هر پرسش، قیمتش را بگیرد. گرفتن قیمت پرسش رایگان است. بعد پرسش را با maxMinutes برابر minutes همان قیمت بفرستد تا هزینه‌اش هرگز از آن بیشتر نشود. هر پاسخ دقیقه خرج می‌کند، حتی وقتی لُب از پاسخ خودداری کند؛ پرسش از یک جلسه را ببینید.
• با هر درخواستی که دقیقه خرج می‌کند Idempotency-Key بفرستد، کلیدی که یک بار ساخته می‌شود و برای همهٔ تلاش‌های دوبارهٔ همان درخواست می‌ماند، تا تلاش دوباره هرگز دو بار هزینه نداشته باشد؛ تکرارپذیری و تلاش دوباره را ببینید.
• هرگز توکن را نشان ندهد. آن را از $LOBBE_TOKEN بخواند و هرگز چاپ نکند، در URL نگذارد، در فایل یا لاگ ننویسد و در پاسخ‌هایش نیاورد؛ امن نگه داشتن توکن را ببینید.
• با پاسخ 403 DEVELOPER_MODE_OFF دست نگه دارد و به شخص خبر بدهد. صاحب حساب «حالت توسعه‌دهنده» را خاموش کرده که همهٔ توکن‌های حساب را متوقف می‌کند، و تا دوباره روشن نشود تلاش دوباره فایده‌ای ندارد؛ خطاها را ببینید.

آنچه در راه است

سرور MCP و خط فرمان لُب در راه‌اند. تا آن موقع، دستیار از راه سند OpenAPI وصل می‌شود.

یادداشت

ارسال جلسه، ساختن و ویرایش سری، تغییر تنظیمات، جست‌وجو و پرسش با توکن به‌تدریج روشن می‌شوند. اگر فرم «اتصال‌ها» دسترسی‌ای را پیشنهاد نمی‌دهد، آن دسترسی هنوز برای حساب شما فعال نشده است.