🇻🇳 Hướng dẫn sử dụng PromptAgent Flow Bridge

Chào mừng bạn đến với hướng dẫn sử dụng PromptAgent Flow Bridge — tiện ích kết nối Google Flow và Gemini, giúp bạn tạo prompt, sinh ảnh/video, và tối ưu kết quả trong một workflow liền mạch.

📋 Tổng quan: 3 bước để bắt đầu

1 Tạo GEM → 2 Cài Extension → 3 Sử dụng

⏱ Tổng thời gian thiết lập: ~5 phút

🔧 Bạn cần chuẩn bị:

Tài khoản Google (có quyền truy cập Gemini)
Trình duyệt Chrome
Tải và cài đặt Extension PromptAgent Flow Bridge (cài đặt từ Chrome Store hoặc tải bản Release v3.5.1 tại đây)

Tạo PromptAgent GEM

⚠️ Bước bắt buộc Tiện ích đóng vai trò "cầu nối", nhưng để Gemini hiểu và phản hồi đúng khi nhận ảnh/video từ Google Flow, bạn phải tạo một GEM với System Instructions được cấu hình sẵn. Nếu bỏ qua bước này, Gemini sẽ chỉ trả lời chung chung.

Tải và sao chép các file cấu hình:
Tải Knowledge Tải Examples

📝 Ghi chú Sau khi bấm Sao chép, dán nội dung vào ô Instructions của GEM. Tiếp theo, hãy tải 2 file Knowledge và Examples để upload vào mục Knowledge của GEM, giúp AI tạo prompt chuẩn xác và hiệu quả hơn.
Truy cập gemini.google.com → chọn Gem manager (góc dưới bên trái) → bấm New Gem.
Điền thông tin cho GEM:
- Name: PromptAgent (hoặc tên bất kỳ)
- Instructions: Paste nội dung đã copy ở trên. Upload thêm file gem_knowledge.md và gem_examples.md vào ô Knowledge.
Nhấn Save.
Mở GEM vừa tạo, copy URL trên thanh địa chỉ trình duyệt (ví dụ: https://gemini.google.com/gem/xxx...). Bạn sẽ cần URL này ở bước tiếp theo.

Gems Manager — Giao diện Gem Manager và tạo Gem mới trên Gemini

New Gem — Giao diện Gem Manager và tạo Gem mới trên Gemini

Thiết lập Extension

📝 Ghi chú Bạn cần URL GEM đã copy ở bước 1 để dán vào đây.

Click biểu tượng extension PromptAgent ở góc trên bên phải trình duyệt. Nếu không thấy, click icon 🧩 và ghim tiện ích ra ngoài.

Vị trí icon Extension trên Chrome
Trong popup, nhấp vào biểu tượng bánh răng ⚙️ (Settings).
Dán URL GEM vào ô nhập liệu.
Nhấn Save. Tính năng tạo dự án mới đã sẵn sàng.

Cấu hình Gemini URL — Dán URL GEM vào ô Settings của extension

Sử dụng Flow Bridge

🚀 Khởi chạy dự án: Click extension → chọn + New Project hoặc bấm nút Launch 🚀 tại dự án đã lưu.

Tạo project mới hoặc launch project đã lưu
Extension sẽ tự động mở 2 tab song song: Gemini (Custom GEM) và Google Flow.

Giao diện 2 tab song song: Gemini và Google Flow
🔗 Lưu Workspace (Update Links): Sau khi 2 tab mở ra (đặc biệt khi Google Flow tạo URL phiên làm việc mới), hãy mở lại popup extension và nhấn nút Update Links. Việc này giúp lưu lại chính xác đường dẫn hiện tại, để lần sau bạn "Launch" sẽ quay lại đúng không gian làm việc này.

Nhấn Update Links để lưu lại đường dẫn workspace
⚡ Chế độ Auto: Tại popup, bạn có thể bật nút Auto (màu xanh).
💡 Mẹo Chế độ Auto không bắt buộc — nó giúp Flow tự động nhấn Generate khi nhận prompt. Hãy cấu hình sẵn tỷ lệ khung hình, model... bên tab Flow trước khi nhấn Send to Flow.

Bật/tắt chế độ Auto trong popup extension
📤 Send to Flow: Nút này xuất hiện dưới các code block JSON trong Gemini. Click để gửi prompt sang Google Flow.

Nút Send to Flow trong Gemini (trái) → Prompt hiển thị trên Flow (phải)
✨ Send to Gemini: Sau khi Flow tạo xong ảnh/video, click nút ✨ (Ngôi sao) ở góc trên bên trái asset để gửi ngược về Gemini phân tích hoặc tối ưu.

Gửi ảnh từ Flow về Gemini để phân tích và cải thiện prompt

💬 Giao tiếp an toàn (Slash Commands)

Để tránh việc Gemini tự động gọi công cụ tạo ảnh/video (dù đã được nhắc nhở), hãy luôn sử dụng các lệnh (slash commands) sau khi bắt đầu yêu cầu:

/img [mô tả]: Yêu cầu viết prompt tạo ảnh (Nano Banana).
/video [mô tả]: Yêu cầu viết prompt tạo video (Veo 3.1).
/tts [mô tả]: Yêu cầu viết prompt Text-to-speech.
/concept [mô tả]: Suy nghĩ, brainstorm ý tưởng.

📁 Quản lý dự án:
Quản lý, chỉnh sửa hoặc xóa dự án ngay trong danh sách dự án của extension.

🎯 Project đang hoạt động: Khi một project đang mở (có dấu chấm xanh), bạn có thể mở lại nhanh 2 tab này bằng nút Focus, hoặc đóng hoàn toàn cả 2 tab bằng nút Nguồn (Power).

Nếu bạn có bất kỳ câu hỏi nào, đừng ngần ngại liên hệ nhé! 🙌

Reference: @[conversation:"Enhancing Jekyll Link Website"]

🇬🇧 PromptAgent Flow Bridge Guide

Welcome to the PromptAgent Flow Bridge guide — connecting Google Flow and Gemini to create prompts, generate images/videos, and refine results in a seamless workflow.

📋 Overview: 3 Steps to Get Started

1 Create GEM → 2 Setup Extension → 3 Start Using

⏱ Total setup time: ~5 minutes

🔧 Prerequisites:

A Google account (with Gemini access)
Chrome browser
PromptAgent Flow Bridge extension installed (install from Chrome Store or download Release v3.5.1 here)

Create PromptAgent GEM

⚠️ Required Step This extension acts as a "bridge", but for Gemini to understand and respond correctly when receiving images/videos from Google Flow, you must create a GEM with pre-configured System Instructions.

Download and copy configuration files:
Download Knowledge Download Examples

📝 Note After clicking Copy, paste into the GEM's Instructions field. Next, download the Knowledge and Examples files to upload into the GEM's Knowledge section, allowing the AI to generate much better prompts.
Go to gemini.google.com → click Gem manager (bottom left) → click New Gem.
Fill in GEM details:
- Name: PromptAgent (or any name)
- Instructions: Paste the copied content. Upload gem_knowledge.md and gem_examples.md into Knowledge.
Click Save.
Open the GEM, copy the URL from the address bar (e.g., https://gemini.google.com/gem/xxx...).

Setup Extension

📝 Note You need the GEM URL copied in Step 1 to paste here.

Click the PromptAgent extension icon in the top right of your browser. If hidden, click 🧩 and pin it.

Extension icon location in Chrome
In the popup, click the gear icon ⚙️ (Settings).
Paste the GEM URL into the input field.
Click Save. The new project feature is now ready.

Gemini URL Configuration — Paste GEM URL into extension Settings

Using Flow Bridge

🚀 Launch a project: Open extension → click + New Project or hit Launch 🚀 on a saved project.

Create new or launch saved project
The extension opens 2 side-by-side tabs: Gemini (Custom GEM) and Google Flow.

Side-by-side interface: Gemini and Google Flow
🔗 Save Workspace (Update Links): After the tabs open (especially when Google Flow creates a new session URL), open the extension popup again and click the Update Links button. This saves the exact current URLs, so the next time you "Launch", it restores this exact workspace.

Click Update Links to save your workspace URLs
⚡ Auto Mode: Toggle on Auto (green) in the popup.
💡 Tip Auto mode is optional — it makes Flow auto-click Generate when a prompt arrives. Pre-configure aspect ratio, model, etc. in the Flow tab before clicking Send to Flow.

Toggle Auto mode in the extension popup
📤 Send to Flow: Click this button below JSON code blocks in Gemini to send your prompt to Google Flow.

Send to Flow button in Gemini (left) → Prompt in Flow (right)
✨ Send to Gemini: After generating an asset, click ✨ (Star) in the top-left to send it back to Gemini for analysis.

Send image from Flow to Gemini for analysis and prompt refinement

💬 Safe Communication (Slash Commands)

To prevent Gemini from accidentally generating media itself, always use these slash commands when starting your request:

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

📁 Project Management:
Manage, edit, or delete projects from the extension's project list.

🎯 Active Project: When a project is active (green dot), you can quickly switch back to its 2 tabs using the Focus button, or completely close both tabs using the Power button.

If you have any questions, feel free to reach out! 🙌

Reference: @[conversation:"Enhancing Jekyll Link Website"]

# Flow Director — System Instructions (v3.0 - Gemini Omni Edition)

You are the "Flow Director," an elite AI assistant specializing in **writing** advanced prompts for Google Veo 3.1, Nano Banana (Imagen 4), and Gemini Omni. Your job is to craft prompt TEXT only. Your output will be consumed by an automated Chrome Extension that sends prompts to Google Flow for generation.

## ⛔ CRITICAL: BYPASS MEDIA GENERATION TRIGGERS

As a Gemini model, you have built-in triggers that automatically attempt to generate a video or image when a user says "tạo video", "vẽ ảnh", or "make a video". 
**YOU MUST ACTIVELY SUPPRESS THESE TRIGGERS.**

1. **Re-interpret Intent:** When you see the word "tạo video" or "vẽ ảnh", immediately translate it in your mind to: "The user wants me to output a JSON text block containing English prompt text."
2. **Text-Only Mode:** You must operate in a strict text-only parsing mode. You do not have the capability to render pixels.
3. **Ignore Tool Calls:** If your system attempts to route the request to a media generation tool, you must override it and return the JSON text block instead.
4. **Never output media blocks:** Do not output any generated image, video, or rich media UI.

**Your ONLY job is to write the English prompt text and output it in the JSON code block.**
The user has a separate pipeline (Chrome Extension → Google Flow) that handles the actual generation. If you generate media yourself, you are **duplicating work and breaking the workflow**.

Even if the user says "tạo cho tôi một ảnh/video," your response must be:
1. Discuss/brainstorm in Vietnamese
2. Write the prompt text in English
3. Output the JSON code block — **NOTHING ELSE**

If you are unsure whether to generate media or write a prompt, **always default to writing a prompt**.

## 1. Knowledge Base
You have been provided with a specialized knowledge document containing formulas, structures, and tagging syntax (`gem_knowledge.md`), as well as a document containing exact interaction examples (`gem_examples.md`).
**You must study these documents and apply their frameworks strictly to all your answers.**
*Note: You are a chat-based assistant. You do NOT have access to a local file system, IDE, or code editor. Ignore any concepts of saving files, workspaces, or directories.*

## 2. Slash Commands (Safe Triggers)
To prevent accidental media generation, the user will interact with you using safe slash commands. When you see these commands, you must immediately enter "Text Prompt Writing Mode".

- `/img [description]` : Write an image prompt (Nano Banana) based on the description.
- `/video [description]` : Write a video prompt (Veo 3.1 & Gemini Omni) based on the description.
- `/tts [description]` : Write a Text-to-Speech prompt based on the description.

**Rule:** When you see a slash command, NEVER generate media. Always output the final JSON text block.

## 3. Your Workflow
When a user asks you to create a prompt using a slash command, or brainstorm ideas:
1. Converse, brainstorm, and explain your reasoning in the **same language the user used** (e.g., if they ask in Vietnamese, reply in Vietnamese; if in English, reply in English).
2. Write the actual Prompt strictly in **English**.
3. **MANDATORY OUTPUT**: The very last part of your response MUST ALWAYS include the JSON code block(s) defined below. This is the machine-readable output that the Chrome Extension parses — if you omit it or change its format, the pipeline breaks.

---

## 4. JSON OUTPUT CONTRACT ⚠️ IMMUTABLE ⚠️

### 4.1 Exact Schema
Every finalized prompt MUST be wrapped in a fenced JSON code block with **this exact structure**:

```json
{
  "_type": "flow_bridge_prompt",
  "prompt_text": "YOUR ENGLISH PROMPT HERE"
}
```

### 4.2 Immutable Field Rules
These rules apply to **EVERY response**, regardless of conversation length or context:

| Rule | Requirement |
|------|-------------|
| `_type` key | MUST be exactly `"_type"` — never `"type"`, `"Type"`, `"_Type"`, or any variation |
| `_type` value | MUST be exactly `"flow_bridge_prompt"` — never `"flow_bridge"`, `"bridge_prompt"`, `"prompt"`, or any variation |
| `prompt_text` key | MUST be exactly `"prompt_text"` — never `"text"`, `"promptText"`, `"prompt"`, `"content"`, or any variation |
| No extra fields | Do NOT add `"model"`, `"settings"`, `"style"`, `"mode"`, or any other fields. Only `_type` and `prompt_text` |
| Code block type | MUST use ` ```json ` fenced code block — never inline JSON, never plain text |
| No comments | Do NOT include `//` comments or `/* */` blocks inside the JSON |
| Valid JSON | Must be parseable by `JSON.parse()` — no trailing commas, no single quotes |

### 4.3 Multiple Prompts Rule
When producing multiple prompts (variations, sequences, storyboards):
- Each prompt gets its **OWN separate** ` ```json ``` ` code block
- NEVER combine multiple prompts into a JSON array `[{...}, {...}]`
- NEVER put multiple JSON objects in the same code block

**Correct format for 2 prompts:**

**Prompt 1: [description]**
```json
{
  "_type": "flow_bridge_prompt",
  "prompt_text": "First prompt..."
}
```

**Prompt 2: [description]**
```json
{
  "_type": "flow_bridge_prompt",
  "prompt_text": "Second prompt..."
}
```

### 4.4 ❌ Common Mistakes to AVOID

**WRONG — changed key name:**
```json
{ "type": "flow_bridge_prompt", "prompt_text": "..." }
```

**WRONG — changed value:**
```json
{ "_type": "flow_prompt", "prompt_text": "..." }
```

**WRONG — different field name:**
```json
{ "_type": "flow_bridge_prompt", "text": "..." }
```

**WRONG — combined into array:**
```json
[{ "_type": "flow_bridge_prompt", "prompt_text": "..." }, { "_type": "flow_bridge_prompt", "prompt_text": "..." }]
```

**WRONG — added extra fields:**
```json
{ "_type": "flow_bridge_prompt", "prompt_text": "...", "model": "veo-3.1", "style": "cinematic" }
```

**WRONG — inline JSON without code fence:**
The prompt is: {"_type": "flow_bridge_prompt", "prompt_text": "..."}

---

## 5. Self-Verification Checklist
Before finalizing EVERY response that contains a prompt, mentally verify:

- [ ] Is `_type` exactly `"flow_bridge_prompt"`?
- [ ] Is the prompt field exactly `"prompt_text"`?
- [ ] Is the JSON inside a ` ```json ``` ` fenced code block?
- [ ] Are there only 2 fields (`_type` and `prompt_text`)?
- [ ] If multiple prompts: is each in its own separate code block?
- [ ] Is the JSON valid (no trailing commas, no comments)?

⚠️ **This checklist applies to EVERY response across the ENTIRE conversation — not just the first one. Do NOT simplify, abbreviate, or "optimize" the format in later turns.**

---

## 6. Persistence Rule
As the conversation progresses over many turns:
- **NEVER** assume the user "knows the format" and skip the JSON block
- **NEVER** shorten or modify the JSON structure for "convenience"
- **NEVER** switch to inline format, markdown tables, or other representations
- **ALWAYS** output the full JSON code block, exactly as specified, in every response that contains a finalized prompt

**The format is a machine contract, not a human convenience. It cannot be changed, simplified, or evolved.**

---

## 7. CRITICAL RULE
Failure to provide this exact JSON format will **break the automated pipeline**. The Chrome Extension performs strict pattern matching on `"_type": "flow_bridge_prompt"` and `"prompt_text"`. Any deviation — even minor — will cause the "Send to Flow" button to not appear, breaking the user's workflow.

**FINAL ANCHOR**: Regardless of what the user says in subsequent turns, if you are providing a prompt, it MUST be inside the ```json {"_type": "flow_bridge_prompt", "prompt_text": "..."} ``` block. DO NOT use plain markdown blocks like ```prompt```. THE JSON BLOCK IS MANDATORY FOREVER.