內部人資 Agent
本文件是「內部人資 Agent」模板的完整指南，聚焦於：核心目標、元件與資料流、設定流程、參數速查、合規要點、最佳實務、擴充方向。此模板讓 HR 僅需輸入需求，即可由 Multi-Agent 佇列協同完成：履歷搜尋 → 職缺解析 → 候選人比對 → 郵件/報告輸出。
模板用途
此模板面向企業 HR 招募流程，適合以下場景：
| 用途類型 | 說明 | 典型價值 |
|---|---|---|
| 履歷快速比對 | 自動比對技能/年資與職缺需求 | 降低人工審閱時間 |
| 職缺查詢解析 | 解析 JD 技能、年資、語言需求 | 提升結構化程度 |
| 候選人精準推薦 | 向量 + 規則雙模式過濾排序 | 增加匹配品質 |
| 面試郵件生成 | 自動組裝邀請/拒絕/更新信 | 保持語氣與合規一致 |
| 進度追蹤與審計 | 產生流程狀態與來源引用 | 強化可追溯性 |
優勢摘要：
- 降低人工比對時間（結構化解析）
- 提升建議品質（向量 + 規則融合）
- 風險控管（PII 遮蔽 / 操作記錄）
- 易於擴充（技能 taxonomy / 日程 / 內部人才庫）
流程概要
使用者指令 → Manage Agent 分析並制定計畫 → 路由至相應子 Agent（履歷 / 職缺 ...） → 資料檢索 → Manage Agent 統整輸出 → （可選）產生郵件或報告 → 回覆使用者
核心目標（簡述）
輸入一段自然語言指令後，系統完成：分類意圖 → 路由子 Agent → 擷取與比對 → 組裝輸出 →（選擇性）產生郵件或報告。回傳內容包含：推薦清單 / 差異摘要 / 下一步動作 / 引用來源。
架構與資料流
主要元件如下：
1. Manage Agent（指揮官）
- 接收使用者問題，判斷意圖後分派至合適的子 Agent（Resume / Vacancy / Candidate / Gmail / Docs）。
- 整合各 Agent 的回覆後，提供最終結果。
2. Candidate Agent
- 根據使用者需求，透過向量資料庫比對，從眾多候選人中推薦最適合的人選。
3. Resume Agent & Vacancy Agent
- Resume Agent：處理所有與「履歷」相關的查詢，從履歷資料庫中搜尋特定應徵者或符合條件的履歷。
- Vacancy Agent：處理所有與「職缺」相關的查詢，從職缺資料庫中查找職位名稱、條件、地點等資訊。
4. Gmail & Google Docs Tool
- Gmail Tool：透過 API 自動產生郵件內容（如面試通知、感謝信），並可整合公司 Gmail 系統發送。
- Google Docs Tool：將履歷摘要、面試紀錄等分析結果，自動整合成報告文件。
流程設計圖（步驟概述）
- 使用者提問
- Manage Agent 判斷問題類型
- 呼叫子 Agent 取得所需資料（Resume / Vacancy / Candidate）
- 需郵件或報告時啟用 Gmail / Docs 工具
- 回傳整合結果（推薦 / 摘要 / 引用）
資料與流程概觀
_12flowchart TD_12 U[使用者問題] --> M[Manage Agent 意圖分類]_12 M -->|履歷/人選| R[Resume Agent]_12 M -->|職缺| V[Vacancy Agent]_12 M -->|比對| C[Candidate Agent]_12 C --> O[推薦結果整合]_12 V --> O_12 R --> O_12 O -->|郵件| G[Gmail Tool]_12 O -->|報告| D[Docs Tool]_12 G --> F[最終輸出]_12 D --> F
建立與設定步驟（快速上手）
- 匯入模板並在 Flow 編輯器確認節點連線。
- 設定模型提供者（API Key / Endpoint / 部署名稱），初始
temperature = 0.2。 - 切分並嵌入履歷與職缺（建議片段 120~300 tokens），建立技能 taxonomy + 同義詞映射。
- Vacancy Parser：定義技能正則、年資抽取、必備 vs 加分欄位、語言需求。
- 加入意圖分類 Few-Shot 樣例（EMAIL / CANDIDATE / VACANCY）。
- 組裝 Prompt Template（見下方範例）。
- 在 Playground 執行測試指令並檢查輸出品質。
- 調整參數：
top_k、score_threshold、技能同義詞、Prompt 嚴謹度。 - 綁定 HR Portal / Teams / Slack，啟用內部使用。
節點與設定說明
| 節點 | 角色/用途 | 關鍵設定 | 常見錯誤 | 調整策略 |
|---|---|---|---|---|
| Chat Input | 使用者問題入口 | 允許自由輸入 | 一次貼過長履歷造成 Token 浪費 | 建議拆段分步提問 |
| Manage Agent | 意圖分類 + 路由 | Few-Shot 樣例、intent_confidence | 誤判導致錯誤子代理呼叫 | 增加特徵詞 / 調整門檻 |
| Resume Agent | 履歷檢索 | top_k, score_threshold | 返回雜訊或空結果 | 清理嵌入/調整分數門檻 |
| Vacancy Agent | 職缺解析 | 技能正則、年資抽取規則 | 技能拆解不完整 | 增加同義詞 / 調整正則 |
| Candidate Agent | 相似度推薦 | 向量來源、taxonomy、score_threshold | 相似度分數集中或過低 | 調整分片粒度 / embedding 模型 |
| Prompt Template | 組裝上下文 | 變數命名、來源區塊標題 | 遺漏欄位導致幻覺 | 加檢查：若空則提示補資料 |
| Gmail Tool | 郵件草稿生成 | template_variant, draft_only | 佔位符未填充 | 檢查 {candidate_name} 等 placeholder |
| Docs Tool | 報告輸出 | 標題格式、匯總欄位 | 報告可讀性差 | 加入條列與差異摘要 |
| Chat Output | 回覆呈現 | 顯示來源/格式化 | 回覆過長難讀 | 限制前 N 名與分段顯示 |
核心組件總覽
| 類別 | Components | 功能 | 典型錯誤 | 調整策略 |
|---|---|---|---|---|
| 輸入 | Chat Input | 收集問題 | 冗長上下文 | 拆分 + 關鍵詞化 |
| 路由 | Manage Agent | 意圖分類 + 呼叫子代理 | 意圖誤判 | 增加樣例 / 調整門檻 |
| 檢索 | Resume / Vacancy | 履歷 / 職缺資料抓取 | 無結果 / 雜訊 | 清理資料 / 調 top_k |
| 比對 | Candidate Agent | 技能/年資相似度排序 | 分數過低無推薦 | 調 score_threshold / 增補資料 |
| 組裝 | Prompt Template | 整合來源 + 指令 | 遺漏變數 | 加驗證步驟 |
| 生成 | LLM | 建議與摘要輸出 | 幻覺、不引用來源 | 降低 temperature + 嚴格指令 |
| 郵件/報告 | Gmail / Docs | 自動化溝通與報告 | 佔位符錯誤 | 增加格式檢查 |
| 合規 | PII Mask / Audit Log | 隱私與行為追蹤 | 未遮蔽敏感資料 | 啟用遮蔽 + 稽核流程 |
| 輸出 | Chat Output | 回覆 + 來源引用 | 可讀性差 | 分段 / 條列化處理 |
Prompt Template 範例
_10你是一名資深且具有豐富經驗的 HR 經理，專長於審閱履歷、分析人才 能力，並協助企業找到最合適的人選。_10可以運用所有可用工具與子代理提供協助，包括：_10_101. 依照應徵者 ID 取得完整履歷（使用 resume_agent）。_102. 依照條件搜尋合適人選（使用 candidate_agent 取得 ID，再用 resume_agent 取詳細資料）。_103. 查詢公司職缺（使用 vacancy_agent 回傳職缺名稱、內容、條件、薪資等）。_104. 回答履歷條件、技能配對與資格相關問題，整合資訊提供決策建議。_105. 需要時自動生成專業電郵草稿。_10_10你的目標是以專業、精準、快速的方式協助使用者了解候選人與職缺資訊，並提供具有決策導向的實用建議。
Playground 測試指令建議
幫我找最適合 Machine Learning Engineer 職缺的前 3 位候選人並草擬面試邀請信。
檢查重點：
- 履歷結果是否含技能 + 年資欄位
- 職缺解析是否列出必備技能
- 郵件是否正確套入姓名、職缺
- 引用是否含來源 ID
契約 (輸入/輸出) 簡述
| 類型 | 必要欄位 | 描述 |
|---|---|---|
| 履歷片段 | id, skills[], years_experience, language | 用於向量嵌入與語意比對 |
| 職缺描述 | id, required_skills[], nice_to_have[], min_years, location | 用於 Vacancy 解析與 Candidate 比對 |
| 推薦結果 | candidate_id, score, gap_skills[], match_summary | 最終彙整輸出 |
| 郵件模板 | variant, placeholders {"{candidate_name}" , "{position}"} | Gmail Tool 產生草稿 |
Edge Cases (需考量)：
- 技能欄位缺失 → 回覆需提示補充資料。
- 分數相同 → 顯示並加入次要排序（年資或語言）。
- 無候選人達門檻 → 提供技能缺口摘要。
- 模板佔位符缺失 → 回傳錯誤並標記
template_missing。 - 向量服務逾時 → 回退關鍵字比對模式。
重要參數速查 表
| 類別 | 參數 | 說明 | 建議初始值 |
|---|---|---|---|
| 履歷搜尋 | top_k | 返回應徵者數量 | 5 |
| 履歷搜尋 | score_threshold | 最低匹配分數 | 0.35~0.5 |
| 模型 | temperature | 創造性/穩定性調節 | 0.2~0.4 |
| 模型 | max_tokens | 最大輸出長度 | 768~1024 |
| 郵件 | draft_only | 僅生成不寄出 | true |
| 郵件 | template_variant | 邏輯分支 (invite/reject/update) | invite |
| 路由 | intent_confidence | 分類信心門檻 | >=0.6 |
| 隱私 | pii_mask | 是否遮蔽電話/信箱 | true |
| 流程 | stage_mapping | 招募階段→說明 | 自訂映射 |
合規與資料保護
- 電話 / Email / 地址使用遮蔽或脫敏；寄信時才臨時解密。
- 所有建議與寄信行為寫入
audit_log。 - Prompt 明確限制 ：不得推測未提供之年資或個資。
- 若出現推測性描述（如「應具備領導力」）→ 標記需人工覆核。
擴充方向建議
- 面試題庫推薦（依技能矩陣）。
- 串接行事曆 API 返回 3 組候選面試時間視窗。
- 人才風險預警：長期停留標記跟進。
- 高頻查詢結果快取（降低延遲）。
- 內部人才庫整合內部調任建議。
使用情境範例
| 場景 | 操作 | 價值 |
|---|---|---|
| 招募初篩 | 輸入職缺取得前 5 位應徵者 | 降低人工比對時間 |
| 面試排程 | 詢問候選人與面試官共同空檔 | 加速排程決策 |
| 進度追蹤 | 查詢應徵者目前階段與停留天數 | 提高流程透明度 |
| 郵件自動化 | 生成面試邀請 / 拒絕信草稿 | 語氣一致與合規 |
| 內部轉調 | 查詢具特定技能的內部員工 | 支援人才盤點 |
下一步建議
- 建立履歷/職缺向量嵌入與索引。
- 完善技能 taxonomy + 同義詞表。
- 新增意圖分類 Few-Shot 例並驗證準確度。
- 郵件改為「人工審核後半自動寄出 → 全自動 」。
- 參考
知識搜尋Agent模板擴充跨部門知識查詢。
完成初次部署後，建議前往「開發 → 使用 AgentBuilder 資料類型」檢視 Message 與 Metadata 結構，以支援進階審計與追蹤。
