Tools

جستجوی موازی

Plugin Parallel دو ارائه‌دهنده web_search برای Parallel فراهم می‌کند:

  • Parallel Search (Free) (parallel-free) -- Search MCP رایگان Parallel. به حساب یا کلید API نیاز ندارد. وقتی مسیر جست‌وجوی میزبانی‌شده و بدون کلید Parallel را می‌خواهید، آن را صریح انتخاب کنید.
  • Parallel Search (parallel) -- API پولی جست‌وجوی Parallel. به PARALLEL_API_KEY نیاز دارد و محدودیت نرخ بالاتر و تنظیم هدف را ارائه می‌دهد.

هر دو گزیده‌های رتبه‌بندی‌شده و بهینه‌شده برای LLM را از یک نمایه وب ساخته‌شده برای عامل‌های هوش مصنوعی برمی‌گردانند. برای انتخاب صریح یکی از آن‌ها، tools.web.search.provider را روی parallel-free یا parallel تنظیم کنید.

نصب Plugin

Plugin رسمی را نصب کنید، سپس Gateway را بازراه‌اندازی کنید:

bash
openclaw plugins install @openclaw/parallel-pluginopenclaw gateway restart

کلید API (ارائه‌دهنده پولی)

parallel-free به کلید API نیاز ندارد، اما همچنان باید به‌عنوان ارائه‌دهنده مدیریت‌شده انتخاب شود. ارائه‌دهنده پولی parallel به کلید API نیاز دارد:

  • Create an account

    در platform.parallel.ai ثبت‌نام کنید و از داشبورد خود یک کلید API بسازید.

  • Store the key

    PARALLEL_API_KEY را در محیط Gateway تنظیم کنید، یا از طریق این دستور پیکربندی کنید:

    bash
    openclaw configure --section web
  • پیکربندی

    json5
    {  plugins: {    entries: {      parallel: {        config: {          webSearch: {            apiKey: "par-...", // optional if PARALLEL_API_KEY is set            baseUrl: "https://api.parallel.ai", // optional; OpenClaw appends /v1/search          },        },      },    },  },  tools: {    web: {      search: {        // Use "parallel-free" for the free Search MCP, or "parallel" for        // the paid API-backed provider shown here.        provider: "parallel",      },    },  },}

    جایگزین محیطی: PARALLEL_API_KEY را در محیط Gateway تنظیم کنید. برای نصب Gateway، آن را در ~/.openclaw/.env قرار دهید.

    بازنویسی URL پایه

    بازنویسی URL پایه فقط برای ارائه‌دهنده پولی parallel اعمال می‌شود. ارائه‌دهنده رایگان parallel-free همیشه از https://search.parallel.ai/mcp استفاده می‌کند.

    وقتی درخواست‌های Parallel باید از طریق یک پروکسی سازگار یا نقطه پایانی جایگزین Parallel عبور کنند (برای نمونه، Cloudflare AI Gateway)، plugins.entries.parallel.config.webSearch.baseUrl را تنظیم کنید. OpenClaw میزبان‌های خام را با افزودن https:// در ابتدا عادی‌سازی می‌کند و مگر اینکه مسیر از قبل همان‌جا پایان یافته باشد، /v1/search را به انتها اضافه می‌کند. نقطه پایانی حل‌شده در کلید کش جست‌وجو گنجانده می‌شود، بنابراین نتایج از نقاط پایانی مختلف Parallel مشترک نیستند.

    پارامترهای ابزار

    OpenClaw شکل جست‌وجوی بومی Parallel را در دسترس می‌گذارد تا مدل بتواند هم هدف زبان طبیعی و هم چند پرس‌وجوی کوتاه کلیدواژه‌ای را پر کند — ترکیبی که Parallel برای بهترین نتایج توصیه می‌کند.

    objectivestringrequired

    توصیف زبان طبیعی پرسش یا هدف زیربنایی (حداکثر ۵۰۰۰ نویسه). باید خودکفا باشد.

    search_queriesstring[]required

    پرس‌وجوهای جست‌وجوی کلیدواژه‌ای کوتاه، هرکدام ۳ تا ۶ واژه (۱ تا ۵ ورودی، حداکثر ۲۰۰ نویسه برای هرکدام). برای بهترین نتایج، ۲ تا ۳ پرس‌وجوی متنوع ارائه کنید.

    countnumber

    تعداد نتایجی که برگردانده می‌شود (۱ تا ۴۰).

    session_idstring

    شناسه اختیاری نشست Parallel (حداکثر ۱۰۰۰ نویسه در parallel؛ Search MCP رایگان parallel-free آن را به ۱۰۰ محدود می‌کند). در جست‌وجوهای پیگیری که بخشی از همان وظیفه هستند، sessionId را از نتیجه قبلی Parallel ارسال کنید تا Parallel بتواند فراخوانی‌های مرتبط را گروه‌بندی کند و نتایج بعدی را بهبود دهد. شناسه‌ای که از حد عبور کند حذف می‌شود و شناسه تازه‌ای تولید می‌شود.

    client_modelstring

    شناسه اختیاری مدلی که فراخوانی را انجام می‌دهد (مثلاً claude-opus-4-7، gpt-5.5). به Parallel امکان می‌دهد تنظیمات پیش‌فرض را برای قابلیت‌های مدل شما تنظیم کند. اسلاگ دقیق مدل فعال را ارسال کنید؛ آن را به نام مستعار خانواده کوتاه نکنید.

    نکات

    • Parallel نتایج را بر اساس سودمندی برای استدلال LLM رتبه‌بندی و فشرده می‌کند، نه نرخ کلیک انسانی؛ به‌جای محتوای کامل صفحه، انتظار گزیده‌های فشرده در هر نتیجه را داشته باشید
    • گزیده‌های نتیجه به‌صورت آرایه excerpts برمی‌گردند و همچنین برای سازگاری با قرارداد عمومی web_search در فیلد description به هم پیوسته می‌شوند
    • Parallel در هر پاسخ یک session_id برمی‌گرداند؛ OpenClaw آن را در بار ابزار به‌صورت sessionId ارائه می‌کند تا فراخوان‌ها بتوانند جست‌وجوهای پیگیری را گروه‌بندی کنند
    • وقتی searchId، warnings و usage از Parallel وجود داشته باشند، بدون تغییر عبور داده می‌شوند
    • OpenClaw همیشه تعداد نتیجه حل‌شده را به‌صورت advanced_settings.max_results به Parallel ارسال می‌کند. آرگومان count فراخوان مقدم است، سپس تنظیم سطح بالای tools.web.search.maxResults، و در غیر این صورت مقدار پیش‌فرض عمومی web_search در OpenClaw (۵). این کار هنگام جابه‌جایی بین ارائه‌دهنده‌ها حجم نتایج را سازگار نگه می‌دارد؛ Parallel به‌تنهایی به‌صورت پیش‌فرض ۱۰ نتیجه برمی‌گرداند
    • نتایج به‌صورت پیش‌فرض برای ۱۵ دقیقه کش می‌شوند (قابل پیکربندی از طریق cacheTtlMinutes)
    • ارائه‌دهنده رایگان parallel-free همان پارامترها را می‌پذیرد. count را در سمت کلاینت اعمال می‌کند و وقتی شناسه‌ای ارائه نشده باشد، برای هر فراخوانی یک session_id تولید می‌کند.

    مرتبط

    Was this useful?
    On this page

    On this page