MCP Tools Reference: developerknowledge.googleapis.com

الأداة: answer_query

استخدِم answer_query للحصول على إجابة مفاهيمية مركّبة ومستندة إلى مصادر عن سؤال عام حول منتجات Google Developers. للحصول على عينات تعليمات برمجية دقيقة أو علامات واجهة سطر الأوامر (CLI) أو رسائل خطأ محدّدة أو جولات تفصيلية في المستندات، يُفضَّل استخدام search_documents متبوعًا بـ get_documents بدلاً من ذلك. هذه الأداة لها حصة محدودة. ستقوم هذه الأداة بتجميع المعلومات من المجموعة لإنشاء إجابة عن طلب البحث. تستند answer_query إلى الإجابات باستخدام المجموعة نفسها مثل search_documents. تعرض هذه الأداة answer_text الذي تم إنشاؤه وقائمة بأسماء المستندات (المراجع) المستخدَمة لإنشاء الإجابة. يجب دائمًا الإشارة إلى أسماء المستندات المصدر الموثوقة من references (documents/...) في ردّك النهائي على المستخدم. استخدِم get_documents مع أسماء المستندات من references لجلب محتوى المستند بالكامل إذا لزم الأمر.

إذا ظهر لك الخطأ 429 بسبب تجاوز الحصة، استخدِم search_documents بدلاً من ذلك.

يوضّح نموذج الرمز البرمجي التالي كيفية استخدام curl لاستدعاء أداة MCP‏ answer_query.

طلب Curl 
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": "answer_query",
    "arguments": {
      // Provide these details according to the MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

رسالة طلب لـ "AnswerQuery"

AnswerQueryRequest

تمثيل JSON 
{
  "query": string
}
الحقول
query

string

الحقل مطلوب. طلب البحث الذي يجب الإجابة عنه

مخطط النتائج

رسالة الردّ على AnswerQuery

AnswerQueryResponse

تمثيل JSON 
{
  "answerText": string,
  "references": [
    string
  ]
}
الحقول
answerText

string

الإجابة عن طلب البحث
references[]

string

للعرض فقط. أسماء مراجع المستندات المستخدَمة لإنشاء الإجابة (مثلاً، documents/docs.cloud.google.com/storage/docs/creating-buckets). يجب الإشارة إلى أسماء المراجع هذه في الردّ النهائي وإرسالها إلى get_documents إذا كان محتوى المستند الكامل مطلوبًا.

التعليقات التوضيحية للأدوات

يتم إرسال التعليقات التوضيحية للأدوات إلى عملاء MCP لوصف المخاطر الأساسية لأداة معيّنة. تتعامل معظم البرامج مع هذه التلميحات على أنّها غير موثوق بها، ولكن يمكن استخدامها لتحديد الحالات التي قد يتم فيها إرسال طلب تأكيد إلى المستخدم.

إلى جانب سلسلة العنوان، يتم تحديد التلميحات المنطقية التالية على النحو التالي:

  • ‫readOnlyHint: إذا كانت القيمة "صحيح"، لا تعدّل الأداة بيئتها. القيمة التلقائية: false
  • ‫destructiveHint: إذا كانت القيمة "صحيح"، يمكن للأداة تنفيذ إجراءات مدمّرة. إذا كانت القيمة "خطأ"، يمكن للأداة تنفيذ إجراءات إضافية فقط. القيمة التلقائية: true
  • ‫idempotentHint: إذا كانت القيمة "صحيح"، لن يؤدي استدعاء الأداة بشكل متكرّر باستخدام الوسيطات نفسها إلى أي تأثير إضافي على بيئتها. القيمة التلقائية: false
  • ‫openWorldHint: إذا كانت القيمة صحيحة، يمكن للأداة التفاعل مع "عالم مفتوح" من الكيانات الخارجية. إذا كانت القيمة "خطأ"، يمكن للأداة التفاعل مع الكيانات الداخلية فقط. على سبيل المثال، أداة بحث الويب هي أداة عالم مفتوح، بينما أداة الذاكرة ليست كذلك.

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌