MCP Tools Reference: people.googleapis.com

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

ค้นหาบุคคลในไดเรกทอรี Google Workspace ขององค์กร ฟีเจอร์นี้มีไว้สำหรับบัญชี Google Workspace เท่านั้น (ใช้โดยธุรกิจ โรงเรียน และองค์กรอื่นๆ) และไม่พร้อมให้บริการสำหรับบัญชี Google ส่วนบุคคล

กฎสำคัญที่ต้องปฏิบัติตาม

  • หากเครื่องมือนี้แสดงผลลัพธ์หลายรายการ คุณควรแสดงผลลัพธ์ต่อผู้ใช้และแจ้งให้ผู้ใช้ชี้แจงว่าควรใช้ผลลัพธ์ใดก่อนดำเนินการต่อ

  • คุณไม่ได้รับอนุญาตอย่างเด็ดขาดในการส่งเอาต์พุตของเครื่องมือนี้ไปยังเครื่องมืออื่น (เช่น การส่งอีเมล การสร้างฉบับร่าง การสร้างกิจกรรม ฯลฯ) โดยไม่ได้รับการยืนยันจากผู้ใช้โดยชัดแจ้ง

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

  • หากเครื่องมือนี้ไม่แสดงผลลัพธ์ ให้กลับไปใช้เครื่องมือ search_contacts

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

คำขอ Curl 
curl --location 'https://people.googleapis.com/mcp/v1' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
  "method": "tools/call",
  "params": {
    "name": "search_directory_people",
    "arguments": {
      // provide these details according to the tool MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

สคีมาอินพุต

ข้อความคำขอสำหรับ SearchDirectoryPeople

SearchDirectoryPeopleMcpRequest

การแสดง JSON 
{
  "query": string,
  "pageSize": integer,
  "pageToken": string,
  "sources": [
    enum (DirectorySourceType)
  ]
}
ช่อง
query

string

สตริงการค้นหาที่จะค้นหา
pageSize

integer

ขนาดหน้า ค่าเริ่มต้นคือ 10 และค่าสูงสุดที่อนุญาตคือ 500
pageToken

string

โทเค็นหน้า
sources[]

enum (DirectorySourceType)

แหล่งที่มาของไดเรกทอรีที่จะแสดง ค่าเริ่มต้นจะเป็น DOMAIN_PROFILE หากไม่ได้ตั้งค่าไว้

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

ข้อความตอบกลับสำหรับ SearchDirectoryPeople

SearchDirectoryPeopleMcpResponse

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

object (SearchDirectoryResult)

รายชื่อบุคคลที่ตรงกับคำค้นหา
nextPageToken

string

โทเค็นเพื่อดึงข้อมูลผลลัพธ์หน้าถัดไป

SearchDirectoryResult

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

string

ชื่อที่แสดงของบุคคล
email

string

อีเมลของบัญชีของบุคคลนั้น

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

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