MCP Tools Reference: paydeveloper.googleapis.com

ابزار: search_documentation

مرتبط‌ترین و به‌روزترین بخش‌ها را از مستندات رسمی توسعه‌دهندگان و نمونه‌های کد Google Pay و Google Wallet جستجو و بازیابی می‌کند.

نمونه کد زیر نحوه استفاده از curl برای فراخوانی ابزار search_documentation MCP را نشان می‌دهد.

درخواست کرل 
curl --location 'https://paydeveloper.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_documentation",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

طرحواره ورودی

درخواست پیام برای جستجوی اسناد.

جستجومستنداتدرخواست

نمایش JSON 
{
  "userQuery": string,
  "languageCode": string
}
فیلدها
userQuery

string

الزامی. عبارت مورد جستجو.

languageCode

string

اختیاری. کد زبان IETF BCP-47 برای عبارت جستجو.

طرحواره خروجی

پیام پاسخ برای جستجوی اسناد.

جستجومستنداتپاسخ

نمایش JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
فیلدها
results[]

object ( DocumentChunk )

تکه‌های سند با عبارت جستجو شده مطابقت دارند و با استفاده از امتیاز مرتبط بودن که شباهت بین عبارت جستجو شده توسط کاربر و محتوای آن تکه را ارزیابی می‌کند، مرتب شده‌اند.

سندچانک

نمایش JSON 
{
  "title": string,
  "uri": string,
  "content": string
}
فیلدها
title

string

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

uri

string

URI مربوط به سندی که قطعه داده به آن تعلق دارد را مشخص می‌کند.

content

string

شامل محتوای قطعه است.

حاشیه‌نویسی ابزار

حاشیه‌نویسی‌های ابزار برای توصیف ریسک اولیه‌ی یک ابزار مشخص به کلاینت‌های MCP ارسال می‌شوند. اکثر کلاینت‌ها این نکات را غیرقابل اعتماد می‌دانند، اما می‌توان از آنها برای تصمیم‌گیری در مورد زمان ارسال پیام تأیید به کاربر استفاده کرد.

همراه با رشته عنوان، نکات بولی زیر به صورت زیر تعریف می‌شوند:

  • readOnlyHint : اگر درست باشد، ابزار محیط خود را تغییر نمی‌دهد. پیش‌فرض: نادرست.
  • destructiveHint : اگر درست باشد، ابزار می‌تواند اقدامات مخرب انجام دهد. اگر نادرست باشد، ابزار فقط می‌تواند اقدامات افزایشی انجام دهد. پیش‌فرض: درست.
  • idempotentHint : اگر مقدار آن درست باشد، فراخوانی مکرر ابزار با آرگومان‌های یکسان، هیچ تأثیر اضافی بر محیط آن نخواهد داشت. پیش‌فرض: false.
  • openWorldHint : اگر درست باشد، ابزار می‌تواند با «دنیای باز» از موجودیت‌های خارجی تعامل داشته باشد. اگر نادرست باشد، ابزار فقط می‌تواند با موجودیت‌های داخلی تعامل داشته باشد. برای مثال، یک ابزار جستجوی وب جهان‌باز خواهد بود، در حالی که یک ابزار حافظه جهان‌باز نخواهد بود.

راهنمایی مخرب: ❌ | راهنمایی بی‌اثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌