ชุดเครื่องมือการผสานรวม API และ Code Assist โดยใช้ MCP

รับข้อมูลอัจฉริยะตามบริบทเกี่ยวกับ Merchant API จากผู้ช่วยการเขียนโค้ดที่คุณเลือก ตอนนี้คุณสามารถเข้าถึงการผสานรวมเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ภายในสภาพแวดล้อมในการพัฒนาซอฟต์แวร์แบบรวม (IDE) ได้โดยใช้บริการ Model Context Protocol (MCP) บริการนี้จะเร่งการพัฒนาสำหรับการผสานรวมและเวิร์กโฟลว์การย้ายข้อมูล โดยการให้บริบทที่เชื่อถือได้จากเอกสารประกอบ API อย่างเป็นทางการของ Google แก่ผู้ช่วยการเขียนโค้ดของคุณ

ดูข้อมูลเพิ่มเติมเกี่ยวกับโปรโตคอลได้ที่มาตรฐานโปรโตคอลบริบทของโมเดล

ภาพรวม

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

บริการนี้ใช้แบ็กเอนด์ Retrieval-Augmented Generation (RAG) ที่มีความเชี่ยวชาญสูง เมื่อคุณถามคำถามผู้ช่วยการเขียนโค้ดใน IDE ที่เปิดใช้ MCP เกี่ยวกับ Merchant API บริการจะดึงข้อมูลข้อความและโค้ดที่เกี่ยวข้องมากที่สุดจากแหล่งข้อมูลอย่างเป็นทางการของ Google และส่งกลับมาเป็นบริบทให้ผู้ช่วยการเขียนโค้ด ซึ่งจะช่วยให้ผู้ช่วยให้คำตอบที่ถูกต้องและเป็นปัจจุบันได้โดยที่คุณไม่ต้องออกจากสภาพแวดล้อมการพัฒนาเลย

วิธีการทำงาน

การผสานรวมเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์โดยใช้ MCP จะผสานรวมเข้ากับเวิร์กโฟลว์การพัฒนาที่ทันสมัยซึ่งมี AI ช่วย ดังนี้

  1. คุณถามคำถามในผู้ช่วยเขียนโค้ดหรือเอเจนต์ที่เข้ากันได้กับ MCP ซึ่งอาจเป็นคำถามในภาษาธรรมชาติ คำขอโค้ดตัวอย่าง Merchant API หรือแม้แต่คำขอให้แปลโค้ดเป็น Merchant API โดยตรง
  2. ผู้ช่วยเขียนโค้ดจะส่งคำขอเพื่อขอข้อมูลบริบทไปยังปลายทาง MCP
  3. บริการ MCP จะค้นหาคอลเล็กชันเอกสารประกอบ คำแนะนำ และตัวอย่างโค้ดอย่างเป็นทางการของ Merchant API ที่จัดทำดัชนีไว้เพื่อค้นหาข้อมูลที่เกี่ยวข้องมากที่สุด
  4. บริการจะแสดงข้อมูลโค้ดที่เชื่อถือได้เหล่านี้เป็นบริบทให้กับผู้ช่วยการเขียนโค้ด
  5. ผู้ช่วยเขียนโค้ดจะใช้บริบทคุณภาพสูงนี้เพื่อสร้างคำตอบที่แม่นยำ และเป็นประโยชน์สำหรับคำถามเดิมของคุณ หรือเพื่อทำงานแปลโค้ด

เริ่มต้นใช้งาน

หากต้องการใช้ MCP ให้ทำตามขั้นตอนต่อไปนี้

1. ใช้เครื่องมือที่เข้ากันได้

เปิด IDE หรือผู้ช่วยการเขียนโค้ดที่รองรับ Model Context Protocol ด้วย การรับส่ง HTTP ที่สตรีมได้

2. การกำหนดค่าอุปกรณ์ปลายทาง

หากต้องการเชื่อมต่อ IDE หรือผู้ช่วยเขียนโค้ดกับ MCP ให้ใช้รายละเอียดของอุปกรณ์ปลายทางระยะไกลที่ระบุไว้ ซึ่งอาจกำหนดให้คุณป้อน URL ของบริการโดยตรงหรือคำจำกัดความของ MCP (ขึ้นอยู่กับการกำหนดค่าของเครื่องมือ)

URL ของบริการคือ

MCP Server Name: "MAPI Docs MCP"
MCP Server URL:  "https://merchantapi.googleapis.com/devdocs/mcp/"
MCP Server Protocol: "http"

3. เพิ่มคำสั่งสำหรับตัวแทน (ไม่บังคับ)

หากต้องการให้เอเจนต์แปลโค้ดโดยตรงโดยใช้ MCP ให้ระบุคำสั่งของระบบ: MerchantIntegrator Agent Protocol คำสั่งเหล่านี้จะแนะนำเอเจนต์เกี่ยวกับวิธีใช้ MCP อย่างถูกต้องสำหรับการแปลโค้ด คุณสามารถระบุวิธีการเหล่านี้ได้ทั้งในการกำหนดค่าวิธีการของระบบหรือเป็นไฟล์บริบทเพิ่มเติมสำหรับเอเจนต์ ทั้งนี้ขึ้นอยู่กับเครื่องมือที่คุณใช้

ตัวอย่างสถานการณ์การใช้งาน

MCP ช่วยเร่งเวิร์กโฟลว์ของคุณใน Use Case ทั่วไปเหล่านี้ได้

สถานการณ์ที่ 1: ย้ายข้อมูลโค้ด products.insert

คุณสามารถขอให้ตัวแทนย้ายข้อมูลโค้ดการผสานรวม Content API for Shopping products.insert ไปยัง Merchant API โดยตรงได้

พรอมต์ของผู้ใช้:

"ย้ายข้อมูลโค้ด products.insert ไปยัง Merchant API"

การระบุคำสั่งของระบบ: MerchantIntegrator Agent Protocol และสิทธิ์เข้าถึง MCP ให้กับเอเจนต์จะช่วยให้เอเจนต์แปลโค้ด Content API for Shopping เป็นโค้ด Merchant API ได้โดยตรงใน IDE ในกรณีนี้ ระบบจะระบุ productInputs.insert เป็นการเรียกที่เทียบเท่าและแมปแอตทริบิวต์ผลิตภัณฑ์ จากรูปแบบเก่าไปยังรูปแบบใหม่ที่ Merchant API กำหนด นอกจากนี้ยังอัปเดตการนำเข้าที่จำเป็นและไฟล์การจัดการการขึ้นต่อกันได้ด้วย (เช่น requirements.txt, pom.xml หรือ package.json) คุณสามารถสั่งให้เอเจนต์ทำการเปลี่ยนแปลงในตำแหน่งเดิมหรือสร้างโฟลเดอร์ใหม่ได้

สถานการณ์ที่ 2: ค้นหาฟังก์ชันการทำงานที่เทียบเท่า

คุณมีแอปพลิเคชันที่ใช้ Content API for Shopping อยู่แล้วและต้องการอัปเดต คุณสามารถสอบถามเกี่ยวกับวิธีการเดิมที่เฉพาะเจาะจงเพื่อดูรายละเอียดเกี่ยวกับการติดตั้งใช้งานใหม่ และตัวอย่างโค้ดที่เกี่ยวข้อง

พรอมต์ของผู้ใช้:

"Merchant API ที่เทียบเท่ากับเมธอด accountstatuses.get ใน Content API for Shopping คืออะไร"

บริการ MCP จะให้บริบทจากคำแนะนำในการย้ายข้อมูลอย่างเป็นทางการและ เอกสารอ้างอิง เพื่อให้ผู้ช่วยตอบคำถามของคุณได้อย่างละเอียด รวมถึงชื่อ API ใหม่ accounts.issues

สถานการณ์ที่ 3: การค้นหาโค้ดตัวอย่าง

คุณกำลังติดตั้งใช้งานฟีเจอร์ใหม่และต้องการตัวอย่างที่นำไปใช้ได้จริงเพื่อทำตาม

พรอมต์ของผู้ใช้:

"ขอดูตัวอย่างโค้ด Python สำหรับการเพิ่มบริการจัดส่งใหม่โดยใช้ Merchant API"

บริการ MCP จะดึงตัวอย่างโค้ดที่เกี่ยวข้องจากที่เก็บ GitHub อย่างเป็นทางการของ Google และคำแนะนำสำหรับนักพัฒนาแอป จากนั้น Assistant จะแสดงบล็อกโค้ดที่สมบูรณ์ พร้อมปรับ

สถานการณ์ที่ 4: ทำความเข้าใจแนวคิดเกี่ยวกับ API

คุณพบแนวคิดใหม่หรือต้องการทำความเข้าใจโครงสร้างของทรัพยากรหรือรูปแบบ Merchant API โดยรวม

พรอมต์ของผู้ใช้:

"ฉันจะอัปเดตสินค้าคงคลังของผลิตภัณฑ์โดยใช้ Merchant API ได้อย่างไร"

บริการ MCP จะแสดงบริบทจากเอกสารประกอบของทรัพยากรผลิตภัณฑ์และ คำแนะนำที่เกี่ยวข้อง จากนั้นผู้ช่วยจะอธิบายวิธีใช้ accounts.productInputs.insert และระบุแหล่งข้อมูลผลิตภัณฑ์บางส่วน ซึ่งมีเฉพาะ productId และช่องที่เกี่ยวข้องกับสินค้าคงคลังที่คุณต้อง อัปเดต

"ฉันจะให้สิทธิ์การเรียกแอปพลิเคชันด้วย Merchant API ได้อย่างไร"

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

สถานการณ์ที่ 5: การปรับตัวให้เข้ากับการเปลี่ยนแปลงของ API

Merchant API มีรูปแบบใหม่ เช่น คำขอแบบเป็นกลุ่ม ซึ่งแตกต่างจาก Content API for Shopping Content API for Shopping ใช้ custombatchเมธอดที่เฉพาะเจาะจง ขณะที่ Merchant API ใช้ฟีเจอร์การประมวลผลแบบกลุ่ม HTTP ทั่วไปในตัว

พรอมต์ของผู้ใช้:

"วิธีใหม่ในการใช้ products.custombatch ใน Merchant API คืออะไร"

บริการ MCP จะดึงบริบทจากปรับโครงสร้างโค้ดสำหรับคำขอพร้อมกัน ซึ่งอธิบายว่าไม่มีcustombatchเมธอดเฉพาะใน Merchant API แต่จะให้เอกสารประกอบเกี่ยวกับการใช้การจัดกลุ่ม HTTP กับ Content-Type ของ multipart แทน จากนั้นผู้ช่วยจะอธิบายวิธีสร้างคำขอ HTTP รายการเดียวที่มีการเรียก API หลายรายการ ซึ่งส่งไปยังปลายทาง https://merchantapi.googleapis.com/batch/{sub-api}/v1 และแสดงตัวอย่างวิธีจัดโครงสร้างคำขอแบบหลายส่วน ซึ่งจะเปลี่ยนงานการย้ายข้อมูลที่อาจสร้างความสับสนให้เป็นกระบวนการที่มีคำแนะนำ

สถานการณ์ที่ 6: แปลคำค้นหาการรายงาน

คุณขอให้ตัวแทนแปลคำค้นหาการรายงานจาก Content API for Shopping เป็น Merchant API ได้

พรอมต์ของผู้ใช้:

"ย้ายข้อมูลการค้นหารายงานนี้จาก Content API ไปยัง Merchant API: SELECT metrics.impressions, metrics.clicks, metrics.ctr FROM MerchantPerformanceView WHERE segments.date BETWEEN '2020-12-01' AND '2020-12-30'"

บริการ MCP จะดึงเอกสารอ้างอิงการรายงานล่าสุด คู่มือนักพัฒนาซอฟต์แวร์ และคู่มือการย้ายข้อมูล โดยจะแปลงคำค้นหาเป็นโครงสร้างใหม่และอัปเดตช่องเป็นชื่อและค่าใหม่ตามข้อมูลนี้

แหล่งที่มาของฐานความรู้

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

ก่อนหน้า
Design
ถัดไป
Overview