📖 User Guide

Getting Started with PromptAgent

Complete setup guide for PromptAgent Flow Bridge — the Chrome extension that connects Google Gemini with Google Flow.

Thông báo: Nếu bạn vừa nhấn "New Project" và trang này xuất hiện — bạn chưa cấu hình URL Gemini Agent mặc định. Làm theo các bước dưới đây.

⚙️ Cài đặt ban đầu

1

Tạo Gemini Agent (Gem)

Truy cập Gemini và tạo một Gem mới:

2

Mở Settings trong Extension

Click vào icon PromptAgent ở góc trên phải trình duyệt (nếu không thấy → click 🧩 và ghim extension ra ngoài). Trong popup → nhấn ⚙️ Cài đặt.

3

Dán URL Gemini Agent

Dán URL Gem vào ô nhập liệu → nhấn Save. Extension sẽ tự động kết nối với Gem của bạn từ lần sau.

✨ Cách dùng Flow Bridge

1

Tạo ảnh/video trên Google Flow

Truy cập Google Flow và tạo một hình ảnh hoặc video.

2

Click nút ✨ lấp lánh

Một nút ✨ sẽ xuất hiện góc trên phải của ảnh/video. Click vào để gửi thẳng sang tab Gemini để phân tích ngay!

📒 Quản lý PromptBook

PromptBook là không gian lưu trữ và tổ chức các prompt của bạn theo từng dự án và phân cảnh (scenes):

  • Truy cập: Chọn mục PromptBook ở chân popup extension hoặc chuyển sang tab 📒 PromptBook ở giao diện Sidepanel.
  • Tổ chức phân cấp: Tạo các Scene (+ Scene) và Prompt (+ Prompt) mới trong từng dự án cụ thể.
  • Tìm kiếm và Sao chép: Bạn có thể tìm kiếm nhanh các prompt bằng thanh tìm kiếm, sao chép prompt chỉ với 1-click (nút Copy), hoặc chỉnh sửa nhanh nội dung prompt.
  • Nhập & Xuất (Import/Export): Hỗ trợ xuất dữ liệu prompt thành file JSON để sao lưu hoặc nhập gộp (merge) dữ liệu từ file JSON có sẵn.
  • Đồng bộ hóa: Mọi thay đổi trong PromptBook sẽ tự động đồng bộ thời gian thực với dashboard web nếu bạn đã liên kết Device UID.

📊 Bảng tính Credit Estimator

Credit Estimator giúp bạn ước tính chi phí credit và thời gian làm việc để hoàn thành video theo kịch bản phân cảnh:

  • Thiết lập AI Engine: Cấu hình giá vốn credit và thời gian tạo ảnh/video cho từng mô hình AI (như Lite, Fast, Quality, Omni Video 4s-10s...).
  • Lập dòng thời gian (Timeline): Thêm các cảnh vào timeline, chọn mô hình AI tương ứng, số lượt tạo thử nghiệm (test runs), và bật/tắt các tùy chọn như Upscale (4K) hay Edit.
  • Liên kết & Lưu trữ đám mây: Nhập 28 ký tự Device UID của bạn để kết nối. Bạn có thể chọn lưu trực tiếp bảng ước tính này vào một Project đã có hoặc tạo Project mới trên đám mây.
  • Xem thống kê chi tiết: Hệ thống tự động tính toán tổng số credit tiêu thụ, thời lượng video dự kiến, tổng chi phí ước tính và phân bổ tỷ trọng credit của từng cảnh.

💬 Slash Commands

Dùng các lệnh này khi chat với Gemini để tránh Gem tự tạo ảnh/video nhầm:

/img [mô tả]
Viết prompt tạo ảnh (Nano Banana style)
/video [mô tả]
Viết prompt tạo video (Veo 3.1)
/tts [mô tả]
Viết prompt giọng đọc (Text-to-speech)
/concept [mô tả]
Brainstorm ý tưởng sáng tạo

Notice: If you just clicked "New Project" and this page appeared — you haven't configured a default Gemini Agent URL yet. Follow the steps below.

⚙️ Initial Setup

1

Create a Gemini Agent (Gem)

Go to Gemini and create a new Gem:

2

Open Extension Settings

Click the PromptAgent icon in the top-right corner of your browser (if not visible → click 🧩 and pin the extension). In the popup → click ⚙️ Settings.

3

Paste your Gemini Agent URL

Paste the Gem URL into the input field → click Save. The extension will automatically connect to your Gem from now on.

✨ Using Flow Bridge

1

Generate on Google Flow

Go to Google Flow and create an image or video.

2

Click the ✨ sparkle button

A ✨ button appears in the top-right of each asset. Click it to instantly beam the image/video to your Gemini tab for analysis!

📒 Managing PromptBook

PromptBook is your dedicated workspace to organize and manage prompts by projects and scenes:

  • Access: Click the PromptBook link at the bottom of the popup or switch to the 📒 PromptBook tab in the Sidepanel.
  • Hierarchical Organization: Create Scenes (+ Scene) and Prompts (+ Prompt) inside specific projects to maintain clean pipelines.
  • Search & Copy: Easily filter through prompts using the search bar, copy them to your clipboard with 1-click (Copy button), or edit contents inline.
  • Import & Export: Export your prompts to a JSON file for backup, or merge/replace data by importing a JSON file.
  • Real-time Sync: Any prompt additions or updates automatically sync to your online dashboard when your Device UID is connected.

📊 Credit Estimator

Credit Estimator calculates script credit costs and working hours required to produce your video timeline:

  • AI Engine Settings: Define base credits and generation speeds for different AI models (such as Lite, Fast, Quality, Omni Video 4s-10s, etc.).
  • Timeline Builder: Add scenes to your timeline, select their models, specify test runs, and toggle upscale/edit options.
  • Cloud Synchronization: Enter your 28-character Device UID to connect. You can save your estimates directly into a project or create a new project in the cloud database.
  • Detailed Statistics: Automatically computes total credit consumption, expected video duration, cost estimations, and credit share weights per scene.

💬 Slash Commands

Use these when chatting with Gemini to prevent it from accidentally generating media:

/img [description]
Write an image prompt (Nano Banana style)
/video [description]
Write a video prompt (Veo 3.1)
/tts [description]
Write a text-to-speech prompt
/concept [description]
Brainstorm creative concepts