Hướng dẫn nhanh về tác nhân được quản lý

Hướng dẫn này sẽ hướng dẫn bạn cách tạo và sử dụng Tác nhân được quản lý trên Gemini API bằng tác nhân Antigravity. Bạn sẽ thực hiện cuộc gọi đầu tiên cho trợ lý, tiếp tục cuộc trò chuyện nhiều lượt, truyền trực tuyến phản hồi, tải tệp xuống từ hộp cát và làm việc với trợ lý được quản lý Antigravity.

Chạy lượt tương tác đầu tiên với trợ lý ảo

Một lệnh gọi duy nhất đến Interactions API sẽ cung cấp một hộp cát Linux, chạy vòng lặp tác nhân và trả về kết quả. Bạn sẽ xác định 3 tham số:

  • Truyền agent dưới dạng "antigravity-preview-05-2026",. Đây là phiên bản hiện tại của tác nhân được quản lý đa năng và xác định trước của chúng tôi.
  • Xác định environment="remote" để cung cấp một môi trường hộp cát mới và sạch.
  • Tạo một đầu vào, xác định những việc bạn muốn tác nhân thực hiện.

Python

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="Write a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt. Then read the file and print its contents.",
    environment="remote",
)

# Print the agent's final output
print(f"Interaction ID: {interaction.id}")
print(f"Environment ID: {interaction.environment_id}")
print(f"Output: {interaction.output_text}")

JavaScript

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

const client = new GoogleGenAI({});

const interaction = await client.interactions.create({
    agent: "antigravity-preview-05-2026",
    input: "Write a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt. Then read the file and print its contents.",
    environment: "remote",
});

console.log(`Interaction ID: ${interaction.id}`);
console.log(`Environment ID: ${interaction.environment_id}`);

console.log(`Output: ${interaction.output_text}`);

REST

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
    "agent": "antigravity-preview-05-2026",
    "input": [{"type": "text", "text": "Write a Python script that generates the first 20 Fibonacci numbers and saves them to fibonacci.txt. Then read the file and print its contents."}],
    "environment": {"type": "remote"}
}'

Phản hồi trả về một đối tượng Interaction. Lưu trữ interaction.idinteraction.environment_id để tiếp tục cuộc trò chuyện trong cùng một hộp cát. Sử dụng interaction.output_text để truy cập vào câu trả lời cuối cùng của trợ lý. interaction.steps liệt kê từng bước mà tác nhân đã thực hiện (suy luận, lệnh gọi công cụ, thực thi mã).

Tiếp tục cuộc trò chuyện (nhiều lượt)

API này theo dõi 2 phương diện trạng thái độc lập:

  • Bối cảnh cuộc trò chuyện: nhật ký trò chuyện, dấu vết suy luận, việc sử dụng công cụ, sử dụng previous_interaction_id.
  • Trạng thái môi trường: tệp, các gói đã cài đặt và trạng thái hộp cát, sử dụng environment.

Đặt cả hai thẻ vào vị trí tương ứng để tiếp tục:

Python

interaction_2 = client.interactions.create(
    agent="antigravity-preview-05-2026",
    previous_interaction_id=interaction.id,
    environment=interaction.environment_id,
    input="Now plot the Fibonacci sequence as a line chart and save it as chart.png.",
)

print(interaction_2.output_text)

JavaScript

const interaction2 = await client.interactions.create({
    agent: "antigravity-preview-05-2026",
    previous_interaction_id: interaction.id,
    environment: interaction.environment_id,
    input: "Now plot the Fibonacci sequence as a line chart and save it as chart.png.",
}, { timeout: 300_000 });

console.log(interaction2.output_text);

REST

curl -X POST "https://generativelanguage.googleapis.com/v1beta/interactions" \
-H "Content-Type: application/json" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-d '{
    "agent": "antigravity-preview-05-2026",
    "previous_interaction_id": "interaction_id_from_step_1",
    "environment": "environment_id_from_step_1",
    "input": [{"type": "text", "text": "Now plot the Fibonacci sequence as a line chart and save it as chart.png."}]
}'

Các tệp từ lượt 1 (fibonacci.txt) vẫn tồn tại trong lượt 2. Tác nhân này cũng lưu giữ bối cảnh của cuộc trò chuyện.

Bạn có thể kết hợp các chế độ này một cách độc lập:

  • Xoá cuộc trò chuyện, giữ lại tệp: Bỏ qua previous_interaction_id, chỉ truyền mã nhận dạng môi trường bằng environment để bắt đầu một cuộc trò chuyện mới trong cùng một không gian làm việc.
  • Giữ lại cuộc trò chuyện, không gian làm việc mới: Truyền previous_interaction_id, đặt environment="remote" cho một hộp cát mới.

Tự động nén bối cảnh

Trong các cuộc trò chuyện kéo dài nhiều lượt, nhật ký thô về các bước suy luận, lệnh gọi công cụ và nội dung tệp lớn có thể nhanh chóng tăng lên và chiếm một lượng lớn không gian bối cảnh. Để ngăn lỗi vượt quá giới hạn mã thông báo và duy trì sự tập trung của tác nhân (ngăn chặn "sự suy giảm ngữ cảnh"), Managed Agents API có một bước nén ngữ cảnh gốc ở khoảng 135.000 mã thông báo. Quy trình này diễn ra tự động.

Hiện câu trả lời theo thời gian thực

Đối với các tác vụ chạy trong thời gian dài, bạn có thể truyền trực tuyến câu trả lời để xem trợ lý hoạt động theo thời gian thực:

Python

from google import genai

client = genai.Client()

stream