Xây dựng ứng dụng AI bằng hệ sinh thái của Google

1. Trước khi bắt đầu

Quá trình phát triển phần mềm đã thay đổi. Những nhà phát triển thành công nhất không chỉ viết mã mà còn điều phối các công cụ AI và tác nhân AI để xây dựng ứng dụng tốt hơn và nhanh hơn. Hệ sinh thái công cụ của Google cung cấp một bộ công cụ toàn diện cho toàn bộ vòng đời: tạo giao diện người dùng, tạo nguyên mẫu và triển khai ứng dụng, phát triển tính năng AI, cũng như tích hợp phần phụ trợ an toàn và có thể mở rộng. Trong lớp học lập trình này, bạn sẽ sử dụng Google Stitch để thiết kế giao diện người dùng, Google AI Studio để lập trình theo cảm hứng và triển khai ứng dụng, còn Firebase để phát triển các tính năng AI và lưu trữ thông tin trong một phần phụ trợ bảo mật, có thể mở rộng.

Ứng dụng bạn sẽ xây dựng trong lớp học lập trình này có tên là Decide For Me (Quyết định giúp tôi) – một trợ lý ra quyết định cho những người thiếu quyết đoán khi phải đối mặt với các lựa chọn trong cuộc sống (chẳng hạn như chuyển căn hộ, thay đổi nghề nghiệp hoặc chọn một sở thích). Người dùng nhập một tình huống khó xử và những ưu tiên của họ trong cuộc sống, sau đó ứng dụng sẽ dùng AI để giúp người dùng đưa ra quyết định dựa trên những yếu tố giúp giảm thiểu sự thất vọng về lâu dài. Ứng dụng cũng cung cấp cho người dùng bước đầu tiên cụ thể. Phiên bản cuối cùng của ứng dụng sẽ tương tự như sau:

Ảnh chụp màn hình ứng dụng Decide For Me cho thấy giao diện trò chuyện và bảng điều khiển mức độ ưu tiên

Kiến thức bạn sẽ học được

  • Thiết kế giao diện người dùng bằng Google Stitch.
  • Lập trình theo cảm hứng cho một ứng dụng web bằng Google AI Studio.
  • Sử dụng Firebase để phát triển các tính năng AI và lưu trữ thông tin trên đám mây.
  • Triển khai ứng dụng web vào môi trường thực tế bằng Google AI Studio (dựa trên Cloud Run).

2. Thiết kế giao diện người dùng bằng Stitch

  1. Tải hình ảnh minh hoạ (DecideForMeScreen.jpeg) xuống. Lưu hình ảnh đó vào một thư mục trên thiết bị để bạn có thể tìm thấy.
  2. Chuyển đến Stitch, tìm trường nhập dữ liệu rồi chọn Web. (Trong lớp học lập trình này, bạn sẽ tập trung vào trải nghiệm web, nhưng bạn cũng có thể dùng Stitch để tạo màn hình di động.)
  3. Tải hình ảnh mô phỏng lên:
    1. Nhấp vào + (nút thêm).
    2. Chọn Tải tệp lên.
    3. Đính kèm hình ảnh bạn đã tải xuống trong bước thiết lập (DecideForMeScreen.jpeg). Bản mô phỏng vẽ tay này cho phép bạn kiểm thử các khả năng đa phương thức của Stitch.
  4. Sao chép câu lệnh sau rồi dán vào trường nhập dữ liệu:
    # General Guidance
    Create a modern, clean, and highly polished UI for a web application called
    "Decide For Me" - a hyper-rational decision assistant.
    
    CRITICAL: Replicate the exact layout, structure, and element placement shown in
    the hand-drawn mockup file DecideForMeScreen.jpeg. Do not add any extra menus,
    sidebars, buttons, or top/bottom navigation bars that are not explicitly drawn
    in the file. Stick strictly to the skeleton provided in the mockup.
    
    # Layout & Structure
    - Two-Column Split Screen:
      - Left Side (Main Chat Area): Takes up roughly 70-75% of the screen width. It
        should feel like a premium, focused workspace.
      - Right Side (Configuration Panel): A sidebar taking up 25-30% of the screen
        width with a distinct, subtle background color to separate it from the
        chat.
    
    # Right Panel: Configuration Screen
    - Header: Title it "My Priorities" with a clean, minimalist typography.
    - Content Card: A styled card containing a text box or paragraph area
      showcasing the user's priorities.
    - Interactions: Include a clear "Edit Priorities" button. When clicked, this
      area should visually toggle into an editable textarea or input field.
    
    # Left Panel: Chat & Dilemma Decision Screen
    - Chat History: A clean vertical flow of message bubbles.
      - The first message bubble must be aligned to the left (system message) and
        say: "Tell me your dilemma". Use a friendly, neutral background color for
        this bubble.
    - Bottom Input Area: Instead of a traditional single-line chat bar, create a
      unified, beautiful "Decision Submission" layout positioned at the bottom:
      - Dual Input Fields: Place two horizontal or cleanly stacked input fields.
        - Input 1 label: "Option A"
        - Input 2 label: "Option B"
      - Action Button: A prominent, styled "Go" action button to trigger the
        reasoning loop.
    
    # Theme & Aesthetic
    - Vibe: Hyper-rational, clean, trustworthy, and modern. Use a sophisticated
      color palette (e.g., deep slates, clean whites/grays, and a sharp accent
      color like a subtle indigo or teal for active states and buttons).
    - Spacing & Typography: Use generous whitespace, soft rounded corners
      (border-radius) for cards and buttons, and a highly legible sans-serif font.
    
  5. Nhấp vào mũi tên tạo ở góc dưới cùng bên phải của trường nhập dữ liệu. Stitch tạo màn hình và toàn bộ hệ thống thiết kế, bao gồm bảng màu, các lựa chọn phông chữ, hệ thống biểu tượng và giao diện chung cho các phần tử trên giao diện người dùng:

Giao diện Stitch cho thấy hệ thống thiết kế và thiết kế giao diện người dùng được tạo cho tính năng Decide For Me

3. Tạo ứng dụng bằng Google AI Studio

  1. Tạo dự án Firebase:
    1. Đăng nhập vào bảng điều khiển của Firebase bằng chính Tài khoản Google mà bạn đã dùng cho Stitch.
    2. Nhấp vào nút để tạo dự án mới, sau đó nhập tên dự án (ví dụ: Decider App).
    3. Nhấp vào Tiếp tục.
    4. Nếu được nhắc, hãy xem và chấp nhận điều khoản của Firebase, sau đó nhấp vào Tiếp tục.
    5. (Không bắt buộc) Bật tính năng trợ giúp AI trong bảng điều khiển của Firebase (gọi là "Gemini trong Firebase").
    6. Đối với lớp học lập trình này, bạn không cần Google Analytics, vì vậy, hãy tắt lựa chọn Google Analytics.
    7. Nhấp vào Create project (Tạo dự án), đợi dự án cấp phép rồi nhấp vào Continue (Tiếp tục).
  2. Xuất màn hình bạn đã tạo trong Stitch sang Google AI Studio:
    1. Nhấp vào bản thiết kế được tạo trong Stitch.
    2. Nhấp vào Xuất ở góc trên cùng bên phải màn hình.
    3. Xác nhận rằng bạn đã chọn Google AI Studio.
    4. Di chuyển xuống trường Nội dung mô tả.
  3. Sao chép câu lệnh sau rồi dán vào trường Mô tả. Thay thế [FIREBASE_PROJECT_ID] bằng mã dự án thực tế ở bước 1 (nếu không nhớ mã dự án, bạn có thể tìm mã đó trong phần Cài đặt dự án):
    # General Guidance
    Build the "Decide For Me" app: A hyper-rational decision assistant for
    chronically indecisive people facing life choices (moving apartments, changing
    careers, picking a hobby). The user enters a dilemma and their top priorities
    in life. The app will help with the decision. Follow the instructions below to
    build it:
    
    # UI Instructions
    Using the design artifacts exported from Stitch (the PNG image and HTML file),
    build a fully functional web application that accurately mirrors the design and
    layout.
    
    # App Architecture & Initialization Instructions
    - Initialize the latest Firebase JS SDK for client-side services. Use the
      Firebase project with ID [FIREBASE_PROJECT_ID].
    - Enable Firebase Authentication in this project using the Google provider.
      If a user is not logged in, show a clean, minimalist sign-in state. If the
      user is logged in, take them directly to the dilemma decision screen.
    - Initialize Firebase App Check in debug mode with the following code:
      `self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;`
      `initializeAppCheck(app, { /* App Check options */ });`
    
    
    # State & Database Management Instructions
    - User Priorities:
      - Once authenticated, pull the user's saved priorities from Firebase
        Firestore at the path: `users/{userId}`. Each document should contain one
        string field: 'priorities'.
      - Bind this data to the Right Panel ("My Priorities").
      - When the user clicks the "Edit" button, toggle the view to a textarea, with
        a 'save' button. When saved, write the updated string back to
        `users/{userId}`.
      - Make sure to implement and deploy strong Security Rules for Firestore.
    
    # UI Stream Update & Display Instructions
    - Once the user submits option A and option B in the dilemma decision screen,
      display both options as a single message on the user side of the chat. Then,
      display a sleek loading state in the main chat panel. Leave the app in this
      "loading" state and do nothing else, we will process both options and build
      the server-side thinking later.
    
  4. Nhấp vào Xây dựng bằng Google AI Studio. Thao tác này sẽ mở Google AI Studio trong một thẻ mới và chuyển các tệp thiết kế cũng như câu lệnh của bạn sang:
    1. Xác nhận rằng câu lệnh đã được chuyển hoàn toàn.
    2. Nếu bạn chỉ thấy một phần của câu lệnh, hãy dán lại toàn bộ câu lệnh.
  5. Nhấp vào Build (Bản dựng). Google AI Studio bắt đầu tạo ứng dụng Decide For Me theo câu lệnh và thiết kế giao diện người dùng của bạn:
    1. Trong khi tạo, Gemini sẽ đề xuất các thiết kế giao diện người dùng thay thế (bỏ qua các thiết kế này trong lớp học lập trình này, nhưng bạn có thể chọn các thiết kế khác trong tương lai).
    2. Khi được nhắc bật Firebase, hãy nhấp vào Bật.
  6. Kiểm tra và xác minh ứng dụng được tạo:
    1. Kiểm thử ứng dụng trong thẻ Preview (Xem trước).
    2. Chuyển sang thẻ Mã để xem tất cả tệp và mã được tạo.
    3. Google AI Studio cũng đã tạo một dự án Firebase, bật Xác thực Firebase và Firestore, đồng thời định cấu hình Firebase trong toàn bộ mã nguồn của bạn. Bạn sẽ truy cập và làm việc với dự án Firebase này trong bước tiếp theo của lớp học lập trình này.

4. Đăng ký mã gỡ lỗi Kiểm tra ứng dụng

Khi tạo ứng dụng, Google AI Studio sẽ tạo một dự án Firebase và kết nối ứng dụng của bạn với dự án đó. Bạn cần truy cập vào dự án Firebase này và đăng ký môi trường phát triển của mình bằng một dịch vụ bảo mật quan trọng có tên là Kiểm tra ứng dụng Firebase.

Truy cập vào dự án Firebase của bạn

  1. Tìm mã dự án của dự án Firebase do Google AI Studio tạo:
    1. Chuyển sang thẻ Code (Mã) trong Google AI Studio.
    2. Mở tệp firebase-applet-config.json.
    3. Sao chép giá trị của trường projectId.
  2. Chuyển đến bảng điều khiển của Firebase rồi tìm dự án bằng mã nhận dạng này.

Đăng ký mã thông báo gỡ lỗi

Ứng dụng của bạn có thể sử dụng tính năng Kiểm tra ứng dụng Firebase để bảo vệ các dịch vụ phụ trợ và mô hình AI khỏi hành vi sai trái bằng cách đảm bảo rằng lưu lượng truy cập đến chỉ bắt nguồn từ các ứng dụng hợp pháp.

Vì ứng dụng của bạn đang chạy trong môi trường xem trước của Google AI Studio, nên ứng dụng sẽ sử dụng nhà cung cấp dịch vụ gỡ lỗi Kiểm tra ứng dụng (self.FIREBASE_APPCHECK_DEBUG_TOKEN = true). Khi ứng dụng web tải, Firebase sẽ tự động xuất mã gỡ lỗi sang bảng điều khiển dành cho nhà phát triển của trình duyệt.

  1. Tìm mã thông báo gỡ lỗi:
    1. Trong Google AI Studio, hãy mở công cụ cho nhà phát triển của trình duyệt trong khi xem bản xem trước ứng dụng:
      • Chrome, Edge hoặc Firefox: Nhấn phím F12 (hoặc nhấp chuột phải vào vị trí bất kỳ trong bản xem trước rồi chọn Kiểm tra), sau đó chọn thẻ Bảng điều khiển.
      • macOS: Nhấn tổ hợp phím Cmd+Option+I, rồi chọn thẻ Console (Bảng điều khiển).
    2. Trong nhật ký bảng điều khiển, hãy tìm thông báo gỡ lỗi của Kiểm tra ứng dụng:
      AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678".
      You will need to safelist it in the Firebase console for it to work.
      
    3. Sao chép chuỗi mã thông báo (không có dấu ngoặc kép).
  2. Đăng ký mã thông báo gỡ lỗi:
    1. Trong bảng điều khiển của Firebase, hãy chuyển đến phần Bảo mật > Kiểm tra ứng dụng > thẻ Ứng dụng.
    2. Tìm ứng dụng web của bạn trong danh sách, nhấp vào trình đơn có biểu tượng ba dấu chấm (⋮) rồi chọn Quản lý mã gỡ lỗi.
    3. Nhấp vào Add debug token (Thêm mã thông báo gỡ lỗi), dán mã thông báo đã sao chép, nhập tên (chẳng hạn như Google AI Studio Preview) rồi nhấp vào Save (Lưu).
    Ảnh chụp màn hình mục Quản lý mã gỡ lỗi trong bảng điều khiển của Firebase

5. Kiểm thử ứng dụng

Giờ đây, khi dự án của bạn đã được kết nối và mã thông báo gỡ lỗi đã được đăng ký với Kiểm tra ứng dụng, hãy thử nghiệm các tính năng cơ bản: Xác thực và Firestore.

  1. Kiểm thử quy trình xác thực người dùng và lưu các mức độ ưu tiên:
    1. Trong bản xem trước ứng dụng Decide For Me trong Google AI Studio, hãy kiểm thử màn hình xác thực bằng cách đăng nhập bằng Tài khoản Google.
    2. Lưu các ưu tiên trong cuộc sống bằng bảng điều khiển bên phải (Ưu tiên của tôi).
  2. Xác minh việc xác thực trong bảng điều khiển của Firebase:
    1. Chuyển đến bảng điều khiển của Firebase rồi mở phần Xác thực.
    2. Xác nhận rằng Tài khoản Google mà bạn đã dùng để xác thực trong ứng dụng Decide For Me có trong danh sách:
    Trang Xác thực trong bảng điều khiển của Firebase cho thấy Tài khoản Google đã xác thực
  3. Xác minh bộ nhớ dữ liệu của Firestore:
    1. Mở Firestore trong bảng điều khiển của Firebase.
    2. Xác nhận rằng các mức độ ưu tiên của bạn được lưu trữ trong một tài liệu theo đường dẫn users/{userId}:
    Cơ sở dữ liệu Firestore trong bảng điều khiển của Firebase cho thấy các mức độ ưu tiên được lưu trữ trong users/{userId}

6. Xây dựng quy trình Decider dựa trên AI bằng Firebase

Ứng dụng của bạn sẽ dùng AI để hỗ trợ các hành động Quyết định cho tôi. Bạn có thể sử dụng Firebase để xây dựng quy trình Decider dựa trên AI này.

Thiết lập Firebase AI Logic

  1. Bật Gemini Developer API trong Firebase AI Logic:
    1. Mở Firebase AI Logic trong bảng điều khiển của Firebase, rồi nhấp vào Bắt đầu.
    2. Chọn Gemini Developer API rồi làm theo hướng dẫn trong bảng điều khiển để bật API này.
  2. Định cấu hình chế độ cài đặt Firebase AI Logic:
    1. Chuyển đến thẻ Cài đặt.
    2. Chuyển tuỳ chọn Thực thi chế độ chỉ dùng mẫu sang trạng thái Đã thực thi.
    3. Chuyển lựa chọn Thực thi chế độ người dùng đã xác thực sang Đã thực thi.

Tạo mẫu câu lệnh phía máy chủ

Trong lớp học lập trình này, bạn sẽ sử dụng mẫu câu lệnh phía máy chủ để tương tác với Gemini API thông qua Firebase AI Logic.

Trước khi tiếp tục với mẫu, hãy xem nội dung sau để hiểu lý do tại sao việc lưu trữ cấu hình mô hình, hướng dẫn hệ thống và câu lệnh phía máy chủ lại quan trọng:

  • Bảo vệ tài sản trí tuệ: Lấy câu lệnh khỏi thiết bị của khách hàng và bảo mật câu lệnh đó trên phần phụ trợ.
  • Ngăn chặn các cuộc tấn công chèn câu lệnh: Ứng dụng khách chỉ có thể điền các biến cụ thể bằng quy trình xác thực giản đồ phụ trợ.
  • Cập nhật mà không cần phát hành ứng dụng: Bạn có thể cập nhật câu lệnh, chỉ dẫn hệ thống và cấu hình mô hình trong bảng điều khiển mà không cần phát hành phiên bản ứng dụng mới.

Sau đây là cách tạo và kiểm thử mẫu câu lệnh phía máy chủ:

  1. Tạo mẫu câu lệnh phía máy chủ:
    1. Chuyển đến thẻ Mẫu câu lệnh.
    2. Nhấp vào Tạo mẫu.
    3. Chọn Mẫu trống.
    4. Tạo mẫu đầu tiên bằng cách sử dụng thông tin sau:
      • Tên mẫu: Quy trình quyết định
      • Mã mẫu: decider-flow
      • Cấu hình (frontmatter)
        model: "gemini-3.5-flash-lite"
        input:
          schema:
            priorities: "string, user's core priorities"
            optionA: "string, option A under consideration"
            optionB: "string, option B under consideration"
        output:
          format: json
          schema:
            verdict: string
            justification: string
            firstStep: string
        
      • Câu lệnh và chỉ dẫn hệ thống (không bắt buộc)
        {role "system"}
        You are the Decider Agent, a multi-stage reasoning engine that
        combines the roles of an honest and polite behavioral economist, a
        long-term strategic forecaster, and an executive decision coach.
        Your job is to take a user's dilemma and their core priorities, run
        them through a rigorous, adversarial 3-phase thinking process, and
        output a highly analytical, reasoning-backed final verdict. You must be
        direct, sharp, and realistic. Do not give generic platitudes or claim
        that "both options are great." You must force a clear choice.
        
        {role "user"}
        # Context & Inputs
        You are analyzing a critical life decision for the user. Base your
        entire multi-phase reasoning flow strictly on these three specific
        inputs:
        - User's Core Priorities: {{priorities}}
        - Option A under consideration: {{optionA}}
        - Option B under consideration: {{optionB}}
        
        Execute your reasoning flow through the following three phases:
        
        # Phase 1: Cynical Breakdown (Input-Driven Analysis)
        Analyze {{optionA}} and {{optionB}} strictly through the lens of the
        user's explicit {{priorities}}. Do not evaluate them in a vacuum.
        - Identify the hidden flaws, compromises, and psychological costs
          embedded in both choices.
        - Pinpoint exactly how {{optionA}} could directly conflict with or
          undermine their {{priorities}}.
        - Pinpoint exactly how {{optionB}} could directly conflict with or
          undermine their {{priorities}}.
        - Uncover any cognitive biases (like status quo bias or loss aversion)
          the user might be falling for in either option.
        
        # Phase 2: Long-Term Regret Projection
        Project the user 5 years into the future. Apply the Regret Minimization
        Framework to both paths:
        - The {{optionA}} Timeline: Quantify the absolute worst-case, deep,
          structural 5-year regret of choosing this path. Focus heavily on
          failures of courage vs. failures of action based on their
          {{priorities}}.
        - The {{optionB}} Timeline: Quantify the matching 5-year regret for
          this path.
        - Contrast these two timelines. Which option carries the kind of regret
          that fundamentally breaks the user's {{priorities}}?
        
        # Phase 3: Final Recommendation & Action Step
        Synthesize the cynical critiques and long-term regret scores.
        Weigh them against the user's {{priorities}} to determine which
        choice minimizes long-term disappointment.
        - Verdict: You must declare either {{optionA}} or {{optionB}} as the
          definitive winner. No compromise, no "it depends," and no hybrid
          options.
        - Justification: Provide a sharp, reasoning-backed explanation showing why
          the losing option was eliminated based on the Phase 1 and Phase 2
          analysis.
        - First Step: Give one microscopic, low-friction task the user can
          execute within the next 15 minutes to commit to or move toward the
          chosen verdict.
        
        Thêm một {} bổ sung xung quanh {role "system"} và {role "user"} để viết chỉ dẫn hệ thống và câu lệnh theo đúng cú pháp: 9db2a4f2c5cf2ec7.png
      • Dữ liệu đầu vào thử nghiệm
        {
          "priorities": "Be financially stable, have a good work-life balance where I can travel twice a year",
          "optionA": "Buy a house for 615000 British pounds with a mortgage of 2800 per month for the next 35 years",
          "optionB": "Keep renting for 2400 per month for the foreseeable"
        }
        
  2. Nhấp vào Lưu mẫu.
  3. Kiểm thử mẫu:
    1. Nhấp vào Chạy thử nghiệm câu lệnh.
    2. Tìm Câu trả lời thử nghiệm và kiểm tra để đảm bảo câu trả lời đó có tất cả các trường bạn đã chỉ định trong câu lệnh (verdict, justification và firstStep).
    3. Nếu mọi thứ đều khớp với phản hồi dự kiến, hãy khoá mẫu bằng biểu tượng ổ khoá ở góc trên cùng bên phải của mẫu để đảm bảo tính ổn định của phiên bản và ngăn chặn các nội dung sửa đổi ngoài ý muốn.

Mẫu của bạn đã sẵn sàng để ứng dụng sử dụng!

7. Sử dụng mẫu câu lệnh Người quyết định trong ứng dụng

Yêu cầu ứng dụng web của bạn sử dụng mẫu:

  1. Quay lại ứng dụng của bạn trong Google AI Studio.
  2. Yêu cầu tác nhân Google AI Studio triển khai hành động Quyết định giúp tôi:
    1. Sao chép câu lệnh sau:
      Now let's implement the "Decide For Me" button action. When clicked, it
      should call the Firebase AI Logic SDK using a Template Generative Model.
      The prompt is stored in a prompt template with the id "decider-flow". When
      calling the API, pass the following variables as the input payload object:
      - priorities
      - optionA
      - optionB
      
      The API will return a JSON object. Handle the response asynchronously and
      extract:
      - verdict
      - justification
      - firstStep
      
      Once the data is received, update the UI state to append a new message to
      the chat array. Ensure it renders as a system chat bubble positioned on
      the left side of the chat screen, mapping these three fields clearly into
      the bubble's layout.
      
      Please provide the necessary front-end component state updates and the
      Firebase SDK call.
      
    2. Dán câu lệnh vào ô nhập nội dung trò chuyện của Google AI Studio rồi nhấp vào Gửi.
  3. Xác minh cấu hình và thử nghiệm trợ lý quyết định:
    1. Đợi cho đến khi Google AI Studio hoàn tất việc thêm Firebase AI Logic vào ứng dụng của bạn.
    2. Chuyển sang thẻ Code (Mã) và đảm bảo rằng có khoá API trong tệp firebase-applet-config.json. Nếu khoá API Firebase không có trong tệp cấu hình, hãy yêu cầu Google AI Studio nhập khoá đó.
    3. Chuyển sang thẻ Xem trước
    4. Gửi phương án A và B, đồng thời xác minh rằng AI trả về phán quyết, lý do và bước đầu tiên.

Để tham khảo, mã do Google AI Studio tạo sẽ có dạng như sau:

const aiInstance = getAI(app);
const templateModel = getTemplateGenerativeModel(aiInstance);

const result = await templateModel.generateContent('decider-flow', {
  priorities: priorities,
  optionA: optA,
  optionB: optB
});

const rawText = result.response.text();

// Parse response text to extract fields
const cleaned = rawText.replace(/```json|```/g, '').trim();
const parsedData: { verdict?: string; justification?: string; firstStep?: string } = JSON.parse(cleaned);

const verdict = parsedData.verdict;
const justification = parsedData.justification;
const firstStep = parsedData.firstStep;

Gỡ lỗi và giám sát yêu cầu

Nếu ứng dụng của bạn gặp lỗi, không tạo được phản hồi hoặc bạn muốn kiểm tra chi tiết lưu lượng truy cập API, hãy sử dụng các công cụ giám sát và phân tích tích hợp sẵn của Firebase AI Logic:

  1. Trong bảng điều khiển của Firebase, hãy chuyển đến Dịch vụ AI > Logic AI > thẻ Giám sát bằng AI.
  2. Kiểm tra các chỉ số định lượng trên trang tổng quan:
    • Số lượng và trạng thái yêu cầu: Xác minh xem các yêu cầu đến có đến được phần phụ trợ và trả về 200 OK hay không, hoặc không thực hiện được do lỗi máy khách hoặc lỗi phía máy chủ.
    • Độ trễ: Kiểm tra biểu đồ độ trễ để xem thời gian phản hồi hai đầu.
    • Số lượng mã thông báo: Theo dõi mức sử dụng mã thông báo đầu vào và đầu ra cho mỗi yêu cầu.
  3. Kiểm tra từng dấu vết yêu cầu để gỡ lỗi chuyên sâu:Nhấp vào một dấu vết yêu cầu cụ thể trong bảng dấu vết để kiểm tra tải trọng của dấu vết đó.
    • Thông tin đầu vào: Xác nhận rằng các biến (priorities, optionA và optionB) đã được truyền chính xác từ ứng dụng khách.
    • Kết quả: Xem văn bản thô do mô hình tạo ra để xác minh xem mô hình có trả về JSON hợp lệ khớp với giản đồ hay không.
    • Thông tin chi tiết về lỗi: Nếu một yêu cầu không thành công, hãy kiểm tra nhật ký lỗi theo dõi để biết lý do, chẳng hạn như mã thông báo Kiểm tra ứng dụng không hợp lệ, từ chối xác thực, giới hạn hạn mức hoặc lỗi xác thực câu lệnh.
  4. Khắc phục sự cố và giải quyết các vấn đề với Google AI Studio:
    • Nếu bạn xác định được lỗi trong dấu vết (ví dụ: phân tích cú pháp phản hồi JSON không đúng định dạng hoặc thiếu tham số), hãy sao chép thông báo lỗi hoặc tải trọng.
    • Quay lại Google AI Studio và nhắc trợ lý khắc phục vấn đề tương ứng trong mã ứng dụng.

8. Không bắt buộc: Triển khai ứng dụng

Giờ đây, khi ứng dụng của bạn hoạt động ở chế độ xem trước, hãy triển khai ứng dụng đó cho môi trường thực tế.

Để bảo vệ các điểm cuối Firebase trong môi trường thực tế, hãy định cấu hình một nhà cung cấp dịch vụ chứng thực thực tế để sử dụng với tính năng Kiểm tra ứng dụng Firebase (trong lớp học lập trình này, bạn sẽ sử dụng reCAPTCHA v3).

Trước tiên, bạn cần triển khai ứng dụng để lấy URL đang hoạt động chính xác của ứng dụng, nhờ đó, bạn có thể đăng ký miền cụ thể bằng reCAPTCHA thay vì cho phép tất cả ứng dụng ai.studio.

Triển khai ứng dụng và định cấu hình reCAPTCHA:

  1. Triển khai ứng dụng web bằng Google AI Studio:
    1. Trong Google AI Studio, hãy nhấp vào Xuất bản ở thanh điều hướng trên cùng.
    2. Nhấp vào Bắt đầu, xem lại hoặc tuỳ chỉnh tên và nội dung mô tả ứng dụng, sau đó nhấp vào Xuất bản ứng dụng.
    3. Chờ Google AI Studio tạo và triển khai ứng dụng (thường mất 1-2 phút).
    4. Sao chép URL ảo đang hoạt động được tạo (ví dụ: https://decide-for-me-123.ai.studio) và ghi lại miền của URL đó (ví dụ: decide-for-me-123.ai.studio).
  2. Tạo khoá reCAPTCHA v3 trong Google reCAPTCHA:
    1. Chuyển đến Bảng điều khiển dành cho quản trị viên của Google reCAPTCHA.
    2. Nhập Nhãn (ví dụ: Decide For Me - Production).
    3. Chọn reCAPTCHA type (Kiểu reCAPTCHA) > reCAPTCHA v3 (Score-based) (reCAPTCHA phiên bản 3 (Dựa trên điểm số)).
    4. Trong mục Miền, hãy thêm miền chính xác mà bạn đã triển khai cho ứng dụng (ví dụ: decide-for-me-123.ai.studio, bỏ qua https:// và mọi đường dẫn) hoặc miền tuỳ chỉnh nếu bạn dự định sử dụng.
    5. Chấp nhận điều khoản dịch vụ rồi nhấp vào Gửi.
    6. Hãy giữ thẻ này mở: bạn sẽ cần cả Khoá trang web (khoá ứng dụng khách công khai) và Khoá bí mật (khoá máy chủ riêng tư).
  3. Đăng ký khoá bí mật trong bảng điều khiển của Firebase:
    1. Chuyển đến phần Kiểm tra ứng dụng trong bảng điều khiển của Firebase.
    2. Chuyển đến thẻ Ứng dụng.
    3. Tìm ứng dụng web của bạn trong danh sách, nhấp vào ứng dụng đó (hoặc nhấp vào trình đơn có biểu tượng ba dấu chấm ⋮) rồi chọn reCAPTCHA v3.
    4. Dán Khoá bí mật reCAPTCHA vào trường rồi nhấp vào Lưu.
  4. Định cấu hình ứng dụng khách để sử dụng ReCaptchaV3Provider:
    1. Trong Google AI Studio, hãy chuyển sang bảng điều khiển trò chuyện và yêu cầu trợ lý cập nhật cấu hình Kiểm tra ứng dụng cho môi trường thực tế:
      Please update our Firebase App Check initialization to use
      ReCaptchaV3Provider with the reCAPTCHA site key "YOUR_RECAPTCHA_SITE_KEY",
      while retaining support for debug tokens in non-production environments.
      
    2. Nếu bạn xem trực tiếp mã trong thẻ Mã, hãy đảm bảo quá trình khởi chạy Kiểm tra ứng dụng khớp với cấu trúc sau:
      import { initializeAppCheck, ReCaptchaV3Provider } from "firebase/app-check";
      
      const appCheck = initializeAppCheck(app, {
        provider: new ReCaptchaV3Provider("YOUR_RECAPTCHA_SITE_KEY"),
        isTokenAutoRefreshEnabled: true
      });
      
    3. Sau khi cập nhật mã, hãy xuất bản lại ứng dụng của bạn trong Google AI Studio để đẩy cấu hình Kiểm tra ứng dụng đã cập nhật lên trang web đang hoạt động.
  5. Xác minh lưu lượng truy cập thực tế và theo dõi Kiểm tra ứng dụng:
    1. Mở URL ứng dụng đang hoạt động trong cửa sổ trình duyệt ẩn danh, đăng nhập bằng Google và thử gửi một tình huống khó xử.
    2. Quay lại phần Kiểm tra ứng dụng trong bảng điều khiển của Firebase, rồi kiểm tra các thẻ API và Giám sát để xác minh rằng các yêu cầu đã được đăng ký thành công cho Firestore và Firebase AI Logic.

9. Kết luận

Xin chúc mừng! Bạn đã xây dựng một ứng dụng hữu ích có các tính năng AI từ đầu, sử dụng các công cụ trong Builder Stack của Google. Đây mới chỉ là bước khởi đầu; bạn có thể làm được nhiều việc hơn nữa bằng các công cụ của Google. Giờ đây, bạn đã có một dự án trên đám mây Firebase + Google Cloud; hãy khám phá tất cả các dịch vụ dành cho bạn!

Truy cập vào đường liên kết này để nhận huy hiệu Đã hoàn thành hành trình của nhà sáng tạo!

Để tiếp tục hành trình, hãy truy cập vào goo.gle/builders để tham gia phòng thí nghiệm tiếp theo.

Nếu đang sử dụng Antigravity 2.0, nền tảng chuyên dụng của Google để điều phối nhiều tác nhân tự động song song, bạn có thể nhanh chóng xuất dự án của mình từ Google AI Studio và nhập dự án đó vào Antigravity để tiếp tục xử lý trên máy. Antigravity có Kỹ năng của tác nhân cho Firebase, bạn có thể cài đặt chỉ bằng một cú nhấp chuột. Những kỹ năng này cũng hỗ trợ phát triển ứng dụng di động, giúp bạn sao chép ứng dụng này trong cả môi trường Android và iOS nếu muốn.