Interactions API

Interactions API เป็นวิธีที่ง่ายที่สุดและดีที่สุดในการสร้างสรรค์ด้วยโมเดลและ Agent ของ Gemini โดยจะเปิดให้ใช้งานโดยทั่วไปและแนะนำสำหรับโปรเจ็กต์ใหม่ทั้งหมดตั้งแต่เดือนมิถุนายน 2026 เป็นต้นไป แม้ว่าตอนนี้จะถือเป็น API รุ่นเก่าแล้ว แต่ generateContent API เดิมยังคงได้รับการสนับสนุนอย่างเต็มที่

เหตุใดจึงต้องใช้ Interactions API

  • อินเทอร์เฟซสากลสำหรับแอปพลิเคชันทั้งหมด: ออกแบบมาให้เป็นอินเทอร์เฟซมาตรฐานสำหรับทุก Use Case รวมถึงการสร้างข้อความแบบครั้งเดียว การทำความเข้าใจแบบมัลติโมดัล เอาต์พุตที่มีโครงสร้าง การจัดระเบียบเครื่องมือ และเวิร์กโฟลว์แบบ Agent
  • API เดียวสำหรับโมเดลและ Agent: ปลายทางและรูปแบบที่รวมเป็นหนึ่งเดียวสำหรับการเรียกโมเดล Gemini มาตรฐาน รวมถึง Agent เฉพาะทาง (เช่น Deep Research และ Agent ที่มีการจัดการที่กำหนดเอง) โดยตรง
  • ความสามารถใหม่ๆ ที่พร้อมใช้งาน: ฟีเจอร์ต่างๆ เช่น สถานะการสนทนาฝั่งเซิร์ฟเวอร์ที่ไม่บังคับโดยใช้ previous_interaction_id ขั้นตอนการดำเนินการที่สังเกตได้สำหรับการแก้ไขข้อบกพร่องและการแสดงผล UI และ การดำเนินการเบื้องหลัง สำหรับงานที่ใช้เวลานานโดยใช้ background=true
  • ค่าใช้จ่ายที่ต่ำลงด้วยอัตราการเข้าถึงแคชที่สูงขึ้น: เมื่อใช้การสนทนาหลายรอบ การจัดการสถานะฝั่งเซิร์ฟเวอร์ที่ไม่บังคับจะช่วยให้การแคชบริบทมีประสิทธิภาพมากขึ้นในแต่ละรอบ ซึ่งช่วยลดค่าใช้จ่ายโทเค็น
  • ตำแหน่งที่จะเปิดตัวฟีเจอร์ใหม่: ในอนาคต โมเดลใหม่ทั้งหมด ความสามารถแบบมัลติโมดัล เครื่องมือ และฟีเจอร์แบบ Agent จะเปิดตัวใน Interactions API

โดยค่าเริ่มต้น Interactions API จะจัดเก็บคำขอเพื่อให้คุณใช้ประโยชน์จากฟีเจอร์การจัดการสถานะฝั่งเซิร์ฟเวอร์ได้โดยใช้ previous_interaction_id คุณเลือกใช้ลักษณะการทำงานแบบไม่เก็บสถานะได้โดยตั้งค่า store=false ดูรายละเอียดได้ในส่วนการเก็บรักษาข้อมูล

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

  • ตั้งค่า Agent การเขียนโค้ด: เชื่อมต่อกับ Gemini Docs MCP และติดตั้ง ทักษะ gemini-interactions-api เพื่อให้ Assistant เข้าถึง เอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์และแนวทางปฏิบัติแนะนำล่าสุดได้โดยตรง ตั้งค่า Agent การเขียนโค้ด →
  • ย้ายข้อมูลจาก generateContent: หากมีการผสานรวมอยู่แล้ว ให้ทำตามคู่มือการย้ายข้อมูลเพื่อ เปลี่ยนไปใช้ Interactions API
  • เริ่มต้นใช้งาน: เริ่มต้นใช้งานในคู่มือเริ่มต้นใช้งาน Interactions API

คำแนะนำฟีเจอร์

สำรวจความสามารถเฉพาะของ Interactions API ผ่านคำแนะนำเหล่านี้ คุณสามารถใช้ปุ่มเปิด/ปิดในหน้าเว็บเหล่านี้เพื่อสลับระหว่าง generateContent กับ Interactions API ได้

วิธีการทำงานของ Interactions API

Interactions API มุ่งเน้นไปที่ทรัพยากรหลักอย่าง Interaction Interaction แสดงถึงรอบการสนทนาหรือรอบการทำงานที่สมบูรณ์ โดยทำหน้าที่เป็นบันทึกเซสชันที่มีประวัติทั้งหมดของการโต้ตอบเป็นลำดับขั้นตอนการดำเนินการ ตามลำดับเวลา ขั้นตอนเหล่านี้รวมถึงความคิดของโมเดล การเรียกเครื่องมือฝั่งเซิร์ฟเวอร์หรือฝั่งไคลเอ็นต์และผลลัพธ์ (เช่น function_call และ function_result) และ model_output สุดท้าย ทรัพยากรที่จัดเก็บไว้ (ดึงข้อมูลผ่าน interactions.get) ยังรวมถึงขั้นตอน user_input สำหรับบริบททั้งหมดด้วย แม้ว่าการตอบกลับ interactions.create จะแสดงเฉพาะขั้นตอนที่โมเดลสร้างขึ้น

เมื่อเรียกใช้ interactions.create คุณกำลัง สร้างทรัพยากร Interaction ใหม่

การจัดการสถานะฝั่งเซิร์ฟเวอร์

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

พารามิเตอร์ previous_interaction_id จะเก็บเฉพาะประวัติการสนทนา (อินพุตและเอาต์พุต) โดยใช้ previous_interaction_id ส่วนพารามิเตอร์อื่นๆ จะมีขอบเขตการโต้ตอบ และใช้ได้กับการโต้ตอบเฉพาะที่คุณกำลังสร้างเท่านั้น ดังนี้

  • tools
  • system_instruction
  • generation_config (รวมถึง thinking_level, temperature และอื่นๆ)

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

การจัดเก็บและการเก็บรักษาข้อมูล

โดยค่าเริ่มต้น API จะจัดเก็บออบเจ็กต์ Interaction ทั้งหมด (store=true) เพื่อ ลดความซับซ้อนในการใช้ฟีเจอร์การจัดการสถานะฝั่งเซิร์ฟเวอร์ (ด้วย previous_interaction_id) การดำเนินการเบื้องหลัง (โดยใช้ background=true) และ วัตถุประสงค์ในการสังเกต

  • ระดับแบบชำระเงิน: ระบบจะเก็บรักษาการโต้ตอบไว้เป็นเวลา 55 วัน
  • ระดับฟรี: ระบบจะเก็บรักษาการโต้ตอบไว้เป็นเวลา 1 วัน

หากไม่ต้องการให้เป็นเช่นนี้ คุณสามารถตั้งค่า store=false ในคำขอได้ การควบคุมนี้แยกจากการจัดการสถานะ คุณเลือกไม่จัดเก็บการโต้ตอบใดก็ได้ อย่างไรก็ตาม โปรดทราบว่า store=false ไม่เข้ากันกับ การดำเนินการเบื้องหลัง และป้องกันไม่ให้ใช้ previous_interaction_id สำหรับรอบถัดไป

สำหรับโปรเจ็กต์ระดับแบบชำระเงิน คุณสามารถกำหนดค่าหน้าต่างการเก็บรักษาใน AI Studio เพื่อทำเครื่องหมายบันทึกสำหรับการ ลบออกจากพื้นที่เก็บข้อมูลของโปรเจ็กต์โดยอัตโนมัติหลังจากผ่านไป 7, 14, 28 หรือ 55 วัน การเก็บรักษาที่สั้นลงอาจส่งผลต่อการดึงข้อมูลการสนทนาที่ผ่านมา

คุณสามารถลบการโต้ตอบที่จัดเก็บไว้ได้ทุกเมื่อโดยใช้เมธอด delete ผ่านโปรแกรม ซึ่ง ต้องใช้รหัสการโต้ตอบ นอกจากนี้ คุณยังดูและจัดการบันทึกการโต้ตอบที่จัดเก็บไว้ รวมถึงการลบออกจากพื้นที่เก็บข้อมูลของโปรเจ็กต์ได้ใน AI Studio

หลังจากระยะเวลาการเก็บรักษาหมดลง ระบบจะลบข้อมูลของคุณโดยอัตโนมัติ

ระบบจะประมวลผลออบเจ็กต์ Interactions ตาม ข้อกำหนด

ดูการโต้ตอบใน AI Studio

API จะจัดเก็บคำขอ Interactions API ที่ดำเนินการด้วย store=true สำหรับโปรเจ็กต์ในระดับแบบชำระเงิน คุณสามารถดูคำขอเหล่านี้ได้โดยตรงจากหน้า บันทึกใน Google AI Studio ดูข้อมูลเพิ่มเติมได้ในคู่มือ บันทึก

แนวทางปฏิบัติแนะนำ

  • อัตราการเข้าถึงแคช: ระบบรองรับการแคชโดยนัยทั้งในโหมดเก็บสถานะและ ไม่เก็บสถานะ (ดู คู่มือเริ่มต้นใช้งานฉบับย่อ) การใช้ previous_interaction_id (เก็บสถานะ) เพื่อสนทนาต่อช่วยให้ระบบใช้การแคชโดยนัยสำหรับประวัติการสนทนาได้ง่ายขึ้น ซึ่งช่วยปรับปรุงประสิทธิภาพและลดค่าใช้จ่าย
  • การผสมการโต้ตอบ: คุณสามารถผสมและจับคู่การโต้ตอบของ Agent และ โมเดลในการสนทนาได้ตามต้องการ ตัวอย่างเช่น คุณสามารถใช้ Agent เฉพาะทาง เช่น Deep Research Agent สำหรับการเก็บรวบรวมข้อมูลเบื้องต้น แล้วใช้โมเดล Gemini มาตรฐานสำหรับงานติดตามผล เช่น การสรุปหรือการจัดรูปแบบใหม่ โดยลิงก์ขั้นตอนเหล่านี้ด้วย previous_interaction_id

โมเดลและ Agent ที่รองรับ

ชื่อโมเดล ประเภท รหัสโมเดล
Gemini 3.5 Flash โมเดล gemini-3.5-flash
Gemini 3.1 Pro (เวอร์ชันตัวอย่าง) โมเดล gemini-3.1-pro-preview
Gemini 3.1 Flash-Lite โมเดล gemini-3.1-flash-lite
Gemini 3 Flash (เวอร์ชันตัวอย่าง) โมเดล gemini-3-flash-preview
Gemini 2.5 Pro โมเดล gemini-2.5-pro
Gemini 2.5 Flash โมเดล gemini-2.5-flash
Gemini 2.5 Flash-lite โมเดล gemini-2.5-flash-lite
Gemini 3 Pro Image โมเดล gemini-3-pro-image
Gemini 3.1 Flash Image โมเดล gemini-3.1-flash-image
Gemini 3.1 Flash TTS (เวอร์ชันตัวอย่าง) โมเดล gemini-3.1-flash-tts-preview
Gemma 4 31B IT โมเดล gemma-4-31b-it
Gemma 4 26B MoE IT โมเดล gemma-4-26b-a4b-it
Lyria 3 Clip (เวอร์ชันตัวอย่าง) โมเดล lyria-3-clip-preview
Lyria 3 Pro (เวอร์ชันตัวอย่าง) โมเดล lyria-3-pro-preview
Deep Research (เวอร์ชันตัวอย่าง) Agent deep-research-preview-04-2026
Deep Research (เวอร์ชันตัวอย่าง) Agent deep-research-max-preview-04-2026
Antigravity (เวอร์ชันตัวอย่าง) Agent antigravity-preview-05-2026

SDK

คุณสามารถใช้ Google GenAI SDK เวอร์ชันล่าสุดเพื่อเข้าถึง Interactions API ได้

  • ใน Python จะเป็นแพ็กเกจ google-genai เวอร์ชัน 2.3.0 ขึ้นไป
  • ใน JavaScript จะเป็นแพ็กเกจ @google/genai เวอร์ชัน 2.3.0 ขึ้นไป

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีติดตั้ง SDK ได้ในหน้า ไลบรารี

ข้อจำกัด

  • MCP ระยะไกล: Gemini 3 ไม่รองรับ MCP ระยะไกล ซึ่งจะพร้อมใช้งานเร็วๆ นี้
  • ความเข้ากันได้ของโมเดลหลายรอบ: เมื่อใช้โมเดลต่างๆ ในการสนทนา (ทั้งแบบเก็บสถานะและไม่เก็บสถานะ) โมเดลถัดไปต้องรองรับรูปแบบเอาต์พุตของโมเดลก่อนหน้าเป็นอินพุต ตัวอย่างเช่น หากคุณสร้างรูปภาพโดยใช้ gemini-3.1-flash-image คุณจะไม่สามารถสนทนาต่อด้วยโมเดลที่ไม่รับอินพุตรูปภาพ (เช่น โมเดลข้อความเท่านั้นหรือโมเดลการสร้างเพลงอย่าง Lyria)

API generateContent รองรับฟีเจอร์ต่อไปนี้ แต่ ยังไม่พร้อมใช้งาน ใน Interactions API

ความคิดเห็น

ความคิดเห็นของคุณมีความสำคัญอย่างยิ่งต่อการพัฒนา Interactions API โปรดแชร์ความคิดเห็น รายงานข้อบกพร่อง หรือขอฟีเจอร์ใน ฟอรัมชุมชนนักพัฒนาแอป Google AI

ขั้นตอนถัดไป