MCP Tools Reference: developerknowledge.googleapis.com

الأداة: answer_query

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

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

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

طلب 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 tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

مخطط الإدخال

رسالة الطلب لأداة AnswerQuery

AnswerQueryRequest

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

string

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

مخطط النتائج

رسالة الردّ لأداة AnswerQuery

AnswerQueryResponse

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

string

الإجابة عن الاستعلام
references[]

string

النتائج فقط. أسماء الموارد للمستندات المستخدَمة لإنشاء الإجابة

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

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

بالإضافة إلى سلسلة العنوان، يتم تعريف التلميحات المنطقية التالية على النحو التالي:

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

تلميح مدمِّر: ❌ | تلميح متكرّر: ✅ | تلميح للقراءة فقط: ✅ | تلميح للعالم المفتوح: ❌