📚 Learning Flow
AI Agent 教學
快速開始（3 分鐘）
系統原理與基礎概念
用 Colab 執行（No Code）
自創 AI Agent
FAQ / 常見問題
hello
用 Colab 了解AI Agent 運作原理
在這個章節中，我們一起動手剖析AI Agent具體運作的流程。
AI Agent是運用Python 程式語言撰寫的，一般要跑 Python 得安裝很多東西（解譯器、套件、權限…）。
我們在教學的過程中，使用Colab，它是一個Google提供的服務。幫你把執行環境準備好，你只要開瀏覽器 → 連線到雲端 → 依序按「播放」即可。
這樣不會卡在安裝，也不需要寫程式，非常適合課堂或第一次接觸。
Colab 環境
事前：申請帳號與金鑰（一次就好）
- 到 one.araliadata.io 申請帳號。
- 登入/註冊 Stellar 系統
- 取得API Key（金鑰: 識別你是誰、允許你安全使用系統與 識別身份 的「門禁卡」）：
- 進入 使用者設定（User Settings）
- 點 For Developers
- 按 Generate Key → 取得 Client ID / Client Secret
- 請妥善保管 Client ID & Client Secret，後續 Colab/開發都會用到。
💡 金鑰是什麼？
想像你去圖書館借書，需要拿「借書證」證明你是誰、可以借多少。金鑰就是系統世界的「借書證」。
在 Colab 操作（不貼程式碼，完全點一點）
- 打開教學 Notebook
- 點頁面右上角或左上方的 Connect / 連線到代管的執行階段（讓 Colab 幫你開機）。
- 跟著 Notebook 的提示，先在「Secrets／金鑰」的欄位貼上：
- LLM API Key（可先用 Gemini；之後可換 OpenAI/Anthropic）
- Client ID / Client Secret（剛剛在 Stellar 產生的）
- 依序按每個程式格左側的 ▶（播放 icon）：
- 安裝與匯入
- 初始化（OAuth 登入、設定 Planet）
- 貼上你的完整問題（可先用「馬來西亞 GDP × Gini」）
- 你會看到：
- 找到的 資料來源清單
- 由 LLM 產生的 洞見摘要（約 300 字）
若卡住：
系統原理與基礎概念](https://deciduous-centipede-9d7.notion.site/269ddf94fd148147b05dc28100ad84a8) | 下一章：自創 AI Agent →