Nhật ký và tập dữ liệu

Trong hướng dẫn này, bạn sẽ tìm hiểu cách xem nhật ký về việc sử dụng Gemini API trong trang tổng quan Google AI Studio để hiểu rõ hơn về hành vi của mô hình và cách người dùng có thể tương tác với các ứng dụng của bạn. Sử dụng tính năng ghi nhật ký để quan sát, gỡ lỗi và tuỳ ý chia sẻ ý kiến phản hồi về việc sử dụng với Google để giúp cải thiện Gemini trong các trường hợp sử dụng của nhà phát triển.^*

Tất cả các lệnh gọi API GenerateContent, BatchGenerateContent, StreamGenerateContent và lệnh gọi API Tương tác (ngoại trừ các lệnh gọi API Managed Agents) đều được hỗ trợ. Điều này bao gồm cả các lệnh gọi được thực hiện thông qua các điểm cuối khả năng tương thích với OpenAI.

*Lưu ý: Bộ nhớ cho nhật ký Gemini API chỉ được cung cấp cho các dự án thuộc bậc có tính phí của Gemini API.

Định cấu hình tính năng ghi nhật ký dự án

Theo mặc định, API sẽ lưu trữ tất cả các đối tượng tương tác (store=true) để đơn giản hoá việc sử dụng các tính năng quản lý trạng thái phía máy chủ. Ngược lại, Generate Content API không lưu trữ các yêu cầu theo mặc định và yêu cầu phải bật tính năng lưu trữ cho mỗi yêu cầu hoặc ở cấp dự án trong AI Studio.

Trong AI Studio của Google, bạn có thể bật hoặc tắt tính năng ghi nhật ký cho tất cả dự án hoặc cho các dự án cụ thể, đồng thời thay đổi các lựa chọn ưu tiên này bất cứ lúc nào thông qua bảng Cài đặt trên trang Nhật ký và tập dữ liệu. Bạn có thể bật hoặc tắt tính năng ghi nhật ký một cách độc lập cho API generateContent và API Tương tác để thay đổi hành vi lưu trữ mặc định cho một dự án.

Ghi nhật ký ở cấp yêu cầu

Hành vi lưu trữ và ghi nhật ký sẽ khác nhau tuỳ theo API:

• Interactions API: Lưu trữ các yêu cầu theo mặc định (store=true) để đơn giản hoá việc quản lý trạng thái phía máy chủ.
• Tạo Content API (generateContent): Không lưu trữ các yêu cầu theo mặc định (store=false).

Sau đây là cách bạn có thể đặt thuộc tính store:

generateContent API

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)

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

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)

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);

Xem nhật ký dự án trong AI Studio

1. Chuyển đến trang Nhật ký trong AI Studio.
2. Chọn một dự án trong trình đơn thả xuống.
3. Nhật ký sẽ xuất hiện trong bảng theo thứ tự thời gian đảo ngược cho Interactions API (nếu có).
4. Để quan sát nhật ký dự án cho Generate Content API, trước tiên, hãy bật nhật ký này trong bảng điều khiển cài đặt.

Nhấp vào một mục để xem trước tải trọng. Bạn có thể kiểm tra toàn bộ câu lệnh và câu trả lời của Gemini, cũng như ngữ cảnh của các lượt trò chuyện trước. Đối với các yêu cầu Interactions API, nhật ký cũng bao gồm một đường liên kết trực tiếp đến previous_interaction_id.

Định cấu hình chế độ lưu giữ dữ liệu lưu trữ của dự án

Nhật ký sẽ hết hạn và được đánh dấu để xoá sau khoảng thời gian lưu giữ mặc định là 55 ngày (trừ phi được lưu vào một tập dữ liệu, nhật ký sẽ không hết hạn). Bạn có thể định cấu hình khoảng thời gian lưu giữ nhật ký của một dự án tối đa là 7, 14, 28 hoặc 55 ngày.

Tạo và chia sẻ tập dữ liệu

Bạn có thể lưu nhật ký vào các tập dữ liệu để sắp xếp và xuất nhật ký một cách hiệu quả hơn.

• Trên trang Nhật ký, hãy tìm thanh bộ lọc ở trên cùng để chọn một thuộc tính cần lọc.
• Trong chế độ xem đã lọc, hãy dùng hộp đánh dấu để chọn tất cả hoặc từng nhật ký.
• Nhấp vào nút Tạo tập dữ liệu xuất hiện ở đầu danh sách.
• Đặt tên và thêm nội dung mô tả (không bắt buộc) cho tập dữ liệu mới.
• Bạn sẽ thấy tập dữ liệu mà bạn vừa tạo cùng với tập hợp nhật ký được tuyển chọn.
• Xuất tập dữ liệu để phân tích thêm dưới dạng tệp CSV, JSONL hoặc sang Google Trang tính.

Tập dữ liệu có thể hữu ích cho một số trường hợp sử dụng.

• Tuyển chọn các bộ thử thách: Thúc đẩy những điểm cải tiến trong tương lai nhắm đến những lĩnh vực mà bạn muốn AI cải thiện.
• Tuyển chọn các bộ dữ liệu mẫu: Ví dụ: một mẫu từ việc sử dụng thực tế để tạo phản hồi từ một mô hình khác hoặc một tập hợp các trường hợp đặc biệt để kiểm tra định kỳ trước khi triển khai.
• Tập hợp đánh giá: Tập hợp đại diện cho mức sử dụng thực tế trên các chức năng quan trọng, để so sánh giữa các mô hình hoặc các lần lặp lại hướng dẫn hệ thống khác.

Bạn có thể đóng góp cho hoạt động nghiên cứu và phát triển của Gemini bằng cách chọn chia sẻ tập dữ liệu của mình với Google dưới dạng ví dụ minh hoạ.

Các điểm hạn chế

Tính năng ghi nhật ký hiện không được hỗ trợ cho những trường hợp sau:

• Các mô hình Imagen và Veo
• Các mô hình nhúng của Gemini
• Mô hình Gemini Robotics
• Đầu vào chứa video, ảnh GIF hoặc tệp PDF
• Các tác nhân trong Bản dùng thử công khai của Gemini API

Bước tiếp theo

• Tạo mẫu bằng nhật ký phiên: Sử dụng AI Studio Build để tạo ứng dụng mã và thêm khoá API để bật nhật ký Gemini API cho các tính năng AI.
• Chạy lại nhật ký bằng Gemini Batch API: Sử dụng các tập dữ liệu để lấy mẫu phản hồi và đánh giá các mô hình hoặc logic ứng dụng bằng cách chạy lại nhật ký bằng Gemini Batch API.