บันทึกและชุดข้อมูล

ในคู่มือนี้ คุณจะได้เรียนรู้วิธี ดูบันทึกจากการใช้งาน Gemini API ในแดชบอร์ด Google AI Studio เพื่อให้เข้าใจพฤติกรรมของโมเดลและวิธีที่ผู้ใช้อาจโต้ตอบกับแอปพลิเคชันของคุณได้ดียิ่งขึ้น ใช้การบันทึกเพื่อสังเกต แก้ไขข้อบกพร่อง และแชร์ความคิดเห็นเกี่ยวกับการใช้งานกับ Google (ไม่บังคับ) เพื่อช่วยปรับปรุง Gemini ในกรณีการใช้งานของนักพัฒนาซอฟต์แวร์*

ระบบรองรับการเรียก API ทั้งหมดของ GenerateContent, BatchGenerateContent, StreamGenerateContent และการเรียก API ของ Interactions ยกเว้น เอเจนต์ที่มีการจัดการ ซึ่งรวมถึงการโทรผ่านปลายทางความเข้ากันได้ของ OpenAI

*หมายเหตุ: พื้นที่เก็บข้อมูลสำหรับบันทึก Gemini API จะใช้ได้กับโปรเจ็กต์ใน ระดับการชำระเงินของ Gemini API เท่านั้น

กำหนดค่าการบันทึกของโปรเจ็กต์

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

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

การบันทึกระดับคำขอ

ลักษณะการทำงานของการจัดเก็บและการบันทึกจะแตกต่างกันไปตาม API ดังนี้

  • Interactions API: จัดเก็บคำขอโดยค่าเริ่มต้น (store=true) เพื่อลดความซับซ้อนในการจัดการสถานะฝั่งเซิร์ฟเวอร์
  • สร้าง Content API (generateContent): ไม่จัดเก็บคำขอโดยค่าเริ่มต้น (store=false)

วิธีตั้งค่าพร็อพเพอร์ตี้ store มีดังนี้

generateContent API

Python

from google import genai

client = genai.Client()

response = client.models.generate_content(
    model='gemini-3.5-flash',
    contents='Explain quantum entanglement in simple terms.',
    config={'store': False} # Set to True to enable logging of this request
)

print(response.text)

JavaScript

import { GoogleGenAI } from '@google/genai';

const client = new GoogleGenAI({});

const response = await client.models.generateContent({
    model: 'gemini-3.5-flash',
    contents: 'Explain quantum entanglement in simple terms.',
    config: {
        store: false // Set to true to enable logging of this request
    }
});

console.log(response.text);

Interactions API

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    model="gemini-3.5-flash",
    input="Explain quantum entanglement in simple terms.",
    store=True # Set to False to disable logging of this request
)

print(interaction.outputs[-1].text)

JavaScript

import { GoogleGenAI } from '@google/genai';

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    model: 'gemini-3.5-flash',
    input: 'Explain quantum entanglement in simple terms.',
    store: true // Set to false to disable logging of this request
});

console.log(interaction.outputs[interaction.outputs.length - 1].text);

ดูบันทึกของโปรเจ็กต์ใน AI Studio

  1. ไปที่หน้าบันทึกใน AI Studio
  2. เลือกโปรเจ็กต์จากเมนูแบบเลื่อนลง
  3. บันทึกจะปรากฏในตารางตามลำดับเวลาแบบย้อนหลังสำหรับ Interactions API หากมี
  4. หากต้องการดูบันทึกของโปรเจ็กต์สำหรับ Generate Content API ให้เปิดใช้ในแผงการตั้งค่าก่อน

คลิกรายการเพื่อดูตัวอย่างเพย์โหลด คุณสามารถ ตรวจสอบพรอมต์และคำตอบทั้งหมดจาก Gemini รวมถึงบริบทจาก รอบก่อนหน้าได้ สำหรับคำขอ Interactions API บันทึกจะรวมลิงก์โดยตรงไปยัง previous_interaction_id ด้วย

กำหนดค่าการเก็บรักษาพื้นที่เก็บข้อมูลของโปรเจ็กต์

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

สร้างและแชร์ชุดข้อมูล

คุณสามารถบันทึกบันทึกลงในชุดข้อมูลเพื่อจัดระเบียบและส่งออกได้อย่างมีประสิทธิภาพมากขึ้น

  • จากหน้าบันทึก ให้ค้นหาแถบตัวกรอง ที่ด้านบนเพื่อเลือกพร็อพเพอร์ตี้ที่จะกรอง
  • จากมุมมองที่กรองแล้ว ให้ใช้ช่องทําเครื่องหมายเพื่อเลือกบันทึกทั้งหมดหรือแต่ละรายการ
  • คลิกปุ่มสร้างชุดข้อมูลที่ปรากฏที่ด้านบนของรายการ
  • ตั้งชื่อและใส่คำอธิบาย (ไม่บังคับ) ให้กับชุดข้อมูลใหม่
  • คุณจะเห็นชุดข้อมูลที่เพิ่งสร้างพร้อมชุดบันทึกที่ดูแลจัดการ
  • ส่งออกชุดข้อมูลเพื่อวิเคราะห์เพิ่มเติมเป็นไฟล์ CSV, JSONL หรือไปยัง Google ชีต

ชุดข้อมูลอาจเป็นประโยชน์สำหรับ Use Case ที่แตกต่างกันจำนวนหนึ่ง

  • ดูแลชุดความท้าทาย: ขับเคลื่อนการปรับปรุงในอนาคตซึ่งมุ่งเน้นที่ด้านที่คุณต้องการให้ AI ปรับปรุง
  • ดูแลชุดตัวอย่าง: เช่น ตัวอย่างจากการใช้งานจริงเพื่อสร้างคำตอบจากโมเดลอื่น หรือรวบรวมกรณีที่ซับซ้อนสำหรับการตรวจสอบตามปกติก่อนการติดตั้งใช้งาน
  • ชุดการประเมิน: ชุดที่แสดงถึงการใช้งานจริงในความสามารถที่สำคัญ เพื่อใช้เปรียบเทียบกับโมเดลอื่นๆ หรือการทำซ้ำคำสั่งของระบบ

คุณสามารถมีส่วนร่วมในการวิจัยและพัฒนา Gemini ได้โดยเลือกแชร์ ชุดข้อมูลกับ Google เป็นตัวอย่างการสาธิต

ข้อจำกัด

ปัจจุบันระบบยังไม่รองรับการบันทึกสำหรับรายการต่อไปนี้

  • โมเดล Imagen และ Veo
  • โมเดลการฝัง Gemini
  • โมเดล Gemini Robotics
  • อินพุตที่มีวิดีโอ, GIF หรือ PDF
  • Agent เวอร์ชันตัวอย่างแบบสาธารณะใน Gemini API

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

  • สร้างต้นแบบด้วยประวัติเซสชัน: ใช้ AI Studio Build เพื่อสร้างแอปโค้ดและเพิ่มคีย์ API เพื่อเปิดใช้ประวัติบันทึก Gemini API สำหรับฟีเจอร์ AI
  • เรียกใช้บันทึกอีกครั้งด้วย Gemini Batch API: ใช้ชุดข้อมูลสำหรับการสุ่มตัวอย่างคำตอบ และการประเมินโมเดลหรือตรรกะของแอปพลิเคชันโดยการเรียกใช้บันทึกอีกครั้งด้วย Gemini Batch API