ابزار: search_documents
از این ابزار برای یافتن مستندات مربوط به محصولات توسعهدهندگان گوگل استفاده کنید. این اسناد شامل APIهای رسمی، قطعه کدهای کوتاه، یادداشتهای انتشار، بهترین شیوهها، راهنماها، اطلاعات اشکالزدایی و موارد دیگر است. این اسناد محصولات و حوزههای زیر را پوشش میدهد:
- اندروید: developer.android.com
- آپیجی: docs.apigee.com
- Chrome: developer.chrome.com
- فایربیس: firebase.google.com
- فوشیا: fuchsia.dev
- هوش مصنوعی گوگل: ai.google.dev
- گوگل کلود: docs.cloud.google.com
- توسعهدهندگان گوگل، تبلیغات، جستجو، نقشههای گوگل، یوتیوب: developers.google.com
- گوگل هوم: developers.home.google.com
- تنسورفلو: www.tensorflow.org
- وب: web.dev
این ابزار تکههایی از متن، نامها و URLها را برای اسناد منطبق برمیگرداند. اگر تکههای برگردانده شده به اندازه کافی دقیق نیستند تا به سوال کاربر پاسخ دهند، از get_documents به همراه parent خروجی این ابزار برای بازیابی محتوای کامل سند استفاده کنید.
نمونه زیر نحوه استفاده از curl برای فراخوانی ابزار search_documents MCP را نشان میدهد.
| درخواست کرل |
|---|
curl --location 'https://developerknowledge.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "search_documents", "arguments": { // provide these details according to the tool's MCP specification } }, "jsonrpc": "2.0", "id": 1 }' |
طرحواره ورودی
درخواست طرحواره برای search_documents. از فیلد پرس و جو برای جستجوی اسناد توسعهدهنده گوگل مرتبط استفاده کنید.
درخواست جستجو
| نمایش JSON |
|---|
{ "query": string } |
| فیلدها | |
|---|---|
query | الزامی. رشته پرسوجوی خام ارائه شده توسط کاربر، مانند «چگونه یک مخزن ذخیرهسازی ابری ایجاد کنیم؟». |
طرحواره خروجی
طرحواره پاسخ برای search_documents.
جستجوقطعات سندپاسخ
| نمایش JSON |
|---|
{
"results": [
{
object ( |
| فیلدها | |
|---|---|
results[] | نتایج جستجو برای عبارت جستجو شده. هر سند در این لیست شامل یک قطعه از محتوای مرتبط با عبارت جستجو شده است. برای بازیابی محتوای کامل سند، از فیلد DocumentChunk.name هر نتیجه به همراه get_documents استفاده کنید. |
سندچانک
| نمایش JSON |
|---|
{ "parent": string, "id": string, "content": string } |
| فیلدها | |
|---|---|
parent | فقط خروجی. نام منبع سندی که این قطعه از آن است. قالب: |
id | فقط خروجی. شناسه این قطعه در داخل سند. شناسه قطعه در داخل یک سند منحصر به فرد است، اما به صورت جهانی در بین اسناد منحصر به فرد نیست. شناسه قطعه پایدار نیست و ممکن است با گذشت زمان تغییر کند. |
content | فقط خروجی. محتوای بخش سند. |
حاشیهنویسی ابزار
راهنمایی مخرب: ❌ | راهنمایی بیاثر: ✅ | راهنمایی فقط خواندنی: ✅ | راهنمایی جهان باز: ❌