<link rel="stylesheet" href="assets/fontawesome/css/all.min.css" />

اتصال عامل هوش مصنوعی یا نرم‌افزار خود به Tolk2Go

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

آنچه می‌توانید متصل کنید

  • سایر ابزارهای هوش مصنوعی، مانند Microsoft Copilot، Gemini یا Cursor.
  • عامل‌سازها، مانند n8n یا Zapier.
  • چت‌بات یا دستیار اختصاصی خودتان.
  • نرم‌افزار خودتان، مانند یک سیستم برنامه‌ریزی یا مدیریت پرونده، که مترجمان را مستقیماً از طریق API Tolk2Go و بدون هوش مصنوعی رزرو می‌کند.

ابزارهای هوش مصنوعی به سرور MCP Tolk2Go (پروتکل زمینه مدل بر بستر HTTP جریانی) متصل می‌شوند. نرم‌افزار خودتان از REST API استفاده می‌کند که در یک قرارداد OpenAPI شرح داده شده است. جستجوی زبان‌ها، تخصص‌ها و مترجمان در دسترس عمومی است و نیازی به ورود به سیستم ندارد. رزرو همیشه به نمایندگی از یک حساب مشتری Tolk2Go انجام می‌شود.


ورود به سیستم با OAuth

برای کلاینت‌های MCP که از ورود با OAuth پشتیبانی می‌کنند. نیازی به هیچ کلیدی نیست.

  1. افزودن سرور MCP https://api.tolk2go.com/api/v1/mcp به کلاینت.
  2. وارد شوید و اجازه دسترسی بدهید. کلاینت یک صفحه Tolk2Go را باز می‌کند. کاربر با حساب مشتری Tolk2Go خود وارد سیستم می‌شود و گزینه اجازه دسترسی را انتخاب می‌کند. رمز عبور نزد Tolk2Go باقی می‌ماند.
  3. قطع اتصال در هر زمان از بخش دسترسی عامل هوش مصنوعی در حساب کاربری.

Tolk2Go از OAuth 2.1 با PKCE و ثبت پویای کلاینت پشتیبانی می‌کند. فراداده سرور مجازشمار در https://api.tolk2go.com/.well-known/oauth-authorization-server قرار دارد.


اتصال با کلید عامل

برای کلاینت‌های فاقد پشتیبانی از OAuth و برای نرم‌افزار خودتان بر روی REST API.

  1. از حساب Tolk2Go استفاده کنید که رزروها به آن تعلق دارند. تازه‌وارد هستید؟ ابتدا یک حساب ایجاد کنید.
  2. ایجاد کلید عامل. وارد سیستم شوید و بخش دسترسی عامل هوش مصنوعی را در حساب باز کنید، گزینه ایجاد کلید را انتخاب کرده و کلید را کپی نمایید. این کلید فقط یک بار نمایش داده می‌شود: آن را در تنظیمات محرمانه کلاینت ذخیره کنید، هرگز در چت یا پرامپت قرار ندهید.
  3. اتصال کلاینت به سرور MCP Tolk2Go با کلید (نمونه پیکربندی در زیر)، یا قرارداد OpenAPI را به آن ارائه دهید. یک کلاینت همچنین می‌تواند پس از یک بار ورود از طریق API، خودش کلید صادر کند.
  4. جایگزینی یا لغو کلید در هر زمان از بخش دسترسی عامل هوش مصنوعی. کلید لغوشده بلافاصله متوقف می‌شود.

آدرس‌ها

عنوان آدرس
سرور MCP (HTTP جریانی) https://api.tolk2go.com/api/v1/mcp
قرارداد OpenAPI https://api.tolk2go.com/api/v1/spec
راهنمای عامل‌های هوش مصنوعی https://www.tolk2go.com/llms.txt
مهارت عامل و نمونه‌های راه‌اندازی github.com/Tolk2Go-Organization/agent-skills

نمونه پیکربندی کلاینت MCP با کلید عامل:

{
  "mcpServers": {
    "tolk2go": {
      "type": "http",
      "url": "https://api.tolk2go.com/api/v1/mcp",
      "headers": { "Authorization": "Bearer t2g_agent_..." }
    }
  }
}

آیا می‌خواهید کل فرآیند رزرو را به‌طور هم‌زمان در عامل خود داشته باشید؟ مهارت عامل Tolk2Go را با npx skills add Tolk2Go-Organization/agent-skills نصب کنید.


امنیت

  • فقط یک حساب کاربری. یک برنامه متصل یا یک کلید عامل تنها می‌تواند رزروهای حسابی را که آن را متصل کرده است مشاهده و مدیریت کند.
  • نمایش تنها یک‌بار، ذخیره‌سازی امن. کلید عامل تنها در زمان صدور نمایش داده می‌شود. Tolk2Go فقط یک هش امن را ذخیره می‌کند، هرگز خود کلید را ذخیره نمی‌کند.
  • طول عمر محدود. کلیدها به‌طور پیش‌فرض ۹۰ روز اعتبار دارند (می‌توان بین ۷ تا ۳۶۵ روز را انتخاب کرد)، بنابراین یک عامل می‌تواند هفته‌ها بعد بدون نیاز به ورود مجدد بازگردد.
  • جایگزینی، لغو یا قطع اتصال در هر زمان. در بخش دسترسی عامل هوش مصنوعی، مشتری هر کلید را همراه با آخرین استفاده آن و هر برنامه متصل‌شده‌ای را می‌بیند، و با یک کلیک کلیدی را جایگزین یا لغو کرده و یا اتصال برنامه‌ای را قطع می‌کند.
  • هرگز مسدود نمی‌شوید. کلیدی گم شده است؟ آن را در حساب کاربری لغو کنید و یک کلید جدید بسازید. ورود عادی به حساب کاربری همیشه به کار خود ادامه می‌دهد.
  • عدم پرداخت توسط عامل. هنگامی که پیش‌پرداخت لازم باشد، عامل یک پیوند پرداخت امن برای مشتری دریافت می‌کند.

پرسش‌های متداول

از چه کلاینت‌هایی پشتیبانی می‌شود؟

هر دستیار یا عاملی که از Model Context Protocol (MCP) روی Streamable HTTP، همراه با ورود OAuth یا یک کلید عامل پشتیبانی کند، و هر نرم‌افزاری که بتواند یک REST API توصیف‌شده در OpenAPI را فراخوانی کند.

اگر کلید عامل گم یا فاش شود چه اتفاقی می‌افتد؟

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

آیا نرم‌افزار خودمان می‌تواند بدون دستیار هوش مصنوعی رزرو انجام دهد؟

بله. REST API همان امکانات جستجو، رزرو و پیگیری را مانند سرور MCP ارائه می‌دهد. قرارداد OpenAPI را در بالا مشاهده کنید.


برای اتصال به کمک نیاز دارید؟

خوشحال می‌شویم به بخش فناوری اطلاعات یا توسعه‌دهنده شما در اتصال Tolk2Go کمک کنیم.