MCP Tools Reference: developerknowledge.googleapis.com

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

ใช้เครื่องมือนี้เพื่อดึงเนื้อหาทั้งหมดของเอกสารรายการเดียวหรือเอกสารสูงสุด 20 รายการในการเรียกใช้ครั้งเดียว ชื่อเอกสารควรได้มาจากช่อง parent ของผลลัพธ์จากการเรียกใช้เครื่องมือ search_documents หรือช่อง references ที่เครื่องมือ answer_query แสดงผล ตั้งค่าพารามิเตอร์ names เป็นรายการชื่อเอกสาร (documents/...) และอ้างอิงเอกสารแหล่งที่มาที่เชื่อถือได้ซึ่งใช้ในคำตอบสุดท้าย

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

สคีมาอินพุต

ขอสคีมาสำหรับ get_documents

GetDocumentsRequest

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

string

ต้องระบุ ชื่อของเอกสารที่จะดึงข้อมูลตามที่แสดงในช่อง parent ของผลลัพธ์ search_documents หรือช่อง references ของ answer_query คุณสามารถเรียกข้อมูลเอกสารได้สูงสุด 20 รายการในการเรียกใช้ 1 ครั้ง ระบบจะแสดงผลเอกสารตามลําดับเดียวกับ names ในคําขอ รูปแบบ: documents/{uri_without_scheme} ตัวอย่าง: documents/docs.cloud.google.com/storage/docs/creating-buckets

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

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

GetDocumentsResponse

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

object (Document)

เอกสารที่ขอ

เอกสาร

การแสดง JSON 
{
  "name": string,
  "uri": string,
  "content": string,
  "description": string,
  "title": string
}
ช่อง
name

string

ตัวระบุ ชื่อทรัพยากรของเอกสาร รูปแบบ: documents/{uri_without_scheme} ตัวอย่าง: documents/docs.cloud.google.com/storage/docs/creating-buckets
uri

string

เอาต์พุตเท่านั้น URI ของเนื้อหา เช่น https://cloud.google.com/storage/docs/creating-buckets
content

string

เอาต์พุตเท่านั้น เนื้อหาของเอกสารในรูปแบบมาร์กดาวน์
description

string

เอาต์พุตเท่านั้น คำอธิบายเอกสาร
title

string

เอาต์พุตเท่านั้น ชื่อเอกสาร

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

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

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

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

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