Mở rộng Managed Agents trong Gemini API: tác vụ nền, MCP từ xa và nhiều tính năng khác

1npm install @google/genai

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5// 1. Bắt đầu một phân tích chạy lâu trong nền
6const interaction = await client.interactions.create({
7  agent: "antigravity-preview-05-2026",
8  input: "Clone https://github.com/googleapis/js-genai, tìm tất cả các comment TODO trong mã nguồn và phân loại chúng theo module và mức độ ưu tiên trong một báo cáo markdown.",
9  environment: "remote",
10  background: true,
11});
12
13console.log(`Tác vụ nền đã bắt đầu. ID Tương tác: ${interaction.id}`);
14
15// 2. Kiểm tra bất đồng bộ mà không chặn một socket HTTP đang mở
16let result = interaction;
17while (result.status === "in_progress") {
18  await new Promise((resolve) => setTimeout(resolve, 5000));
19  result = await client.interactions.get(interaction.id);
20}
21
22if (result.status === "completed") {
23  console.log("Tác vụ hoàn thành:\n", result.output_text);
24} else {
25  console.error(`Tác vụ kết thúc với trạng thái: ${result.status}`);
26}

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5const interaction = await client.interactions.create({
6  agent: "antigravity-preview-05-2026",
7  input: "Kiểm tra máy chủ quan sát nội bộ của chúng ta để tìm các đột biến độ trễ gần đây trong dịch vụ xác thực và đối chiếu chúng với các commit git.",
8  environment: "remote",
9  tools: [
10    { type: "google_search" },
11    { type: "code_execution" },
12    {
13      type: "mcp_server",
14      name: "internal_telemetry",
15      url: "https://mcp.internal.example.com/mcp",
16    },
17  ],
18});
19
20console.log(interaction.output_text);

1import { GoogleGenAI } from "@google/genai";
2
3const client = new GoogleGenAI({});
4
5// 1. Định nghĩa một hàm miền tùy chỉnh
6const getWeatherTool = {
7  type: "function",
8  name: "get_weather",
9  description: "Lấy thời tiết hiện tại cho một địa điểm nhất định.",
10  parameters: {
11    type: "object",
12    properties: {
13      location: {
14        type: "string",
15        description: "Thành phố và quốc gia, ví dụ: San Francisco, USA",
16      },
17    },
18    required: ["location"],
19  },
20};
21
22// 2. Gọi tác nhân với cả thực thi mã tích hợp sẵn và các hàm tùy chỉnh
23const interaction = await client.interactions.create({
24  agent: "antigravity-preview-05-2026",
25  input: "Kiểm tra thời tiết ở Tokyo, viết một script Python để chuyển đổi nhiệt độ sang Fahrenheit và lưu kết quả vào weather.txt.",
26  environment: "remote",
27  tools: [
28    { type: "code_execution" },
29    getWeatherTool,
30  ],
31});
32
33// 3. Xử lý việc thực thi hàm tùy chỉnh một cách sạch sẽ
34if (interaction.status === "requires_action") {
35  // Các công cụ Filesystem và sandbox thực thi tự động và tạo ra một bước function_result tương ứng.
36  // Chúng tôi lọc các lệnh gọi miền đang chờ yêu cầu thực thi phía ứng dụng khách.
37  const executedCalls = new Set(
38    interaction.steps
39      .filter((s) => s.type === "function_result")
40      .map((s) => s.call_id)
41  );
42
43  const pendingCalls = interaction.steps.filter(
44    (s) => s.type === "function_call" && !executedCalls.has(s.id)
45  );
46
47  for (const call of pendingCalls) {
48    console.log(`Đang thực thi công cụ ứng dụng khách: ${call.name} (ID: ${call.id})`);
49    // Thực thi truy vấn API/cơ sở dữ liệu cục bộ của bạn và gửi function_result trở lại trong lượt 2
50  }
51}

1import { GoogleGenAI } from "@google/genai";
2const client = new GoogleGenAI({});
3
4// 1. Tương tác đầu tiên: sử dụng token ban đầu
5const first = await client.interactions.create({
6  agent: "antigravity-preview-05-2026",
7  input: "Liệt kê các tệp trong gs://my-bucket/reports/ bằng GCS JSON API.",
8  environment: {
9    type: "remote",
10    network: {
11      allowlist: [
12        {
13          domain: "storage.googleapis.com",
14          transform: {
15            Authorization: "Bearer INITIAL_TOKEN",
16          },
17        },
18      ],
19    },
20  },
21});
22
23// 2. Sau đó: làm mới token trên cùng một môi trường
24const result = await client.interactions.create({
25  agent: "antigravity-preview-05-2026",
26  input: "Bây giờ hãy tải xuống tệp reports/q1.csv từ cùng một bucket.",
27  environment: {
28    type: "remote",
29    environment_id: first.environment_id,
30    network: {
31      allowlist: [
32        {
33          domain: "storage.googleapis.com",
34          transform: {
35            Authorization: "Bearer REFRESHED_TOKEN",
36          },
37        },
38      ],
39    },
40  },
41});
42console.log(result.output_text);