MCP Tools Reference: developerknowledge.googleapis.com

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

ใช้เครื่องมือนี้เพื่อค้นหาเอกสารประกอบเกี่ยวกับผลิตภัณฑ์สำหรับ Google Developers เอกสารประกอบเหล่านี้ประกอบด้วย 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

  • Genkit: genkit.dev

  • 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

  • Google Workspace: knowledge.workspace.google.com

  • TensorFlow: www.tensorflow.org

  • เว็บ: web.dev

เครื่องมือนี้จะแสดงผลกลุ่มข้อความ ชื่อ และ URI สำหรับเอกสารที่ตรงกัน ใช้ search_documents ตามด้วย get_documents เมื่อต้องการตัวอย่างโค้ดที่ถูกต้อง, แฟล็ก CLI, ข้อความแสดงข้อผิดพลาดที่เฉพาะเจาะจง, คำแนะนำแบบทีละขั้นตอนของบทแนะนำแบบเต็ม หรือการค้นหาคีย์เวิร์ดเชิงกำหนด หากกลุ่มข้อมูลที่แสดงผลไม่มีรายละเอียดเพียงพอที่จะตอบคำถามของผู้ใช้ ให้ใช้ get_documents กับ parent จากเอาต์พุตของเครื่องมือนี้เพื่อดึงเนื้อหาเอกสารทั้งหมด เมื่อตอบผู้ใช้ ให้อ้างอิงชื่อทรัพยากรเอกสารแหล่งข้อมูลที่เชื่อถือได้ (documents/...) หรือ URI เสมอ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ curl เพื่อเรียกใช้เครื่องมือ MCP search_documents

คำขอ 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 MCP tool specification.
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

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

SearchDocumentChunksRequest

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

string

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

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

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

SearchDocumentChunksResponse

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

object (DocumentChunk)

ผลการค้นหาสำหรับคำค้นหาที่ระบุ DocumentChunk แต่ละรายการในรายการนี้มีตัวอย่างเนื้อหาที่เกี่ยวข้องกับคำค้นหา ใช้ช่อง DocumentChunk.parent ของผลลัพธ์แต่ละรายการกับ 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: หากเป็นจริง เครื่องมือจะไม่แก้ไขสภาพแวดล้อมของตนเอง ค่าเริ่มต้น: false
  • destructiveHint: หากเป็น "จริง" เครื่องมือจะดำเนินการที่ทำลายล้างได้ หากเป็นเท็จ เครื่องมือจะดำเนินการได้เฉพาะการดำเนินการแบบเพิ่มเท่านั้น ค่าเริ่มต้น: true
  • idempotentHint: หากเป็นจริง การเรียกใช้เครื่องมือซ้ำๆ ด้วยอาร์กิวเมนต์เดียวกันจะไม่มีผลเพิ่มเติมต่อสภาพแวดล้อม ค่าเริ่มต้น: false
  • openWorldHint: หากเป็นจริง เครื่องมือจะโต้ตอบกับเอนทิตีภายนอกแบบ "โอเพนเวิลด์" ได้ หากเป็นเท็จ เครื่องมือจะโต้ตอบได้เฉพาะกับเอนทิตีภายในเท่านั้น ตัวอย่างเช่น เครื่องมือค้นเว็บจะเป็นแบบโอเพนเวิลด์ ส่วนเครื่องมือความจำจะไม่ใช่แบบโอเพนเวิลด์

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