# AI 智慧旅遊業務助理 (TravelAgent) 知識庫

歡迎來到 TravelAgent 專案的官方文件中心。這份文件專為兩群人設計：

1. **開發者與維護團隊**：了解如何部署系統、查閱架構決策 (Supabase Schema、Auth)、以及核心程式碼邏輯。
2. **旅遊顧問與使用者**：學習如何操作後台管理系統，包括匯入行程、撰寫需求、編輯路線，以及如何善用 AI 診斷 (Gap Analysis) 與 AI 生成提示詞 (Prompts)。

***

## 🚀 關於本系統

**TravelAgent** 是一個專為專業旅遊顧問打造的「B2B 私人邀請制」平台，核心價值是透過生成式 AI (Gemini) 將顧問從繁瑣的「需求初步排版」與「資料檢查」中解放出來。

目前我們解決了三大痛點：

* **格式不統一**：不論客戶傳來的是 PDF、Word 或純文字，系統都能解析成結構化資料。
* **不合理路線**：AI 診斷引擎會在產出行程前揪出邏輯不順或缺乏資訊的地方。
* **排版耗時**：自動生成高品質的 JSON 行程表與可供提案的文字格式。

***

## 📖 如何閱讀這份文件

您可以透過左側選單瀏覽不同主題：

* **部署指南 (Deployment Guide)**：帶您從 `.env` 設定到本地端順利啟動伺服器。
* **架構解析 (Architecture Docs)**：深入了解我們的後端 (Supabase) 結構，包含權限控管與 AI Agent 整合細節。
* **使用手冊 (User Manual)**：詳細圖文解說平台各項功能。
* **進階 AI 運用**：學習如何建立自己的口袋名單 (Favorites) 讓 AI 更懂您的品味，以及如何微調系統。

如果您是第一次接手這個專案的開發者，建議您先閱讀 [**前置作業設定**](/travelagent/docs/zh/setup-gitbook.md) 以及安裝指南。


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://letztek.gitbook.io/travelagent/docs/zh.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.