Agent Platform Gemini API

Nếu bạn mới sử dụng Gemini API, thì Gemini Developer API là nhà cung cấp API được đề xuất cho Nhà phát triển Android. Tuy nhiên, nếu có yêu cầu cụ thể về vị trí lưu trữ dữ liệu hoặc bạn đã được nhúng vào hệ sinh thái Google Cloud, thì bạn có thể sử dụng Agent Platform Gemini API (trước đây là Vertex AI) với Firebase AI Logic để truy cập vào các mô hình Gemini Pro và Flash.

Bắt đầu

Trước khi tương tác với Agent Platform Gemini API ngay trong ứng dụng của mình, bạn có thể thử nghiệm các câu lệnh trong Agent Studio.

Thiết lập dự án Firebase và kết nối ứng dụng của bạn với Firebase

Khi bạn đã sẵn sàng gọi API từ ứng dụng của mình, hãy làm theo hướng dẫn trong "Bước 1" của hướng dẫn bắt đầu sử dụng Firebase AI Logic để thiết lập Firebase và bật các API cũng như dịch vụ bắt buộc.

Thêm phần phụ thuộc vào Gradle

Thêm các phần phụ thuộc Gradle sau đây vào mô-đun ứng dụng:

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.17.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")
}

dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:34.17.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

Định cấu hình trình cung cấp gỡ lỗi App Check cho quá trình phát triển cục bộ

Kể từ đầu tháng 7 năm 2026, trong quy trình thiết lập có hướng dẫn cho AI Logic trong bảng điều khiển của Firebase, tính năng Kiểm tra ứng dụng Firebase sẽ tự động được thực thi để bảo vệ Gemini API. Đối với quá trình phát triển cục bộ, bạn cần định cấu hình nhà cung cấp dịch vụ gỡ lỗi Kiểm tra ứng dụng để bỏ qua chứng thực trong khi vẫn duy trì việc thực thi Kiểm tra ứng dụng.

1. Trong bản gỡ lỗi, hãy định cấu hình tính năng Kiểm tra ứng dụng để sử dụng nhà cung cấp gỡ lỗi:

   Kotlin

   Firebase.initialize(context = this)
   Firebase.appCheck.installAppCheckProviderFactory(
       DebugAppCheckProviderFactory.getInstance(),
   )
   

   Java

   FirebaseApp.initializeApp(/*context=*/ this);
   FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
   firebaseAppCheck.installAppCheckProviderFactory(
           DebugAppCheckProviderFactory.getInstance());
   

2. Lấy mã thông báo gỡ lỗi:

   1. Chạy ứng dụng trong trình mô phỏng hoặc trên thiết bị thử nghiệm.

   2. Tìm mã gỡ lỗi Kiểm tra ứng dụng trong nhật ký của bạn. Ví dụ:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. Sao chép mã thông báo (ví dụ: 123a4567-b89c-12d3-e456-789012345678).

3. Đăng ký mã thông báo gỡ lỗi với Kiểm tra ứng dụng:

   1. Trong bảng điều khiển của Firebase, hãy chuyển đến thẻ Bảo mật > Kiểm tra ứng dụng > Ứng dụng.

   2. Tìm ứng dụng của bạn, nhấp vào trình đơn mục bổ sung (more_vert), rồi chọn Quản lý mã gỡ lỗi.

   3. Làm theo hướng dẫn trên màn hình để đăng ký mã gỡ lỗi.

Để biết thông tin chi tiết về nhà cung cấp dịch vụ gỡ lỗi (bao gồm cả cách lấy mã thông báo gỡ lỗi mới), hãy xem tài liệu chính thức về Kiểm tra ứng dụng.

Khởi chạy mô hình tạo sinh

Bắt đầu bằng cách tạo một thực thể GenerativeModel và chỉ định tên mô hình:

val model = Firebase.ai(backend = GenerativeBackend.agentPlatform())
    .generativeModel("gemini-3.5-flash")
AgentPlatformGeminiApi.kt

GenerativeModel firebaseAI = FirebaseAI.getInstance(GenerativeBackend.agentPlatform())
        .generativeModel("gemini-3.5-flash");

GenerativeModelFutures model = GenerativeModelFutures.from(firebaseAI);
AgentPlatformGeminiApiJava.java

Trong tài liệu về Firebase, bạn có thể tìm hiểu thêm về các mô hình Gemini hiện có. Bạn cũng có thể tìm hiểu về cách định cấu hình các thông số mô hình.

Tạo văn bản

Để tạo câu trả lời dạng văn bản, hãy gọi generateContent() bằng câu lệnh của bạn.

suspend fun generateText(model: GenerativeModel) {
    // Note: generateContent() is a suspend function, which integrates well
    // with existing Kotlin code.
    val response = model.generateContent("Write a story about a magic backpack.")
    // ...
}
AgentPlatformGeminiApi.kt

Content prompt = new Content.Builder()
        .addText("Write a story about a magic backpack.")
        .build();

ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        // ...
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);
AgentPlatformGeminiApiJava.java

Tương tự như Gemini Developer API, bạn cũng có thể truyền hình ảnh, âm thanh, video và tệp bằng câu lệnh văn bản. Để biết thông tin chi tiết, hãy xem bài viết Tương tác với Gemini Developer API từ ứng dụng của bạn.

Để tìm hiểu thêm về Firebase AI Logic SDK, hãy xem tài liệu về Firebase.