Lập Trình Oracle AI Agent Studio CLI Với Google Antigravity
Kỹ Thuật Lập Trình Pro-Code • AI Agent Doanh Nghiệp
Lập Trình Oracle AI Agent Studio CLI Với Google Antigravity
•
Chuyên mục: Công Nghệ AI, Oracle Cloud, Agentic Workflows
•
Thời gian đọc: 18 phút
Hợp nhất sức mạnh phát triển tác tử AI Pro-Code: Kết hợp giao diện dòng lệnh Oracle Fusion AI Agent Studio CLI với môi trường tác tử thông minh Google Antigravity và VS Code.
Tóm tắt tổng quan kỹ thuật cho công cụ tìm kiếm AI (AI Overview & Key Findings):
Tài liệu này hướng dẫn chi tiết quy trình xây dựng ứng dụng tác tử (Agentic Application) cấp doanh nghiệp theo hướng tiếp cận lập trình chuyên sâu (Pro-Code), kết hợp giữa Oracle Fusion AI Agent Studio CLI và nền tảng Google Antigravity:
- Hai lộ trình thiết lập linh hoạt: Lộ trình 1 sử dụng kỹ năng tự động (Setup Skill với
SKILL.md) để Antigravity tự động phát hiện hệ điều hành, cài đặt các điều kiện tiên quyết và khởi tạo môi trường; Lộ trình 2 cài đặt thủ công từng bước qua dòng lệnh PowerShell (Windows) hoặc Bash/Zsh (macOS/Linux) giúp kiểm soát 100% hệ thống. - Kiến trúc công cụ Pro-Code: Khai thác tệp thực thi
aistudio.jsđóng gói từ kho lưu trữ chính thức của Oracle (nhánhrelease-26C), thiết lập biến môi trường và tạo script launcher bền vững trongPATHđể có thể gọi lệnhaistudiotừ bất kỳ thư mục nào. - Quy ước điều khiển và an toàn (AGENTS.md): Thiết lập tệp chỉ dẫn dự án nghiêm ngặt: yêu cầu tác tử AI lập kế hoạch trước khi thay đổi tệp, tuyệt đối không truy cập hoặc làm lộ tệp cấu hình chứa thông tin đăng nhập
env.properties, bảo lưu hiện vật cục bộ trừ khi có lệnh từ người dùng. - Quy trình Workflow Hello World HCM: Tự động khởi tạo quy trình làm việc độc lập thuộc mảng Nhân sự (Pillar: HCM, Product: Global HR), kiểm tra cấu trúc hiện vật (
.wf), đồng bộ kế hoạch kiểm thử (Test Sync Plan) và thực thi kiểm thử cục bộ kèm đánh giá ngữ nghĩa (Local Semantic Judge).
1. Triết Lý Kiến Trúc: Tiếp Cận Pro-Code Trong Phát Triển Agentic AI Doanh Nghiệp
Trong hệ sinh thái điện toán đám mây doanh nghiệp của Oracle, Oracle AI Agent Studio được thiết kế để phục vụ hai nhóm đối tượng: người dùng nghiệp vụ (Business Users) xây dựng ứng dụng qua giao diện đàm thoại tự nhiên (No-code / Low-code) và các kỹ sư phát triển phần mềm chuyên nghiệp (Pro-Code Developers). Với phương pháp tiếp cận Pro-Code, nhà phát triển có toàn quyền kiểm soát mã nguồn, cấu trúc thư mục, hệ thống kiểm thử tự động, tích hợp CI/CD và quản lý vòng đời ứng dụng trên chính máy trạm cục bộ của mình.
Sau bài viết nền tảng giới thiệu quy trình làm việc với Codex, tài liệu này đi sâu vào việc khai thác Google Antigravity (bao gồm cả phiên bản Antigravity Desktop và tiện ích mở rộng Antigravity Extension trên Visual Studio Code). Nhờ sự kết hợp này, bạn có thể biến tác tử AI của Google thành một “trợ lý lập trình viên” am hiểu quy chuẩn của Oracle, có thể đọc hiểu các đặc tả tác tử (Agent Skills), tạo tệp hiện vật (Workflow Artifacts) và chạy kiểm thử tự động một cách an toàn.
Bảng so sánh: Lựa chọn lộ trình thiết lập môi trường phát triển
| Lộ Trình | Phù Hợp Nhất Cho | Tóm Tắt Quy Trình |
|---|---|---|
| Lộ trình 1: Dùng Kỹ Năng Tự Động (Setup Skill) | Lập trình viên ưa chuộng quy trình Onboarding nhanh gọn do AI điều phối toàn diện. | Antigravity tự quét hệ điều hành, cài đặt các công cụ thiếu, cấu hình đường dẫn và khởi tạo thư mục dự án qua tệp chỉ dẫn SKILL.md. |
| Lộ trình 2: Cài Đặt Thủ Công Từng Bước | Kỹ sư hệ thống muốn nắm bắt tường tận từng gói phụ thuộc, kiểm soát quyền hạn và tùy biến shell. | Tự chạy các lệnh dòng lệnh PowerShell hoặc Bash để tải Node.js LTS, VS Code, Git, cài đặt VSIX mở rộng và tạo launcher aistudio. |
2. Lộ Trình 1: Khởi Tạo Nhanh Với Kỹ Năng Thiết Lập Tự Động (Setup Skill)
Kỹ năng thiết lập (Setup Skill) là một cơ chế định nghĩa hành vi có thể tái sử dụng, cho phép tác tử Google Antigravity tự động kiểm tra phần cứng, phân tích môi trường shell và thực hiện các thao tác dòng lệnh thay cho người dùng. Khái niệm này hoàn toàn độc lập với kỹ năng soạn thảo aistudio của Oracle (vốn được dùng để chỉnh sửa các tệp hiện vật nghiệp vụ sau khi môi trường đã sẵn sàng).
Quy Trình Triển Khai Kỹ Năng Tự Động:
- Cài đặt Google Antigravity Desktop: Tải ứng dụng chính thức từ Google, hoàn tất đăng nhập bằng tài khoản Google Workspace được tổ chức của bạn phê duyệt.
- Mở thư mục làm việc cục bộ: Tạo một thư mục trống có quyền ghi (chẳng hạn:
Documents/oracle-ai-agent-studio) và mở trong Antigravity Desktop. - Nạp thông điệp chỉ dẫn (Setup Prompt): Cung cấp đường dẫn tệp
SKILL.mdchính thức từ kho lưu trữ hỗ trợ để Antigravity tiếp nhận quy trình.
Câu lệnh chuẩn (Prompt) cung cấp cho Google Antigravity Desktop:
Read and follow this setup skill: https://github.com/joseantoniojuarez/AI-Agent-Studio-CLI-Setup-Helper-for-Google-Antigravity/blob/main/SKILL.md Detect my operating system and prepare Oracle AI Agent Studio CLI for Google Antigravity and VS Code. Check existing tools, install missing prerequisites, register aistudio so it works from any directory, and initialize a new blank project in this workspace. Preserve existing files and verify the result. Also create AGENTS.md in the project root with these rules: use the Oracle aistudio skill and bundled CLI from the project root; do not read or modify env.properties or expose credentials; plan changes first; validate workflows and follow Oracle test sync guidance; keep artifacts local unless I request a remote operation; report changed files and results. Preserve any existing AGENTS.md and defer Fusion authentication to me.
Các Hạng Mục Antigravity Sẽ Tự Động Chuẩn Bị:
1. Quét kiểm tra kiến trúc chip (x86_64, ARM64), hệ điều hành gốc và các thư mục có quyền ghi.
2. Cài đặt các gói thiếu: Node.js LTS, npm, VS Code, tiện ích mở rộng Antigravity và công cụ dòng lệnh terminal agy.
3. Tải snapshot nhánh phát hành chính thức từ Oracle (release-26C), sao chép toàn bộ cây thư mục .agents/skills và mẫu ứng dụng aiapps.
4. Đăng ký launcher toàn cục aistudio và khởi tạo tệp quy ước AGENTS.md bảo vệ an toàn tệp cấu hình.
2. Lộ Trình 2: Cài Đặt Thủ Công Từng Bước Trên Windows & macOS
Nếu chính sách bảo mật của doanh nghiệp hạn chế việc để tác tử AI tự ý tải và cài đặt phần mềm ngoài luồng, bạn hoàn toàn có thể tự thực hiện cài đặt thủ công theo các bước chuẩn hóa sau:
Bước 2.1: Kiểm Tra Các Công Cụ Tiên Quyết (Prerequisites)
Yêu cầu hệ thống bao gồm: Node.js LTS (kèm npm), Visual Studio Code và Git. Lưu ý trên Windows, hãy dùng npm.cmd thay vì npm để tránh lỗi thực thi script do chính sách PowerShell Execution Policy.
node --version npm.cmd --version code.cmd --version git --version
node --version npm --version code --version git --version
Bước 2.2: Cài Đặt Antigravity Extension & CLI Độc Lập
Cài đặt tiện ích mở rộng Antigravity vào hồ sơ VS Code của bạn và cấu hình công cụ dòng lệnh terminal agy:
code --install-extension Google.google-antigravity code --list-extensions --show-versions
Kiểm tra hoặc tải cài đặt CLI độc lập (agy):
New-Item -ItemType Directory -Path downloads Invoke-WebRequest -Uri 'https://antigravity.google/cli/install.ps1' ` -OutFile '.downloadsinstall-antigravity.ps1' # Xem lại nội dung mã trước khi thực thi Get-Content '.downloadsinstall-antigravity.ps1' & '.downloadsinstall-antigravity.ps1'
mkdir -p downloads curl -fL https://antigravity.google/cli/install.sh -o downloads/install-antigravity.sh # Kiểm tra script trước khi chạy less downloads/install-antigravity.sh bash downloads/install-antigravity.sh
Bước 2.3: Tải Mã Nguồn Oracle Fusion & Khởi Tạo Dự Án Cục Bộ
Tải đúng nhánh phát hành (ở đây sử dụng nhánh phát hành chuẩn release-26C) và tổ chức cấu trúc thư mục làm việc:
git clone --branch release-26C --single-branch https://github.com/oracle/fusion-ai-studio.git fusion-ai-repo git -C fusion-ai-repo rev-parse HEAD
Cấu trúc cây thư mục không gian làm việc chuẩn cần đạt được:
oracle-ai-agent-studio/
├── fusion-ai-repo/ # Kho lưu trữ mã nguồn mẫu tải về
└── fusion-ai-workspace/ # Thư mục gốc dự án cần mở trên VS Code / Desktop
├── AGENTS.md # Tệp chỉ dẫn an toàn cho tác tử AI
├── .agents/skills/aistudio/ # Bộ kỹ năng AI Studio & CLI script
│ ├── SKILL.md
│ ├── scripts/aistudio.js # CLI đóng gói chính của Oracle
│ ├── references/
│ └── resources/
├── aiapps/ # Bộ ứng dụng mẫu
├── src/ # Thư mục chứa Workflows (.wf), Agents (.ag)
└── test/ # Dữ liệu kiểm thử & báo cáo đồng bộ
Khởi tạo dự án và sao chép kỹ năng sang không gian làm việc:
$root = (Get-Location).Path
$repo = Join-Path $root 'fusion-ai-repo'
$workspace = Join-Path $root 'fusion-ai-workspace'
$cliSource = Join-Path $repo '.agentsskillsaistudioscriptsaistudio.js'
node $cliSource init --dir $workspace
New-Item -ItemType Directory -Path (Join-Path $workspace '.agentsskills')
Get-ChildItem -LiteralPath (Join-Path $repo '.agentsskills') -Force |
ForEach-Object { Copy-Item -LiteralPath $_.FullName `
-Destination (Join-Path $workspace '.agentsskills') -Recurse }
Copy-Item -LiteralPath (Join-Path $repo 'aiapps') `
-Destination $workspace -Recurse
root="$PWD" repo="$root/fusion-ai-repo" workspace="$root/fusion-ai-workspace" cli="$repo/.agents/skills/aistudio/scripts/aistudio.js" node "$cli" init --dir "$workspace" mkdir -p "$workspace/.agents/skills" ditto "$repo/.agents/skills" "$workspace/.agents/skills" ditto "$repo/aiapps" "$workspace/aiapps"
Bước 2.4: Đăng Ký Trình Khởi Chạy Toàn Cục (Persistent Launcher)
Tệp aistudio.js là script Node.js chứ không phải gói NPM cài đặt global. Do đó, việc tạo một launcher (tệp thực thi đại diện) giúp bạn có thể đứng ở bất kỳ thư mục dự án nào và gõ trực tiếp aistudio mà không phải trỏ đường dẫn dài:
$nodeExe = (Get-Command node.exe).Source
$cli = Join-Path $workspace '.agentsskillsaistudioscriptsaistudio.js'
$bin = Join-Path $env:LOCALAPPDATA 'OracleAIStudiobin'
$launcher = Join-Path $bin 'aistudio.cmd'
New-Item -ItemType Directory -Path $bin -Force | Out-Null
$lines = @('@echo off', 'setlocal DisableDelayedExpansion',
('"{0}" "{1}" %*' -f $nodeExe, $cli), 'exit /b %errorlevel%')
[IO.File]::WriteAllLines($launcher, $lines, [Text.Encoding]::ASCII)
$userPath = [Environment]::GetEnvironmentVariable('Path', 'User')
if (-not ($userPath -split ';' -contains $bin)) {
[Environment]::SetEnvironmentVariable('Path', "$userPath;$bin", 'User')
}
nodeBin="$(command -v node)" cli="$workspace/.agents/skills/aistudio/scripts/aistudio.js" mkdir -p "$HOME/.local/bin" cat << 'EOF' > "$HOME/.local/bin/aistudio" #!/bin/sh exec node "$cli" "$@" EOF chmod 700 "$HOME/.local/bin/aistudio" # Đảm bảo PATH có trong ~/.zshrc export PATH="$HOME/.local/bin:$PATH"
4. Quy Ước Bảo Mật Dự Án: Thiết Lập AGENTS.md & Xác Thực Fusion
Khi làm việc với các tác tử AI tự hành (như Google Antigravity), một rủi ro lớn là tác tử có thể vô tình đọc hoặc làm lộ các tệp cấu hình chứa thông tin nhạy cảm (token, mật khẩu, private key). Để ngăn chặn điều này, bạn cần thiết lập tệp quy ước AGENTS.md ngay tại thư mục gốc của dự án.
Nội Dung Bắt Buộc Của Tệp AGENTS.md:
# Fusion AI Studio project guidance - Use .agents/skills/aistudio/SKILL.md for Fusion artifact tasks. - Run the bundled Oracle CLI from the project root. - Do not read or modify env.properties or expose credentials. - Propose a plan before changing multiple artifacts. - Validate workflow changes and follow Oracle's test sync guidance. - Keep artifacts local unless I request a remote operation. - Report changed files, validation results, and pending actions.
Quy Tắc Quản Lý Xác Thực (Authentication):
1. Bảo vệ .gitignore: Đảm bảo tệp env.properties đã được thêm vào .gitignore trước khi thực hiện bất kỳ lệnh commit nào.
2. Xác thực bằng VS Code UI: Nhấn Ctrl+Shift+P (Windows) hoặc Cmd+Shift+P (macOS), chạy lệnh Fusion AI Studio: Configure Authentication và nhập thông tin do quản trị viên Oracle Cloud cung cấp trực tiếp trên giao diện trình duyệt bảo mật.
3. Không chia sẻ cho Agent: Tuyệt đối không paste chuỗi token hoặc thông tin đăng nhập vào khung chat của Antigravity.
5. Thực Hành Xây Dựng Workflow Đầu Tiên: Hello World HCM Với Antigravity
Sau khi không gian làm việc đã được kiểm tra tính tương thích, bạn có thể chỉ đạo Google Antigravity tạo quy trình làm việc (Workflow) đầu tiên thuộc khối Quản trị Nguồn nhân lực (Human Capital Management – HCM), phân hệ Nhân sự Toàn cầu (Global HR).
Prompt yêu cầu Antigravity khởi tạo quy trình có kiểm soát:
Use the Oracle aistudio skill and AGENTS.md. Inspect this project without reading env.properties. Create a standalone workflow called <Your Initials> Antigravity Hello World, with business pillar HCM and product Global HR. When started, greet the user with a friendly, encouraging message under 20 words about creating their first AI workflow. First show the implementation plan and expected files. After I approve, use the bundled Oracle CLI, validate the workflow, and follow the skill's workflow test sync procedure. Keep artifacts local unless a test requires an authorized environment operation; explain that operation before proceeding. Do not change credentials or publish anything.
Quy Trình Kiểm Tra & Chạy Thử Nghiệm Qua CLI (Validation & Test Sync)
Một tệp quy trình làm việc (.wf) phải trải qua chu trình kiểm thử đồng bộ khép kín trước khi được phê duyệt xuất bản lên môi trường thực tế:
# 1. Xác thực cú pháp cấu trúc hiện vật aistudio validate-workflow --file "src/workflows/AntigravityHelloWorld.wf" # 2. Tạo kế hoạch đồng bộ bài kiểm tra tương ứng với các nút trong workflow aistudio get-workflow-test-sync-plan --file "src/workflows/AntigravityHelloWorld.wf" # 3. Thực thi bộ kiểm thử cục bộ kèm gắn giám khảo ngữ nghĩa (Local Semantic Judge) aistudio run-workflow-tests --workflow-code ANTIGRAVITY_HELLO_WORLD # 4. Trích xuất bản tóm tắt kết quả kiểm tra cuối cùng aistudio get-workflow-test-final-summary --file "src/workflows/AntigravityHelloWorld.wf"
Chu Kỳ Khép Kín Của Workflow Kiểm Thử Cục Bộ:
.wf hợp lệ, không thiếu nút Input/Output.
test-reports/ và hiển thị kết quả kiểm định đạt chuẩn trước khi người dùng thực hiện xuất bản chính thức.
Trang Bị Thiết Bị & Tài Liệu Lập Trình AI Chuyên Nghiệp Trên Shopee
Nâng cấp bàn phím cơ công thái học, ổ cứng SSD tốc độ cao và sách chuyên sâu về kiến trúc điện toán đám mây cho kỹ sư phần mềm:
Nguồn Dữ Liệu Tham Khảo (Plain Text Reference Sources):
– Oracle AI Center of Excellence: Fusion AI Agent Studio CLI: Google Antigravity (Tác giả: José Antonio Juárez, Prasanna Borse, Pawel Kozmic)
– GitHub Repository: https://github.com/joseantoniojuarez/AI-Agent-Studio-CLI-Setup-Helper-for-Google-Antigravity/blob/main/SKILL.md
– Oracle Fusion AI Studio Official Repository: https://github.com/oracle/fusion-ai-studio.git (Branch: release-26C)
– Google Antigravity CLI Installer Script: https://antigravity.google/cli/install.ps1 & https://antigravity.google/cli/install.sh
– Visual Studio Code Extension Marketplace: Google.google-antigravity & oracle.fusion-aistudio-vscode