پرش به مطلب اصلی

شروع سریع با هوش مصنوعی

اگر از ابزارهای کدنویسی هوش مصنوعی مانند Claude Code، Cursor، ChatGPT یا OpenCode استفاده می‌کنید، نیازی به پیاده‌سازی دستی کدها و اتلاف وقت ندارید. می‌توانید محافظت در برابر بات آرکپچا را مستقیماً با یک پرامپت استاندارد به پروژه اضافه کنید.

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

پرامپت یکپارچه‌سازی با هوش مصنوعی​

برای افزودن خودکار آرکپچا به پروژه، کافی است پرامپت زیر را کپی کرده و به دستیار هوش مصنوعی خود بدهید:

Please read https://docs.arcaptcha.co/onboard.md and help me integrate ARCaptcha into this project.

این دستور هوش مصنوعی را به سند فنی و جامع onboard.md هدایت می‌کند که شامل الزامات کلاینت، اندپوینت‌های تایید سرور، فهرست SDKها و اصول امنیتی است.

دستیارهای هوش مصنوعی پشتیبانی‌شده​

Claude Code

CLI Agent

اجرای دستور مستقیم در ترمینال

Cursor

AI IDE

ارسال مستقیم به Composer / Chat

ChatGPT

Web & App

شروع چت با پرامپت آماده

OpenCode

Terminal

اجرای کلاینت OpenCode در ترمینال

سایر ایجنت‌ها

Universal

کپی پرامپت برای Copilot، Windsurf و ...

معماری امنیتی و تفکیک کلیدها​

آرکپچا از مدل دوکلیدی استفاده می‌کند. هنگام کار با دستیارهای هوش مصنوعی، رعایت تفکیک کلیدها الزامی است:

کلیدمحیطمکان قرارگیریاصل امنیتی
Site Key (کلید سایت)عمومی (سمت کاربر)صفت data-site-key در تگ HTML یا تنظیمات SDKقرار گرفتن آن در فرانت‌اند و در دسترس هوش مصنوعی کاملاً امن است.
Secret Key (کلید مخفی)محرمانه (سمت سرور)متغیرهای محیطی سرور (ARCAPTCHA_SECRET_KEY)بسیار مهم: هرگز کلید مخفی را در کدهای کلاینت یا مخزن گیت قرار ندهید. به هوش مصنوعی تاکید کنید این کلید را فقط از متغیرهای محیطی سرور بخواند.
حفاظت از کلید مخفی (Secret Key)

هرگز اجازه ندهید مدل هوش مصنوعی secret_key را داخل اسکریپت‌های فرانت‌اند یا قالب‌های عمومی قرار دهد. این کلید فقط باید توسط بک‌اند برای فراخوانی https://api.arcaptcha.co/arcaptcha/api/verify استفاده شود.

مراحل گام‌به‌گام پیاده‌سازی​

۱. دریافت کلیدها: کلید سایت (Site Key) و کلید مخفی (Secret Key) را از داشبورد آرکپچا دریافت کنید.
۲. تنظیم متغیر محیطی: مقدار secret_key را در فایل .env سرور قرار دهید (مثلاً ARCAPTCHA_SECRET_KEY=your_secret_key).
۳. دستور به هوش مصنوعی: فرم یا اندپوینتی که قصد ایمن‌سازی آن را دارید مشخص کنید:

Please read https://docs.arcaptcha.co/onboard.md and add ARCaptcha protection to my login form at /login and verify the token on the server.

۴. انجام مراحل توسط هوش مصنوعی:

  • اسکریپت https://nwidget.arcaptcha.ir/1/api.js (یا پکیج رسمی فریم‌ورک) را اضافه می‌کند.
  • کانتینر <div class="arcaptcha" data-site-key="YOUR_SITE_KEY"></div> را در فرم قرار می‌دهد.
  • مقدار arcaptcha-token را در بک‌اند دریافت می‌کند.
  • توکن را از طریق https://api.arcaptcha.co/arcaptcha/api/verify تایید می‌کند.

مستندات ماشین‌خوان برای هوش مصنوعی​

راه‌اندازی دستی

اگر تمایل دارید بدون دستیار هوش مصنوعی آرکپچا را راه‌اندازی کنید، راهنمای گام‌به‌گام نصب یا لیست پلاگین‌ها و کتابخانه‌ها را ببینید.

افزودن به ایجنتAdd to your Agent