學習摘要

教學目的

快速開始

基礎概念

前置準備

用 Colab 執行

自建 AI 工作流

🔌數據星球 API

摘要

• 歡迎各個領域想參與 Aralia 生態的老師/研究者，不論是否有工程背景都能藉由 Aralia 提供的 AI 工具庫(SDK: Software Development Kit) 協助找尋系統相關的 insight

  1. 在多個 Data Planet（如 SDG、UN…）中搜尋合適資料集
  2. 對齊時間與地理後拉回可比較的表格
  3. 交給 LLM 生成可閱讀的洞見摘要

• 學完即可在 Colab 完成一次實戰（不需要寫程式）；進階者可了解背後的 5 個工具節點與 LangGraph 流程，將流程納入教學/研究。

<aside> 📌

小提醒：把「研究/決策問題」說得越說清楚，Aralia AI 工具庫會更貼近的找到關鍵的 insight

</aside>

完成本教學後，你可以

• 跟AI互動口語問到 Insight
  • 獨立運用 AI 工具庫完成一個語意查詢資料的問答（含來源列與限制說明）。
• 線上 Lab
  • 不用建構開發環境，在我們準備好的 Colab 環境中，跑一次完整流程（可動手修改部分個參數、自訂Prompt體驗系統的行為與成果）。
• 課程教學
  • 具備把題目放入「範例題庫」並一鍵重跑的能力（利於課堂與復現）。
• 展開 AI 工具庫開發的旅程
  • 開始運用 Aralia提供的 AI SDK來打造自己的服務

這堂課你會「實作什麼」

• 最小可行案例（Malaysia GDP × Gini）

  • 情境：

    • 在資料分析上，想了解馬來西亞的GDP成長與貧富不均之間（永續發展中Gini Coefficient指標）是否有相關？

    • Gini Coefficient:

      基尼係數是一個衡量 收入或財富分配不均程度 的指標，由義大利統計學家 Corrado Gini 在 1912 年提出。 它的數值範圍在 0 到 1 之間： • 0：表示完全平等（例如每個人收入都一樣）。 • 1：表示完全不平等（例如一個人擁有全部收入，其餘人為零）。

  • 問題：

    Is there a relationship between the average GDP growth at purchasers' prices from 2021 to 2024 and the Gini coefficient of each state in Malaysia in 2024?

  • Agent 會做：在 SDG/UN 兩個 Planet 找 馬來西亞的 GDP 與 Gini，取 2021–2024 與 2024 年資料 → 以「state」(州）為單位對齊 → 回傳表格與洞見摘要。

• 自選題（從「範例題庫」挑一題）
  • 直接複製題庫的完整問題，貼到 Colab 執行；或把國家/年份替換為你課題需要的值。

你會用到的工具與資源 （無需準備）

• Colab Notebook：
  • 內含：環境安裝、Secrets 設定（LLM API Key、OAuth）、一鍵跑流程、輸出檢視。
• 題庫資料：已整理成可複製題目。
• Aralia OpenRAG SDK（進階）
  • 了解 5 個 工具節點與 LangGraph 流程；
  • 進階研究可在 SDK 中改 interpretation_prompt 或自定節點。

背後的流程簡介（看得懂就好，不需硬記）

• 5 個工具節點（由 LangGraph 串接）：
  1. 找資料集（語意檢索）
  2. 規劃分析（決定 x/y/filter 與欄位格式）
  3. 決定過濾條件（把年份/地理補齊成可查詢的參數）
  4. 執行查詢（向 Planet API 拉資料、對齊時間與地理）
  5. 洞見生成（LLM 產出 300 字內摘要，附限制）
• LLM 選擇：Notebook 會依你貼的 API Key 自動挑供應商（Google / OpenAI / Anthropic）。
• RAG 與向量化：系統已處理（你無需實作）；你要做的是把問題一次說清楚。

graph LR
      A[Question] --> B["Aralia<br/>Search<br/>Node"]
      B --> C["Analytics<br/>Planning<br/>Node"]
      C --> D["Filter<br/>Decision<br/>Node"]
      D --> E["Analytics<br/>Execution<br/>Node"]
      E --> F["<br/>Interpretation<br/>Node"]
      F --> G[Answer]

subgraph "Workflow"
B
C
D
E
F
end

style A fill:#e1f5fe
style G fill:#e8f5e8
style B fill:#fff3e0
style C fill:#fff3e0
style D fill:#fff3e0
style E fill:#fff3e0
style F fill:#fff3e0

準備好的話，讓我們開始進行第一步吧～

← 上一章： Aralia AI 應用

下一章： 快速開始 →