Tạo ứng dụng trong Google AI Studio

Trang này mô tả cách sử dụng Google AI Studio để nhanh chóng tạo (hoặc "lập trình theo cảm hứng") và triển khai các ứng dụng kiểm thử những tính năng mới nhất của Gemini như Nano BananaLive API. Google AI Studio hiện hỗ trợ thời gian chạy toàn ngăn xếp, cho phép bạn tạo các ứng dụng mạnh mẽ bằng logic phía máy chủ, tính năng quản lý bí mật an toàn và hỗ trợ gói npm, tất cả đều thông qua câu lệnh bằng ngôn ngữ tự nhiên.

Bắt đầu

Bắt đầu lập trình theo cảm hứng trong Chế độ tạo của Google AI Studio. Bạn có thể bắt đầu xây dựng theo một số cách:

  • Bắt đầu bằng một câu lệnh: Ở chế độ Tạo, hãy dùng ô nhập dữ liệu để nhập nội dung mô tả về những gì bạn muốn tạo. Chọn AI Chips để thêm các tính năng cụ thể như tạo hình ảnh hoặc dữ liệu của Google Maps vào câu lệnh. Bạn thậm chí có thể nói nội dung mình muốn bằng cách dùng nút chuyển lời nói thành văn bản.
  • Nút "Xem trang đầu tiên tìm được": Nếu cần khơi nguồn sáng tạo, hãy dùng nút "Xem trang đầu tiên tìm được" và Gemini sẽ tạo một câu lệnh kèm theo ý tưởng dự án để bạn bắt đầu.
  • Trộn một dự án trong thư viện: Mở một dự án trong Thư viện ứng dụng rồi chọn Sao chép ứng dụng.

Sau khi chạy câu lệnh, bạn sẽ thấy mã và các tệp cần thiết được tạo, cùng với bản xem trước trực tiếp của ứng dụng xuất hiện ở bên phải.

Nội dung nào được tạo?

Khi bạn chạy câu lệnh, AI Studio sẽ tạo một ứng dụng hoàn chỉnh. Theo mặc định, công cụ này sẽ tạo một môi trường toàn ngăn xếp có thể bao gồm:

  • Phía máy khách: giao diện người dùng web (React là giao diện mặc định).
  • Phía máy chủ: một thời gian chạy Node.js cho phép thực hiện các lệnh gọi API bảo mật, kết nối cơ sở dữ liệu và sử dụng gói npm.

Bạn có thể xem mã được tạo bằng cách chọn thẻ trong ngăn xem trước bên phải. Antigravity Agent quản lý một cách thông minh nhiều tệp trên ngăn xếp của bạn, đảm bảo rằng các thay đổi được truyền tải chính xác.

The Antigravity Agent

Antigravity Agent là chức năng AI chính trong Google Antigravity và hiện tại, các thành phần cốt lõi của bộ công cụ tác nhân này đang hỗ trợ trải nghiệm Chế độ tạo trong Google AI Studio. Gemini vượt xa khả năng tạo mã đơn giản bằng cách duy trì ngữ cảnh của toàn bộ dự án, quản lý nhiều tệp và hiểu các chỉ dẫn phức tạp để tạo các ứng dụng ngăn xếp đầy đủ, mạnh mẽ.

Các chức năng chính bao gồm:

  • Nhận biết bối cảnh: duy trì bối cảnh của các câu lệnh trước đó và trạng thái tệp.
  • Quản lý nhiều tệp: xử lý các phần phụ thuộc trên nhiều tệp.
  • Thực thi đã xác minh: xác minh các nội dung cập nhật mã để giảm hiện tượng ảo giác.

Khả năng full-stack

Google AI Studio khai thác sức mạnh của hệ sinh thái web hiện đại, cho phép bạn tạo nhiều thứ hơn là chỉ nguyên mẫu phía máy khách.

  • Thời gian chạy phía máy chủ và npm: sử dụng thư viện rộng lớn gồm các gói npm. Tác nhân sẽ tự động xác định và cài đặt các gói khi cần cho ứng dụng của bạn (ví dụ: các thư viện cụ thể để trực quan hoá dữ liệu hoặc ứng dụng API). Bạn cũng có thể yêu cầu các gói cụ thể nếu muốn.
  • Quản lý bí mật: lưu trữ an toàn các khoá API và bí mật trong trình đơn Settings (Cài đặt). Bạn có thể truy cập vào các khoá này trong mã phía máy chủ, giúp bảo vệ chúng khỏi bị lộ ở phía máy khách.
  • Nhiều người chơi: xây dựng trải nghiệm cộng tác theo thời gian thực ngay trong AI Studio. Thời gian chạy phía máy chủ quản lý trạng thái và các kết nối cần thiết để người dùng tương tác với nhau.
  • Tích hợp Firebase: tự động cung cấp và thiết lập Firebase, bao gồm cả cơ sở dữ liệu Firestore (lưu trữ dữ liệu liên tục) và Xác thực Firebase (quy trình đăng nhập, cụ thể là "Đăng nhập bằng Google"). Tác nhân này xử lý toàn bộ quy trình thiết lập và thậm chí còn viết mã trong ứng dụng của bạn cho các dịch vụ này.

Tìm hiểu thêm về cách phát triển ứng dụng full-stack

Tiếp tục xây dựng

Sau khi Google AI Studio tạo mã ban đầu cho ứng dụng của bạn, bạn có thể tiếp tục tinh chỉnh mã đó:

Tạo trong Google AI Studio

  • Lặp lại với Gemini: Sử dụng bảng trò chuyện ở Chế độ tạo để hỏi Gemini sửa đổi, thêm tính năng mới hoặc thay đổi kiểu.
  • Chỉnh sửa mã trực tiếp: Mở thẻ Mã trong bảng xem trước để chỉnh sửa trực tiếp.

Phát triển bên ngoài

Đối với các quy trình làm việc nâng cao hơn, bạn có thể xuất mã và làm việc trong môi trường mà bạn muốn:

  • Tải xuống và phát triển cục bộ: Xuất mã đã tạo dưới dạng Tệp ZIP rồi nhập mã đó vào trình soạn thảo mã của bạn.
  • Đẩy lên GitHub: Tích hợp mã với các quy trình phát triển và triển khai hiện có bằng cách đẩy mã đó lên một kho lưu trữ GitHub.

Các tính năng chính

Google AI Studio có một số tính năng giúp quá trình xây dựng trở nên trực quan và dễ hiểu:

  • Tạo và lặp lại các ứng dụng toàn diện: Tạo các ứng dụng toàn diện chỉ bằng một câu lệnh và lặp lại thông qua chế độ trò chuyện hoặc chú thích. Chế độ chú thích cho phép bạn làm nổi bật mọi phần trên giao diện người dùng của ứng dụng và mô tả thay đổi bạn muốn.
  • Chia sẻ và triển khai ứng dụng: Bạn có thể chia sẻ các tác phẩm của mình với người khác để cộng tác hoặc giới thiệu tác phẩm. Sau đó, khi ứng dụng của bạn đã sẵn sàng, hãy triển khai ứng dụng đó lên Cloud Run.
  • Thư viện ứng dụng: Thư viện ứng dụng cung cấp một thư viện trực quan về các ý tưởng dự án. Bạn có thể duyệt xem những việc có thể làm với Gemini, xem trước các ứng dụng ngay lập tức và phối lại các ứng dụng đó để tạo ra ứng dụng của riêng mình.

Triển khai hoặc lưu trữ ứng dụng

Sau khi ứng dụng của bạn đã sẵn sàng, bạn có thể triển khai ứng dụng đó:

  • Google Cloud Run: triển khai ứng dụng của bạn dưới dạng một dịch vụ có khả năng mở rộng. Bạn có thể phải trả phí cho Google Cloud Run dựa trên mức sử dụng.
  • GitHub: xuất dự án của bạn sang một kho lưu trữ trên GitHub.

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

Phần này liệt kê các hạn chế hiện tại của chế độ tạo trong Google AI Studio.

Bảo mật khoá API

  • Phía máy khách: không bao giờ sử dụng trực tiếp khoá API thực trong mã phía máy khách.
  • Phía máy chủ: sử dụng tính năng Quản lý bí mật để xử lý các khoá nhạy cảm một cách an toàn trong thời gian chạy phía máy chủ.

Triển khai bên ngoài Google AI Studio

  • Mặc dù bạn có thể triển khai ứng dụng của mình lên Cloud Run cho một URL công khai, nhưng chế độ thiết lập này sẽ sử dụng khoá API của bạn cho tất cả các lệnh gọi Gemini API của người dùng.
    • Các ứng dụng JavaScript chạy phía ứng dụng khách, vì vậy, hãy đảm bảo khoá API chỉ có quyền truy cập tối thiểu để ngăn chặn rò rỉ hoặc sử dụng sai dữ liệu. Ví dụ: người dùng có thể truy cập vào các Cửa hàng tìm kiếm tệp khác trong cùng một dự án thông qua cơ chế này.
  • Triển khai bên ngoài một cách an toàn: Để chạy ứng dụng một cách an toàn bên ngoài AI Studio (ví dụ: sau khi tải tệp zip xuống), bạn phải di chuyển logic sử dụng khoá API sang một thành phần phía máy chủ để ngăn người dùng cuối biết được khoá. Bạn không cần làm việc này nếu triển khai bằng Cloud Run.
  • Cảnh báo về việc để lộ khoá: Bạn tuyệt đối không nên chỉ thay thế phần giữ chỗ bằng một khoá API thực trong môi trường phía máy khách, vì khoá sẽ hiển thị cho mọi người dùng.

Lỗi khi chia sẻ ứng dụng

Nếu bạn chia sẻ ứng dụng của mình và người dùng cuối gặp phải lỗi 403 Access Restricted (Quyền truy cập bị hạn chế) khi sử dụng URL được chia sẻ, thì có thể là do một trong những nguyên nhân sau:

  • Tiện ích trên trình duyệt: các tiện ích bảo vệ quyền riêng tư như Privacy Badger có thể đang chặn ứng dụng. Hãy tắt tiện ích này để tránh gặp lỗi.
  • Vấn đề về bản dựng: có thể có vấn đề với mã hiện tại. Yêu cầu tác nhân "khắc phục mọi vấn đề về bản dựng bằng mã hiện tại", sau đó chia sẻ lại URL.

Câu hỏi thường gặp

Build trong AI Studio là gì?

AI Studio Build là một nền tảng được thiết kế để giúp bạn chuyển từ một câu lệnh đơn giản sang một ứng dụng dựa trên AI, sẵn sàng phát hành bằng Gemini. Mô tả những gì bạn muốn tạo bằng một câu lệnh, Gemini sẽ tạo một ứng dụng cho bạn. Bạn cũng có thể khám phá thư viện của chúng tôi để xem những việc có thể làm với Gemini API và phối lại các ứng dụng để tạo ra ứng dụng của riêng mình.

Tại sao Build gọi Gemini API từ mã phía máy khách?

Thông thường, bạn nên gọi Gemini API từ phía máy chủ để không làm lộ khoá API. Nhưng AI Studio có một proxy Gemini API cho các lệnh gọi phía máy khách, giúp đính kèm khoá API mà không để lộ khoá này trong mã. Hiện tại, chúng tôi tạo các lệnh gọi phía máy khách để sử dụng proxy này, vì proxy này giúp đơn giản hoá mã và cho phép bạn chia sẻ ứng dụng của mình với người khác mà không cần cung cấp khoá API.

Khoá API của tôi có bị lộ khi chia sẻ ứng dụng không?

Đừng sử dụng khoá API thực trong ứng dụng của bạn. Thay vào đó, hãy sử dụng giá trị giữ chỗ. process.env.GEMINI_API_KEY được đặt thành một giá trị giữ chỗ mà bạn có thể sử dụng. Khi một người dùng khác sử dụng ứng dụng của bạn, AI Studio sẽ chuyển các lệnh gọi đến Gemini API, thay thế giá trị phần giữ chỗ bằng khoá API của người dùng (không phải của bạn). Đừng sử dụng khoá API thực trong ứng dụng của bạn, vì mã này có thể hiển thị cho bất kỳ ai xem được ứng dụng của bạn.

Những người có thể thấy ứng dụng của tôi

Theo mặc định, ứng dụng của bạn sẽ ở chế độ riêng tư. Bạn có thể chia sẻ ứng dụng của mình với người dùng khác để cho phép họ sử dụng ứng dụng đó. Những người dùng mà bạn chia sẻ ứng dụng có thể xem mã của ứng dụng và phát triển nhánh mã đó cho mục đích riêng của họ. Nếu bạn chia sẻ ứng dụng của mình với quyền chỉnh sửa, thì những người dùng khác có thể chỉnh sửa mã của ứng dụng.

Tôi có thể chạy các ứng dụng bên ngoài AI Studio không?

Bạn có thể triển khai ứng dụng lên Cloud Run từ AI Studio. Thao tác này sẽ cung cấp cho ứng dụng của bạn một URL công khai. Ứng dụng này được triển khai cùng với một máy chủ proxy sẽ giữ kín khoá API của bạn. Tuy nhiên, ứng dụng được triển khai sẽ sử dụng khoá API của bạn cho tất cả các lệnh gọi Gemini API của người dùng. Bạn cũng có thể tải ứng dụng xuống dưới dạng tệp zip. Nếu bạn thay thế giá trị giữ chỗ bằng một khoá API thực, thì khoá đó vẫn sẽ hoạt động. Nhưng bạn không nên triển khai ứng dụng theo cách này, vì bất kỳ người dùng nào cũng có thể thấy khoá API. Để chạy một ứng dụng một cách an toàn bên ngoài AI Studio, bạn cần di chuyển một số logic phía máy chủ, để khoá API không còn bị lộ nữa.

Tôi có thể phát triển ứng dụng trên thiết bị của mình bằng các công cụ riêng rồi chia sẻ chúng tại đây không?

Chức năng này hiện chưa hoạt động. Chúng tôi rất vui khi có thể hỗ trợ nhiều trường hợp sử dụng hơn cho các ứng dụng trong tương lai. Vui lòng cân nhắc gửi ý kiến phản hồi cho chúng tôi nếu bạn có ý tưởng cụ thể.

Làm cách nào để sử dụng cơ sở dữ liệu hoặc bộ nhớ khác với các ứng dụng của tôi?

Các ứng dụng AI Studio là những ứng dụng tiêu chuẩn chạy trong một vùng chứa Cloud Run. Bạn có thể sử dụng bất kỳ giải pháp lưu trữ nào mà bạn có thể kết nối qua mạng, miễn là không có tường lửa ngăn chặn quyền truy cập từ dải IP động.

Chúng tôi đang nỗ lực bổ sung tính năng hỗ trợ trực tiếp cho bộ nhớ trong tương lai. Bạn sẽ có thể định cấu hình bộ nhớ trực tiếp trong AI Studio.

Để đảm bảo người xem biết về việc một ứng dụng sử dụng webcam hoặc các thiết bị khác của họ, chúng tôi yêu cầu họ xác nhận thêm trước khi ứng dụng có thể truy cập vào các API Navigator này. Nhà sáng tạo ứng dụng có thể thêm các yêu cầu cấp quyền này vào tệp metadata.json của ứng dụng. Ví dụ:

{
  "name": "My app",
  "requestFramePermissions": [
    "microphone",
    "camera",
    "display-capture",
    "geolocation",
    "bluetooth",
    "clipboard-read",
    "serial",
    "usb"
  ]
}

Các giá trị được hỗ trợ cho requestFramePermissions là một phần trong số các tính năng tiêu chuẩn được kiểm soát theo chính sách.

Làm cách nào để sử dụng GitHub với các ứng dụng của tôi?

Tính năng tích hợp GitHub của AI Studio cho phép bạn tạo kho lưu trữ cho công việc của mình và xác nhận các thay đổi mới nhất. Chúng tôi hiện không hỗ trợ việc kéo các thay đổi từ xa.

Tôi có thể cấp cho người dùng khác quyền chỉnh sửa ứng dụng của mình không?

Tính năng này hiện chưa được hỗ trợ nhưng sẽ sớm ra mắt.

Tại sao ứng dụng của tôi bị gắn cờ do vi phạm chính sách?

Chúng tôi có các hệ thống tự động xem xét ứng dụng để đảm bảo ứng dụng tuân thủ chính sách của chúng tôi. Nếu chúng tôi phát hiện thấy một ứng dụng vi phạm chính sách của chúng tôi, thì ứng dụng đó sẽ bị xoá khỏi AI Studio. Các lỗi vi phạm chính sách có thể bao gồm nhưng không giới hạn ở những lỗi sau:

  • Ứng dụng chứa phần mềm độc hại, nội dung lừa đảo hoặc mạo danh
  • Ứng dụng hiển thị hoặc phát tán nội dung vi phạm chính sách về hình ảnh xâm hại tình dục trẻ em
  • Ứng dụng hiển thị hoặc phân phối nội dung vi phạm chính sách về hành vi quấy rối
  • Ứng dụng hiển thị hoặc phân phối nội dung vi phạm chính sách về lời nói hận thù
  • Ứng dụng hiển thị hoặc phân phối nội dung vi phạm chính sách về nạn buôn người
  • Ứng dụng hiển thị hoặc phân phối nội dung vi phạm chính sách về nội dung khiêu dâm
  • Ứng dụng hiển thị hoặc phân phối nội dung vi phạm chính sách về bạo lực và máu me
  • Ứng dụng hiển thị hoặc phân phối nội dung vi phạm chính sách về nội dung gây hại hoặc nguy hiểm

Nếu ứng dụng của bạn bị gắn cờ vì vi phạm chính sách và bạn cho rằng đó là do nhầm lẫn, thì bạn có thể gửi đơn kháng nghị. Việc nhiều lần vi phạm chính sách của chúng tôi có thể dẫn đến việc bạn bị chấm dứt quyền truy cập vào AI Studio.

Tôi có trách nhiệm gì với tư cách là nhà phát triển ứng dụng?

Xin lưu ý rằng, với tư cách là chủ sở hữu ứng dụng, bạn chịu trách nhiệm về hành vi của ứng dụng và mọi dữ liệu mà ứng dụng xử lý. Nội dung như vậy bao gồm:

  • Tuân thủ pháp luật và tôn trọng quyền của bên thứ ba: Đảm bảo ứng dụng của bạn tuân thủ tất cả luật và quy định hiện hành, đồng thời không vi phạm quyền của người khác, bao gồm cả quyền tài sản trí tuệ và quyền riêng tư.
  • Giám sát nội dung: Việc tuân thủ các điều khoản bổ sung có thể áp dụng cho các dịch vụ khác mà ứng dụng của bạn sử dụng. Ví dụ: Điều khoản dịch vụ của Google Cloud (áp dụng cho Firestore) yêu cầu những khách hàng lưu trữ nội dung của bên thứ ba phải xuất bản các chính sách xác định nội dung bị cấm (ví dụ: nội dung bất hợp pháp) và giám sát sự xuất hiện của nội dung bất hợp pháp đó.
  • Triển khai an toàn: Triển khai các biện pháp bảo vệ và công cụ kiểm duyệt cần thiết để ngăn chặn việc sử dụng sai mục đích ứng dụng của bạn.

Lưu ý các hạn chế về việc sử dụng trong Điều khoản dịch vụ.

Điều khoản dịch vụ bổ sung của Gemini API áp dụng cho việc sử dụng các ứng dụng có trong thư viện ứng dụng của AI Studio, trừ phi có quy định khác.

Bước tiếp theo