> For the complete documentation index, see [llms.txt](https://docs.yoov.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.yoov.com/yoov-work/zh-hk/changelog.md).

# 更新日誌

## 2025/10/30 更新日誌 V4.3.6

1. 內地薪資管理社保公積金、個稅計算優化
2. APP 我的薪資單支持下載強積金報表
3. 審核管理加班套件優化，支援設定加班類型、加班時長
4. 假期管理請假人數上限優化，支援不同部門設定不同請假人數上限

## 2025/10/16 更新日誌 V4.3.5

1. 管理後台登錄界面改版和優化，支持Xero賬號、郵箱驗證碼登錄
2. 招聘流程優化，支持自定義招聘流程，確保招聘質量的統一性和規範性

## 2025/09/11 更新日誌 V4.3.4

1. 薪酬管理支持根據職級設置調薪項目的薪資，確認企業使用統一薪酬標準
2. 公告管理支持新增分組，發布公告新增簽收確認功能
3. APP外勤打卡優化
4. APP假期余額顯示優化

## 2025/08/14 更新日誌 V4.3.3.20250814

1. 審批管理優化計算公式功能，支持不同明細表格的數據計算
2. 員工假期余額優化，支持批量導出余額變更歷史
3. 排班制考勤組可設定員工排班可選擇的工作地點
4. 自助入職登記表和職位申請表增加篩選條件，支持快速查找員工

## 2025/07/10 更新日誌 V4.3.3

1. 薪酬管理增加成本中心，精確拆分人力成本
2. 薪酬管理增加工資單密碼設置，APP查看工資單需要驗證密碼
3. 排班管理一天多班次，支持班次時間重疊
4. APP和自助平台可查看假期余額變更歷史
5. 材料附件增加表格樣式，支持自定義字段，包括文本、日期、選項、數字等格式

## 2025/06/12 更新日誌 V4.3.2

**PC端**

1. 自助入職增加入職指引說明，可自定義說明內容和附件
2. 管理後台登錄界面改版和優化
3. 薪酬管理支持一個月多次調薪
4. 薪酬管理自定義公式增加考勤組和薪資組字段

## 2025/05/15 更新日誌 V4.3.1

**PC端**

1. 創建團隊體驗優化
2. 新團隊考勤和薪酬管理體驗優化，增加新手引導和入門指南
3. 管理後台增加幫助導覽，可以在線反饋和預約演示
4. YOOV平台訂閱功能優化，支持按月購買、信用卡自動續費

## 2025/04/08 更新日誌 V4.3.0.20250408

**PC端**

1. 補卡次數限制沒有計算審核中的補卡，可以一直提交 
2. 後台: 首頁的今日考勤概況與實際數據不符
3. 處理離職時沒有計算到手動發放的假期餘額
4. WORK訂閱方案增加免費版

## 2025/04/03 更新日誌 V4.3.0.20250403

**PC端**

1. 排班管理功能優化，支持選擇不同日期快速排班
2. 勤工獎扣款需求優化，扣款方式支持按固定金額、百分比、自定義公式
3. 假期扣減規則設置優化，額度配置規則支持按年、月、日

## 2025/03/27 更新日誌 4.3.0.20250327

**PC端**

1. 多次發薪功能優化
2. 行業計劃（日薪）的MPF report沒有顯示金額
3. 後台首頁簡體語言日歷顯示異常
4. 薪酬自定義公式增加無薪休息天數
5. 審批記錄員工選擇器支持選擇離職員工

## 2025/03/20 更新日誌 V4.3.0

**PC端**

1. 排班管理增加排班合規性設置，可設置工作日、節假日排班上限
2. 排班管理支持一天多班次
3. 排班管理按日排班可以劃線排班，生成臨時班次，不需要新增班次
4. 排班管理可以按人、按班次、按班組排班
5. 排班管理支持手動發布排班，提交發布後才生效
6. 排班管理支持按周期排班，適用於做一休一、三班倒等排班場景

## 2025/03/11 更新日誌 V4.2.9.20250311 

**PC端** 

1. 員工清單導入匯出員工優化 
2. 匯出的MFP報表其他工資項沒有計算 
3. 馬來西亞薪資調整計算邏輯

## 2025/03/06 更新日誌 (熱更新) V4.2.9.20250306 

**PC端** 

1. 審核範本-明細/表格增加說明控件，提交審核不顯示說明控件 
2. 員工詳情-切換員工，【薪資資訊-支付方式】和【其他資訊-自訂欄位】顯示異常 
3. 員工選擇器資料量太多，系統UI Checkbox有效能問題

## 2025/02/27 更新日誌 V4.2.9 

**PC端**

1. 審核管理的審批人節點支援選擇角色 
2. 員工辦理離職，實際離職日期支持選擇未來日期 
3. 請假月曆功能優化，允許查看同事請假支援配置可見範圍，包含可見所有人、可見本部門、可見自己 
4. 審核管理-請假套件增加請假證明配置，依請假類型、時長顯示填寫的內容 

## 2025/01/17 更新日誌 V4.2.8 

**PC端**

1. 薪酬管理工資項支援多語言設置 
2. APP電子工資單的工資項支援查看計算明細
3. 薪資管理增加週期設置，支援設定薪資表模板的發薪方式 
4. 優化馬來西亞薪資計算規則，使其符合當地政策與法規 

## 2024/10/10 更新日誌 V4.2.7 

**PC端**

1. 薪資管理新增薪資報表模組，可下載薪資明細、強積金等常用報表，並支援個人化自訂報表。 
2. 排班管理支援自訂選擇表頭，查看員工假期馀額，為員工安排班次。

## 2024/09/26 更新日誌 V4.2.6

**PC端**

1. 自助服務平台增加我的薪資單，支援查看和下載薪資單 
2. 操作審批單支援設定審核常用語，同意、拒絕、轉交、抄送核准可重複使用 
3. 審核模板創新功能，條件分支支援複製，讓複雜審批流程設計更加靈活高效 
4. 考勤組支援複製，範本重複使用，省時省力 
5. 考勤組管理支援設定人臉辨識打卡，確保每位員工打卡真實有效 
6. YOOV履歷助理與JobsDB無縫對接：優化發布職缺流程

**APP端** 

1. APP增加人臉辨識打卡，提升考勤管理安全性 
2. 修復已知問題，頁面操作體驗優化

## 2024/09/05 更新日誌 V4.2.5

1. 月薪資表：現在支援新舊版本的共存，根據使用習慣選擇版本。
2. 月工資表：所有工資項現在支援線上編輯，並且支援單一和批量操作。
3. 工資項：現在支援配置自訂公式。
4. 工資項計算公式：月薪表中的工資項新增了計算公式功能，可以查看計算規則和計算明細。
5. 自訂公式：我們增加了員工、考勤、薪資等系統字段，並新增了數學、統計、文字、日期、邏輯、循環等函數，讓您的自訂公式更加靈活。
6. 多次發薪：薪資管理可以配置半月薪和週薪。
7. 薪酬規則：計時、計件規則的產品線管理現在支援匯入和匯出。

## 2024/08/15 更新日誌 (熱更新) V4.2.4.20240815

1. 修復員工重新入職未自動解綁

## 2024/08/08 更新日誌 (熱更新) V4.2.4.20240808

1. 修復月工資表 導入起始月份之前的數據, 在線編輯問題
2. 優化月工資表, 導入起始月份之前的數據, 可以選擇員工貨幣
3. 優化蘋果手機-APP子表,單選項數據多會被存儲按鈕擋住
4. 優化APP子表配置選項關聯，其中一個選項設置字段是必填，發起審批提示異常
5. 優化導出審批紀錄的Excel 圖片連結整合了明細表單的所有圖片
6. 優化強積金規則-使用指南，英文文案
7. 優化考勤管理提醒設置

## 2024/07/23 更新日誌 V4.2.4

**PC端**

1. 審批詳情增加抄送功能，審批中和審批通過的審批單支持多人副本
2. 考勤管理增加外出打卡配置，支持外出不需要打卡
3. 自由工時考勤組增加打卡模式，支持上班下班交替打卡和一天兩次打卡
4. 固定制和排班制考勤組，增加休息日打卡方式，支持上班下班交替打卡和一天兩次打卡
5. 表單設計-控件庫樣式優化，單選支持批量添加，多選項支持選項關聯
6. 審批模板明細表格控件，增加凍結列功能，方便定位和修改數據

## 2024/07/04 更新日誌 V4.2.3

**PC端**

1. 優化管理後台-團隊列表支援轉讓團隊創建者
2. 優化權限管理-管理範圍增加自選人員
3. 優化當月考勤-打卡記錄-原始記錄篩選條件增加\[考勤來源]
4. 優化權限設定隱藏，員工資訊顯示編輯按鈕
5. 修復營運後台檢索團隊和查看團隊成員沒反應問題
6. 修復手動發放的假期跟隨假期規則的配置

## 2024/06/25 更新日誌 V4.2.2

1. 權限管理支持配置員工的管理範圍，包括員工數據、員工檔案庫、考勤數據、假期余額、月工資表、電子工資單等模塊。
2. 修復已知問題，頁面操作體驗優化

## 2024/05/30 更新日誌 (熱更新) V4.2.1.20240530

1. 架構圖部門人數可以點擊跳轉到人員管理頁
2. 團隊清單增加複製按鈕
3. 修改考勤組名稱，下載考勤報表和每日出勤不顯示新考勤組名稱
4. 修復考勤報表提交下載失敗
5. 修復APP工作台待處理數量和work審批待處理數量不一致
6. 修復審批範本明細表格控件-表單許可權，編輯欄位保存不生效
7. 並行分支審批人和辦理節點，需要依次審批和辦理

## 2024/05/21 更新日誌 (熱更新) V4.2.1.20240521

1. 文案優化：【加班時長自動計入餘額】只能使用一個假期 2 批量處理未簽訂合約的員工選擇簽約公司不生效
2. 支援審批摘要項目5個
3. 進階搜尋導出優化

## 2024/05/09 更新日誌 (熱更新) V4.2.1.20240509

1. 修復導出審批記錄及自定義文檔重覆問題
2. 調整18歲生日起計算強制性供款
3. 增加"應稅工資"在後台月工資表
4. AI功能使用時間延長至2024年06月30日

## 2024/04/18 更新日誌 V4.2.1

**PC端**

1. 員工列表增加自定義導出，可勾選需要導出的數據
2. 考勤報表支持下載最多12個月的數據
3. 工作性質、婚姻狀態、簽證類型、學歷等內容可自定義選項
4. 優化打開審批記錄的速度，APP和自助平台增加下載PDF功能
5. 離職結算增加待離職員工計算工資，生成電子工資單

## 2024/04/02 更新日誌 (熱更新) V4.2.0.20240402

1. APP小程式篩選資料介面優化
2. 刪除調動後已排班資料顯示問題
3. 考勤機序列號提示文案修改
4. 新增公告時，上傳圖片沒有正常運作
5. 更改失效日期，發放周期顯示錯誤
6. 批量編輯工資項目，修改系統計算保留小數位數，語言是英文，保存會報錯
7. 審批模板配置並行分支，紅框以下的地方沒有走下去

## 2024/03/07 更新日誌 (熱更新) V4.2.0.20240321

\[優化]

1. YOOV帳號綁定流程
2. AI檢測附件，AI生成面試題 【到期時間修改為6月31日】 
3. 自定義考勤機文案更新
4. 員工薪資詳情，放開所有年份篩選

\[修復] 

1. 導出職位申請表為PDF時, "其他訊息"在PDF 沒有顯示
2. 後台: 排班請假顯示問題 2.後台: 自助入職表的預覽入口問題
3. 制度列表查看範圍和員工性質不生效，制度列表已讀和未讀資料問題
4. 單選項、多選項、明細/表格-單選項、明細/表格-多選項修改選項內容沒有更新對應語言
5. 審核範本-表單控制項-單選項 【拖曳排序有問題，不生效】
6. 澳門地區-週假日加班補償方式 自定義按下去沒反應

## 2024/03/07 更新日誌 (熱更新) V4.2.0.20240312

1. 審核管理-流程設計增加辦理人節點
2. APP預定會議室，填寫會議描述，在使用者中心不顯示
3. 津補貼規則-扣發規則增加【全職】選項
4. 後台:導出工資匯總問題

## 2024/03/07 更新日誌 (熱更新) V4.2.0.20240307

1. 新增用戶中心- WORK應用程式增加簡約版
2. 優化自訂公式增加【單次加班時長】
3. 優化公眾假期與星期六重疊
4. 優化以Locum\_rate計算增加按時計薪
5. 優化ENSA津貼和ovn津貼
6. 修復當月考勤-請假紀錄，依月曆顯示請假，日期顯示不對
7. 修復每日平均工資計算問題
8. 修復顧客反映不能下載上年4月到6月份考勤報表 \[Codeco Technology Limited RWGYGFNW]
9. 修復後台更改部門排序和職位名稱後, APP不能顯示新的排序和職位名稱

## 2024/01/23 更新日誌 V4.2.0

**PC端**

1. 【考勤】考勤設定增加二維碼打卡方式
2. 【假期】按請假類型設定部門請假人數
3. 【審批】新增跨天調更申請
4. 【考勤】新增自訂義\[外出] 類型
5. 【假期】假期餘額明細增加\[累計發放假期]及\[累計扣減假期]
6. 【員工】合約管理增加無固定期限勞動合約類型
7. 【招募】新增列印候選人申請資料

**移動端**

1. \[考勤] 增加二維碼打卡功能
2. APP系統設定增加訊息通知開關，可設定是否接收推播通知及郵件
3. 優化APP橫幅通知
4. 修復已知問題，頁面操作體驗優化

## 2024/01/23 更新日誌 V4.1.9

1. 考勤設定增加二維碼打卡方式
2. 考勤新增自訂義\[外出] 類型
3. 按請假類型設定部門請假人數
4. 假期餘額明細增加\[累計發放假期]及\[累計扣減假期]
5. 審批管理新增跨天調更申請
6. 員工管理合約管理增加無固定期限勞動合約類型
7. 招募管理新增列印候選人申請資料

## 2023/12/26 更新日誌 (熱更新) V4.1.8.20231226

修復以下問題:

1. 沒打卡不能選擇半天請假
2. 每月出勤報表生成問題
3. 外出記錄-修改記錄問題
4. 外出記錄-先編輯再新增導致新增界面數據未清空
5. 審批流程提交加上提示
6. 調更申請選擇休息日顯示異常
7. 員工檔案-添加主管理員,員工檔案權限異常
8. 會議室更改為不可重複預定

## 2023/11/21 更新日誌 V4.1.8.20231121

修復以下問題:

1. WORK刪除員工同步用戶中心介面問題 【功能優化】
2. 工資項需要有創建時間的紀錄【新增功能】  
3. 權限管理-員工清單編輯權限樣式異常  
4. 員工管理-統計分析-趨勢分析 離職人數不顯示數據
5. 目前薪資一個員工顯示多筆調薪記錄  
6. 考勤管理-打卡記錄-批次匯入，考勤日期欄位必填
7. 刪除審核記錄報錯，審核記錄關聯附件刪除報錯
8. 假期餘額提醒，選項有勾選再關閉郵件還會發送問題
9.  \[抄送我]數字顯示問題
10. 熱更內容增加YOOV考勤機IC卡同步問題 【功能優化】
11. 員工清單：切換下一個員工，會清除選取的tab
12. .考勤報表新增了1個"TEST"嘅報表 選好同事及日子後, 下載的Excel是空白的
13. YOOV WORK主頁的生日提醒顥示錯誤 
14. 打卡方式：複製考勤人員，翻頁選擇不能累計

## 2023/11/07 更新日誌 V4.1.8

**PC端**

1. 【部門】增加批量導入部門功能
2. 【考勤】增加人臉信息，可同步人臉信息到不同考勤機
3. 【考勤】增加字段管理，自定義計算規則
4. 【考勤】增加考勤報表，生成符合自己需求的考勤報表
5. 【考勤】增加發起考勤結果確認，便於企業考勤結果核對及存檔
6. 【招聘】發布職位同步到JobsDB，人才庫和候選人支持AI解析簡歷
7. 【權限】增加管理範圍，可設置考勤、假期、排班、審批的數據權限

## 2023/10/08 更新日誌 V4.1.7.1

**PC端**

1. 【考勤】增加防作弊打卡，更好規範企業考勤管理
2. 修復已知問題，頁面操作體驗優化

## 2023/09/21 更新日誌 V4.1.7

**PC端**

1. 【員工】增加合約管理，幫助企業全面管理員工合約
2. 【假期】優化假期提醒規則，當假期發放、修改、扣減即發送提醒
3. 【審批】增加審批分析，對審批流程分析和優化，提高整體審批效率
4. 【招聘】增加AI生成面試題，能夠根據招聘職位生成面試題

## 2023/09/07 更新日誌 V4.1.5

**PC端**

1. 【薪酬】電子工資單支援分多次發放
2. 【薪酬】工資項目支援修改小數點位數
3. 【員工】新增人事表格，系統會根據範本中的變數，快速生成模板
4. 【審批】新增10個審批範本，滿足各類審批場景需求
5. 【員工】新增員工檔案庫，提升員工檔案管理的效率

## 2023/06/19 更新日誌 V4.1.0

**PC端**

1. 【考勤】在請假月曆中加上部門篩選條件
2. 【考勤】導出的排班表顯示請假類型
3. 【考勤】排班表的封鎖跟從截數日的期間
4. 【考勤】補卡時間的相關備注可以在月考彙總表顯示
5. 【考勤】新增Excel 報表：新增“無薪休息”的數據
6. 【考勤】每日出勤工時報表顯示日期欄位
7. 【考勤】考勤統計頁面支持轉換考勤組和月分
8. 【員工/假期】Excel導出篩選了的員工，而不是全部員工
9. 【考勤】當在班次設定遲到/早退豁免分鐘後 顯示時間調整
10. 【全局】下載審枇PDF時，可給一次過下載

## 2023/05/22 更新日誌 V4.0.0

**PC端**

1. 【薪酬】優化薪酬設置的操作欄位
2. 【考勤】變更排班管理員調動管理的權限
3. 【權限】員工列表管理範圍的存取、編輯及操作權限
4. 【考勤】排班表中設定418提醒
5. 【招聘】優化成功的候選人轉至員工的流程
6. 【薪酬】新增每月平均工資組別
7. 【薪酬】新增每日平均工資組別
8. 【薪酬】新增離職結算工資模組
9. 【假期】按員工職級派發假期
10. 【其他】修復已知問題，頁面操作體驗優化

## 2023/03/14 更新日誌 V3.6.0

**PC端**

1. 【考勤】排班管理可設置部門為篩選條件
2. 【考勤】排班管理新增複制班次功能
3. 【員工】離職管理—新增"刪除部門負責人/設置部門交接人"的功能
4. 【薪酬】新增假期考勤規則的計薪週期
5. 【薪酬】按年資設置強積金自願性供款規則
6. 【制度】查閱制度已讀未讀人數
7. 【招聘】以電郵通知候選人進行面試或獲聘
8. 【APP】根據考勤組權限查看更表
9. 【員工/薪酬】\[澳門版]新增社會保障基金受益人編號
10. 【其他】新增香港中國澳門以外地區通用國際版
11. 【其他】修復已知問題，頁面操作體驗優化

## 2023/02/08 更新日誌 V3.5.0

**PC端**

1. 【首頁】導出所有當天的提醒事項
2. 【員工】新增員工年齡限制及提示
3. 【員工】已離職員工保留資料並重新入職
4. 【員工】新增退休提示
5. 【員工】新增導出近12個月的工資情況
6. 【APP/考勤】新增簽到類型
7. 【假期】新增"按員工生日月" 的假期發放規則
8. 【假期】新增透支假期的上限設置
9. 【薪酬】新增修改過往月份工資項
10. 【審批】新增審批表數字框輸入時自動千位分隔符號
11. 【其他】修復已知問題，頁面操作體驗優化

## 2022/12/15 更新日誌 V3.4.0

**PC端**

1. 【全局】創建公司新增"省/洲"的選擇
2. 【假期】新增於員工假期餘額(明細)中可以部門名稱作篩選
3. 【薪酬】新增“按星期設置單價”和“按法定假期設置單價”計時規則
4. 【薪酬】新增計時規則額外設置選項
5. 【薪酬】強積金行業計劃分兩種計薪制度—日薪及非日薪
6. 【薪酬】月工資表中假期扣款能顯示出計算方式
7. 【自助平台/APP】新增批量轉交審批的功能
8. 【APP】“開啟手機定位及允許訪問位置”提醒更新
9. 【其他】修復已知問題，頁面操作體驗優化

## 2022/11/08 更新日誌 V3.3.0

**PC端**

1. 【員工】可展開或收起員工的任職紀錄
2. 【考勤】可在排班管理頁面搜索目標班次
3. 【考勤】可以調整班次的顯示順序
4. 【考勤】新增排班管理員的權限
5. 【權限】增加二級菜單的設置
6. 【審批】員工自助平台-新增審批搜尋器及日期篩選器
7. 【其他】修復已知問題,頁面操作體驗優化

## 2022/09/19 更新日誌 V3.1.0

**PC端**

1. 【考勤】在每日考勤中設置篩選條件
2. 【考勤】按開始、結束時間為請假紀錄排序
3. 【假期】設置硬性假期 (Block Leave)
4. 【假期】新增印尼全國公眾假期月曆
5. 【假期】新增澳洲全國公眾假期月曆
6. 【審批】設置審批的自定義項目
7. 【薪酬】5.5 天工作制的月計薪天數處理方法
8. 【薪酬】新增澳門地區社保規則
9. 【全局】所有導出功能，增加可以取消/按Esc，以中斷下載
10. 【其他】修復已知問題，頁面操作體驗優化

## 2022/06/20 更新日誌 V3.0.1

**PC端**

1. 【全局】重整系統模組架構及調整排序
2. 【全局】新增可為假期類型及審批表單欄位設置在不同顯示語言下的顯示內容，以處理公司/團隊用戶在選擇繁中/簡中/英文時，會顯示自設項相應的語言內容
3. 【員工】新增新員工可透過填寫自助入職表格完善個人檔案流程，紀錄可在自助入職>入職登記紀錄>完善個人檔案頁查看
4. 【員工/審批】新增欄位為“直屬上級”，以便處理審批人非部門主管之情況
5. 【假期】可處理假期預支的情況
6. 【招聘】新增電子職位申請表設置及功能，應徵者可增寫電子職位申請表，所輸入的資料及附件會自動上傳至系統
7. 【考勤/薪酬】考勤扣款規則從考勤模組之考勤規則調動至薪酬模組之薪酬規則
8. 【審批】新增修改審批單歷史管理，可先保存修改及後再發佈，或恢復過去保存版本
9. 【公司/團隊】APP管理：新增“請假月曆”相關設置
10. 【其他】修復已知問題，頁面操作體驗優化

## 2022/05/10 更新日誌 V2.4.5

**PC端**

1. 【員工】新增離職員工假期結餘記錄導出Excel列表功能
2. 【考勤】新增加班紀錄批量導入功能
3. 【考勤】排班制：可設置員工在休息日打卡自選班次時，亦可同時選擇工作地點
4. 【假期】新增員工假期餘額(明細)導出Excel 列表功能
5. 【假期】“按法定假日或公眾假期發放”的假期規則：可選“按半天”申請
6. 【薪酬】重置薪酬數據：可選擇重置哪些數據（月工資表數據、薪酬設置、固定工資數據、電子糧單數據）
7. 【審批】加班審批：“限時提交設置”調整為以“時”作為單位
8. 【其他】修復已知問題，頁面操作體驗優化

## 2022/04/25 更新日誌 V2.4.4

**PC端**

1. 【考勤】新增系統自動補班次內最後一次下班卡的功能
2. 【排班】鎖定過往工資月份對應之排班不能修改
3. 【假期】在員工檔案內新增“年資起始日期”，以處理年資非按加入該公司的入職日計算之情況
4. 【薪酬】新增計薪週期設置，以配合截數日的處理
5. 【薪酬】勤工獎可設定為基於上月的考勤紀錄來計算
6. 【薪酬】工資表內的“有效工作天數”開放可作調整
7. 【審批】加班及請假套件：將加班及請假原因從原來套件預定格分離，以可自行選擇原因是否為必填
8. 【其他】修復已知問題，頁面操作體驗優化


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.yoov.com/yoov-work/zh-hk/changelog.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.