資源概覽¶
本章節提供 Headquarter.ai 各類資源的詳細設定指南。
什麼是資源¶
資源是可重複使用的設定物件,用於定義外部連線、模型設定,以及 供工作流程和任務共用的設定。
資源類型¶
實際目錄頁長相¶
在平台上進入「資源」後,看到的是一整面沒有分類標題的卡片牆,並非下方的五大分類。卡片是依資源的英文代號排序,所以用中文名看會像沒有規則——請直接用頁面上的搜尋框找。下方分類只是幫你理解各資源的用途;實際操作時,請直接用頁面上的搜尋框或卡片名稱尋找你要的資源。
頁面右上角有一組檢視切換鈕,可在兩種排版之間切換(選擇會被記住,下次進來維持你上次選的):

| 按鈕 | 排版 |
|---|---|
| 卡片檢視 | 預設。每一類資源一張卡片,卡片上有該類的用途說明,以及該類支援哪些型別的圖示。 |
| 列表檢視 | 同樣的內容改成表格,欄位為「名稱」「描述」「支援類型」,一次看得到更多類別。 |
每張卡片(或每一列)點下去,才會進入該類資源的清單頁——清單頁的共用操作見通用介面元件 — 清單頁的共用操作。
資源目錄裡每一類資源的建立與編輯表單都有一個選填的「標籤」欄位,清單頁也都能把搜尋條件改成「標籤」,把貼了同一個標籤的資源一次篩出來。填法、限制與篩選方式見「標籤」欄位。
核心 AI 資源¶
| 資源 | 用途 | 指南 |
|---|---|---|
| 大型語言模型 | 配置聊天/補全提供商和推論參數 | 大型語言模型指南 |
| 嵌入模型 | 配置嵌入提供商和參數 | 嵌入模型指南 |
| 樣板 | 可重用的內容或提示範本 | 樣板指南 |
知識與檢索¶
| 資源 | 用途 | 指南 |
|---|---|---|
| 知識庫 | 文件和檢索就緒資料的中央儲存庫 | 知識庫指南 |
| 檢索器 | 定義檢索策略和參數 | 檢索器指南 |
| 排序器 | 透過相關性重新排序文件以改善 RAG 品質 | 排序器指南 |
| 分割器 | 定義索引的文件分割策略 | 分割器指南 |
| 載入器 | 自動從外部來源匯入資料到知識庫 | 載入器指南 |
外部連線¶
| 資源 | 用途 | 指南 |
|---|---|---|
| 連結器 | 儲存資料來源連線設定 | 連結器指南 |
| 搜尋引擎 | 配置網路搜尋 API(Google、Perplexity 等) | 搜尋引擎指南 |
| MCP 伺服器 | Model Context Protocol 端點,用於工具/上下文交換 | MCP 伺服器指南 |
資料與儲存¶
| 資源 | 用途 | 指南 |
|---|---|---|
| 資料集 | 儲存結構化資料集合,用於評估和批次處理 | 資料集指南 |
| 儲存庫 | 配置 S3 bucket 以進行檔案儲存和檢索 | 儲存庫指南 |
| 變數 | 儲存 JSON 值以進行集中配置管理 | 變數指南 |
進階¶
| 資源 | 用途 | 指南 |
|---|---|---|
| Lambda 函式 | 登記 AWS Lambda 函式的 ARN,供工作流程或 Agent 呼叫自訂運算 | 見下方「Lambda 函式」 |
| 技能 | 可重複使用的 SKILL.md 指南,以 skill 工具掛到 Agent | 技能指南 |
Lambda 函式¶
「Lambda 函式」資源不會幫你建立或部署 Lambda,它只是把一個已經部署在 AWS 上的函式 ARN 登記成具名資源,之後在 Lambda 任務或 MCP 伺服器的 Lambda 自訂工具裡就能用名稱選它,不必每次重貼 ARN。
從資源目錄的「Lambda 函式」卡片進入清單頁,點建立入口後表單只有四個欄位:
| 欄位 | 必填 | 預設 | 說明 |
|---|---|---|---|
| 名稱 | 是 | 無 | 這筆登記的識別名稱,之後在任務/工具的挑選清單裡看到的就是它。 |
| Lambda ARN | 是 | 無 | 該函式在 AWS 上的完整 ARN,格式如 arn:aws:lambda:<地區>:<帳戶 ID>:function:<函式名稱>。ARN 是什麼、詳細頁怎麼用它開 AWS 主控台,見通用介面元件 — ARN 與開啟連結。 |
| 描述 | 否 | 空白 | 說明這個函式做什麼,方便團隊辨識。 |
| 標籤 | 否 | 無 | 分類用的小標,貼上後可在清單頁用「標籤」把同一群資源一次篩出來。填法與數量/長度限制見「標籤」欄位。 |
按右上角「儲存」即完成登記。詳細頁「一般」頁籤會顯示 ID、名稱、Lambda ARN、描述、標籤、系統資訊、狀態、建立者、更新者與最後更新;「被依賴資源」頁籤可看到有哪些工作流程或工具正在用它。
平台要有呼叫該函式的權限
登記 ARN 本身不會驗證權限。實際執行時平台需具備呼叫該 Lambda 的權限,若執行失敗請與系統管理員確認權限設定(同 Lambda 任務的前置需求)。
Agent 不在資源目錄裡
Agent 不屬於資源目錄的卡片,它的入口在左側最上層選單的「Agents」(與「資源」並列),不在「資源」頁面內。設定方式請見 Agent 指南。
最佳實踐¶
- 使用描述性名稱,讓團隊成員容易辨識資源。
- 避免重複設定,盡量重複使用現有資源。
- 在生產環境使用前,先測試資源連線。
- 在資源描述中記錄任何特殊需求或限制。
在 UI 中查看¶
資源透過平台左側選單的「資源」頁面管理,實際畫面見上方實際目錄頁長相。