MCP Tools Reference: developerknowledge.googleapis.com

เครื่องมือ: search_documents

ใช้เครื่องมือนี้เพื่อค้นหาเอกสารเกี่ยวกับผลิตภัณฑ์สำหรับนักพัฒนาแอปของ Google โดยเอกสารจะมี API อย่างเป็นทางการ, ตัวอย่างโค้ด, บันทึกประจำรุ่น, แนวทางปฏิบัติแนะนำ, คำแนะนำ, ข้อมูลการแก้ไขข้อบกพร่อง และอื่นๆ ซึ่งครอบคลุมผลิตภัณฑ์และโดเมนต่อไปนี้

  • ADK: adk.dev

  • Android: developer.android.com

  • Apigee: docs.apigee.com

  • Chrome: developer.chrome.com

  • Dart: dart.dev

  • Firebase: firebase.google.com

  • Flutter: docs.flutter.dev

  • Fuchsia: fuchsia.dev

  • Gemini CLI: geminicli.com

  • Go: go.dev

  • Google AI: ai.google.dev

  • Google Antigravity: antigravity.google

  • Google Cloud: cloud.google.com &docs.cloud.google.com

  • Google Developers, Ads, Search, Google Maps, Youtube: developers.google.com

  • Google Home: developers.home.google.com

  • Google Maps Platform: mapsplatform.google.com

  • TensorFlow: www.tensorflow.org

  • Web: web.dev

เครื่องมือนี้จะแสดงผลเป็นข้อความ ชื่อ และ URL ของเอกสารที่ตรงกัน หากข้อมูลที่แสดงผลไม่ละเอียดพอที่จะตอบคำถามของผู้ใช้ ให้ใช้ get_documents กับ parent จากเอาต์พุตของเครื่องมือนี้เพื่อดึงข้อมูลเนื้อหาเอกสารฉบับเต็ม

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ search_documents 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": "search_documents",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

สคีมาคำขอสำหรับ search_documents ใช้ช่องคำค้นหาเพื่อค้นหาเอกสารสำหรับนักพัฒนาแอปของ Google ที่เกี่ยวข้อง

SearchDocumentChunksRequest

การแสดง JSON 
{
  "query": string
}
ช่อง
query

string

ต้องระบุ สตริงคำค้นหาดิบที่ผู้ใช้ระบุ เช่น "วิธีสร้างบัคเก็ต Cloud Storage"

สคีมาเอาต์พุต

สคีมาการตอบกลับสำหรับ search_documents

SearchDocumentChunksResponse

การแสดง JSON 
{
  "results": [
    {
      object (DocumentChunk)
    }
  ]
}
ช่อง
results[]

object (DocumentChunk)

ผลการค้นหาสำหรับคำค้นหาที่ระบุ เอกสารแต่ละฉบับในรายการนี้จะมีข้อมูลสรุปเนื้อหาที่เกี่ยวข้องกับคำค้นหา ใช้ช่อง DocumentChunk.name ของผลการค้นหาแต่ละรายการกับ get_documents เพื่อดึงข้อมูลเนื้อหาเอกสารฉบับเต็ม

DocumentChunk

การแสดง JSON 
{
  "parent": string,
  "id": string,
  "content": string
}
ช่อง
parent

string

เอาต์พุตเท่านั้น ชื่อทรัพยากรของเอกสารที่ข้อมูลนี้มาจาก รูปแบบ: documents/{uri_without_scheme} ตัวอย่าง: documents/docs.cloud.google.com/storage/docs/creating-buckets
id

string

เอาต์พุตเท่านั้น รหัสของข้อมูลนี้ภายในเอกสาร รหัสข้อมูลจะเฉพาะเจาะจงภายในเอกสาร แต่ไม่ซ้ำกันทั่วโลกในเอกสารต่างๆ รหัสข้อมูลไม่คงที่และอาจเปลี่ยนแปลงเมื่อเวลาผ่านไป
content

string

เอาต์พุตเท่านั้น เนื้อหาของข้อมูลเอกสาร

คำอธิบายประกอบของเครื่องมือ

ระบบจะส่งคำอธิบายประกอบของเครื่องมือไปยังไคลเอ็นต์ MCP เพื่ออธิบายความเสี่ยงพื้นฐานของเครื่องมือที่กำหนด ไคลเอ็นต์ส่วนใหญ่จะถือว่าคำแนะนำเหล่านี้ไม่น่าเชื่อถือ แต่สามารถใช้เพื่อตัดสินใจว่าจะส่งข้อความแจ้งการยืนยันไปยังผู้ใช้เมื่อใด

คำแนะนำแบบบูลีนต่อไปนี้ได้รับการกำหนดไว้ดังนี้ นอกเหนือจากสตริงชื่อ

  • readOnlyHint: หากเป็นจริง เครื่องมือจะไม่แก้ไขสภาพแวดล้อม ค่าเริ่มต้น: เท็จ
  • destructiveHint: หากเป็นจริง เครื่องมือจะดำเนินการที่อาจทำให้เกิดความเสียหายได้ หากเป็นเท็จ เครื่องมือจะดำเนินการที่เพิ่มข้อมูลเท่านั้น ค่าเริ่มต้น: จริง
  • idempotentHint: หากเป็นจริง การเรียกใช้เครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่มีผลเพิ่มเติมต่อสภาพแวดล้อม ค่าเริ่มต้น: เท็จ
  • openWorldHint: หากเป็นจริง เครื่องมือจะโต้ตอบกับ "โอเพนเวิลด์" ของเอนทิตีภายนอกได้ หากเป็นเท็จ เครื่องมือจะโต้ตอบกับเอนทิตีภายในเท่านั้น ตัวอย่างเช่น เครื่องมือค้นหาเว็บจะเป็นโอเพนเวิลด์ แต่เครื่องมือหน่วยความจำจะไม่เป็นโอเพนเวิลด์

คำแนะนำที่อาจทำให้เกิดความเสียหาย: ❌ | คำแนะนำที่อาจทำให้เกิดความเสียหายซ้ำ: ✅ | คำแนะนำแบบอ่านอย่างเดียว: ✅ | คำแนะนำแบบโลกเปิด: ❌