Thiết lập tác nhân lập trình và tài nguyên dành cho nhà phát triển

Các tác nhân lập trình AI dựa vào dữ liệu huấn luyện được cắt ở một ngày nhất định. Do đó, các trợ lý thường đề xuất những mô hình không dùng nữa (gemini-1.5), SDK cũ (google-generativeai) hoặc mẫu mã lỗi thời.

Việc kết nối tác nhân của bạn với các tài nguyên chính thức dành cho nhà phát triển Gemini sẽ giúp tác nhân viết mã chính xác bằng các mô hình hiện tại, SDK google-genai và Interactions API.

Bạn có thể cấp cho tác nhân lập trình quyền truy cập vào tài liệu và quy tắc của Gemini theo 4 cách:

Tóm tắt tài nguyên dành cho nhân viên hỗ trợ

Cài đặt các kỹ năng của tác nhân Gemini

Các kỹ năng của tác nhân cung cấp cho tác nhân lập trình của bạn các quy tắc thủ tục, tên mô hình hiện tại và mẫu mã SDK. Thay vì thêm hướng dẫn dài vào câu lệnh, tác nhân của bạn chỉ tải từng kỹ năng khi cần. Điều này giúp tác nhân của bạn tránh các SDK không dùng nữa và sử dụng các mẫu Gemini hiện đại.

Các kỹ năng hoạt động cùng với máy chủ MCP của Gemini Docs. Nếu trợ lý của bạn chưa cài đặt máy chủ MCP, thì kỹ năng này sẽ quay lại llms.txt. Để tìm hiểu thêm về cách hoạt động của các kỹ năng, hãy đọc hướng dẫn về Các kỹ năng của Gemini API.

Cài đặt bằng CLI (skills.sh hoặc Context7)

Cài đặt các kỹ năng bằng skills.sh (nên dùng) hoặc Context7:

# List all available skills in the repository
npx skills add google-gemini/gemini-skills --list

# Install a specific skill globally with skills.sh
npx skills add google-gemini/gemini-skills --skill <skill-name> --global

# Or install with Context7
npx ctx7 skills install /google-gemini/gemini-skills <skill-name>

Các kỹ năng hiện có

gemini-api-dev

Kỹ năng xây dựng các ứng dụng bằng Interactions API và các SDK Gemini API chính thức (google-genai cho Python và @google/genai cho TypeScript). Kỹ năng này bao gồm:

• Tạo văn bản, trò chuyện nhiều lượt, truyền trực tuyến, đầu ra có cấu trúc và gọi hàm
• Tạo hình ảnh, chuyển văn bản sang lời nói (TTS) và dữ liệu đầu vào đa phương thức
• Quản lý trạng thái cuộc trò chuyện phía máy chủ, thực thi ở chế độ nền, Nghiên cứu chuyên sâu và tác nhân được quản lý
• Tên mô hình hiện tại và di chuyển mã generateContent hoặc google-generativeai cũ

npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

gemini-live-api-dev

Kỹ năng xây dựng các ứng dụng phát trực tuyến âm thanh và video theo thời gian thực bằng Gemini Live API. Kỹ năng này bao gồm:

• Quản lý phiên WebSocket, mã thông báo tạm thời của máy khách và tiếp tục phiên
• Phát trực tuyến âm thanh, video và văn bản có tính năng phát hiện hoạt động giọng nói (VAD) và hỗ trợ tính năng ngắt lời
• Suy luận ở chế độ nền (tư duy chuyên sâu), các lệnh gọi công cụ không đồng bộ không chặn, bản chép lời và dịch lời nói trực tiếp

npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

gemini-omni-flash-api

Kỹ năng tạo và chỉnh sửa video bằng Gemini Omni Flash thông qua Interactions API. Bao gồm các tập lệnh trợ giúp (upload_file.py, generate_video.py, prep_video.py, inspect_video.py) và bao gồm:

• Tạo video từ văn bản và tạo câu lệnh
• Hiệu ứng chuyển cảnh khung hình đầu tiên và cuối cùng, cũng như tính năng tạo video dựa trên video tham khảo
• Phần mở rộng video và quy trình tiền xử lý nội dung nghe nhìn

npx skills add google-gemini/gemini-skills --skill gemini-omni-flash-api --global

Gắn kỹ năng trong Tác nhân được quản lý

Khi chạy các tác nhân được quản lý từ xa bằng Interactions API, bạn có thể gắn kho lưu trữ google-gemini/gemini-skills vào không gian làm việc của tác nhân. Hãy xem hướng dẫn về Các kỹ năng của Gemini API để biết thông tin chi tiết:

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-09-2026",
    input="Build a script that generates a 5-second video of a neon cityscape.",
    environment={
        "type": "remote",
        "sources": [
            {
                "type": "repository",
                "source": "https://github.com/google-gemini/gemini-skills",
                "target": ".agents",
            }
        ],
    },
)

Kết nối máy chủ MCP của Gemini Docs

Máy chủ MCP của Gemini Docs (https://gemini-api-docs-mcp.dev) cho phép tác nhân của bạn truy cập trực tiếp vào toàn bộ trang web tài liệu. Trợ lý AI có thể tìm kiếm và đọc các trang tài liệu để kiểm tra giản đồ yêu cầu, giới hạn mô hình và các tính năng mới:

• gemini_search_docs: Tìm kiếm tài liệu về Gemini API theo chủ đề hoặc cụm từ tìm kiếm.
• gemini_get_doc: Đọc toàn bộ nội dung Markdown của một trang tài liệu cụ thể.

Thiết lập nhanh

Chạy lệnh này trong thiết bị đầu cuối hoặc thư mục gốc của dự án để tự động định cấu hình các tác nhân mã hoá được phát hiện:

npx add-mcp "https://gemini-api-docs-mcp.dev"

Cấu hình theo môi trường

$ claude mcp add --transport http geminiDocs https://gemini-api-docs-mcp.dev

{
  "mcpServers": {
    "geminiDocs": {
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

$ codex mcp add geminiDocs --url https://gemini-api-docs-mcp.dev

[mcp_servers.geminiDocs]
url = "https://gemini-api-docs-mcp.dev"

{
  "servers": {
    "geminiDocs": {
      "type": "http",
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

Trình bổ trợ Gemini API

Nếu bạn sử dụng Antigravity, thì trình bổ trợ Gemini API là cách nhanh nhất để thiết lập không gian làm việc. Công cụ này kết hợp máy chủ MCP của Gemini Docs, tất cả các kỹ năng chính thức của Gemini (gemini-api-dev, gemini-live-api-dev, gemini-omni-flash-api) và các công cụ khoá API trong một bản tải xuống.

• Cài đặt trong Antigravity (giao diện người dùng): Chuyển đến Settings > Customizations > Build with Google Plugins (Cài đặt > Tuỳ chỉnh > Xây dựng bằng các trình bổ trợ của Google) rồi tải Gemini API xuống.
• Cài đặt bằng CLI: bash agy plugin install https://github.com/google-gemini/gemini-skills

Tài liệu có thể đọc được bằng máy

Các trang web tiêu chuẩn bao gồm thẻ HTML, thanh điều hướng và tập lệnh chiếm không gian cửa sổ ngữ cảnh. ai.google.dev cung cấp các điểm cuối có thể đọc được bằng máy để các tác nhân và tập lệnh có thể tìm nạp trực tiếp nội dung Markdown rõ ràng:

• Chỉ mục llms.txt (https://ai.google.dev/gemini-api/docs/llms.txt): Liệt kê tất cả các trang tài liệu về Gemini API kèm theo đường liên kết đến từng trang.
• URL Markdown trực tiếp (.md.txt): Thêm .md.txt vào bất kỳ URL tài liệu nào trên ai.google.dev (ví dụ: https://ai.google.dev/gemini-api/docs/coding-agents.md.txt) để nhận nguồn Markdown rõ ràng cho các câu lệnh đã lưu, quy tắc AGENTS.md hoặc tập lệnh tự động.

Quy tắc được đề xuất cho dự án (AGENTS.md)

Tệp quy tắc dự án (AGENTS.md, .cursorrules hoặc CLAUDE.md) đặt các quy tắc cơ bản sẽ tải khi bắt đầu mỗi phiên của tác nhân. Thêm các nguyên tắc này vào thư mục gốc của dự án để các tác nhân viết mã mặc định sử dụng các mô hình và SDK hiện tại:

# Gemini API Guidelines

- Before writing Gemini API code, consult the `geminiDocs` MCP server (`gemini_search_docs` / `gemini_get_doc`) or `https://ai.google.dev/gemini-api/docs/llms.txt`.
- Always use the current Gemini API SDK (`google-genai` for Python, `@google/genai` for TypeScript/JavaScript). Never use legacy SDKs (`google-generativeai` or `@google/generative-ai`).
- Use the Interactions API (`client.interactions.create`) for new applications unless a specific feature requires `generateContent`.
- Use current recommended models (see https://ai.google.dev/gemini-api/docs/models) and avoid deprecated models.

Xác minh và khắc phục sự cố

Xác minh thiết lập của bạn

Để kiểm thử chế độ thiết lập, hãy yêu cầu tác nhân lập trình:

Look up the request schema for the Gemini Interactions API in the documentation.

Một tác nhân được định cấu hình sẽ sử dụng gemini_search_docs trên máy chủ MCP geminiDocs và viết mã bằng client.interactions.create với SDK google-genai hoặc @google/genai.

Lệnh trạng thái

Khắc phục sự cố

• Không phát hiện thấy kỹ năng hoặc máy chủ MCP: Khởi động lại trình chỉnh sửa (Cursor hoặc VS Code) hoặc phiên thiết bị đầu cuối (Claude Code hoặc Codex). Hầu hết các tác nhân chỉ tải máy chủ và kỹ năng MCP khi khởi động.
• Xung đột kỹ năng trên toàn cầu: Nếu tác nhân của bạn bỏ qua một kỹ năng được cài đặt trên toàn cầu, hãy cài đặt kỹ năng đó trong thư mục gốc của dự án mà không có --global: bash npx skills add google-gemini/gemini-skills --skill gemini-api-dev
• Các quy tắc bị bỏ qua: Đảm bảo tệp AGENTS.md, .cursorrules hoặc CLAUDE.md nằm trong thư mục gốc của dự án.

Bước tiếp theo

• Hướng dẫn về Các kỹ năng của Gemini API
• Các kỹ năng của Gemini API trên GitHub
• Interactions API
• Các mô hình hiện có
• Thư viện và SDK