Cookbook
Agents & skills · for AI agents

回答中的圖表 — 免費提供的功能與禁止事項

當回答包含可比較的數值時,您的代理程式會自動繪製圖表。無需開啟任何開關。您能控制的是數值是否位於知識庫中,以及衍生數值是否經過工具處理。

MCP tools:list_toolsupdate_agentsearch_knowledge_base

原則 — 代理程式可以複製數字,但絕不進行計算。 從檢索到的文字中複製是可靠的;算術運算則不然。本頁所有內容皆源自此一測量標準。更多資訊請參見 設計原則

當答案已包含一組可比較的數字時,代理程式會自動繪製圖表——在一般對話的中間,無需特別提示。無需任何啟用設定:任何擁有知識庫或工具的代理程式都會執行此操作。圖表會在小工具、主控台、測試面板和收件匣中呈現,並在 Telegram、WhatsApp 和螢幕閱讀器上退化成緊湊的表格。

因此,有用的問題不是「我如何開啟圖表」,而是 什麼因素決定了圖表會出現還是被丟棄。

每個數值都必須在素材中

在圖表呈現之前,會針對其執行確定性檢查:每個標籤與數值配對都必須出現在代理程式在該回合實際檢索到的段落中。若找不到某個配對,則整個區塊會被捨棄——訪客保留文字但失去圖片,且回覆中不會說明原因。

這項檢查意味著實際工作在於您的知識庫,而非任何設定:

  • 簡短、具體的文件勝出。 一篇從未提及價格的長篇產品介紹,在回答定價問題時會被檢索到,卻無法提供任何資訊。請為每個項目提供獨立的簡短文件,明確列出其數值。
  • 以人們詢問的方式書寫數字。 25M25,000,0002500万 都會被匹配,$4949 USD49 美元 亦然。單位不會被檢查,因此請將單位保留在數字旁邊的文字中。
  • 在依賴之前,請使用 search_knowledge_base 進行驗證。 如果回傳的段落中沒有數字,就不會產生圖表。

衍生數值需透過 compute_chart

股份、成長率、累計總額和帳單正是模型容易出錯的地方,也正是讓圖表值得觀看的原因。因此,代理程式不會自行計算:它將原始數值交給 compute_chart,平台在程式碼中計算該系列,並將數值填入圖表,而無需經過模型回傳。

derive用途提供給它
share佔總數的百分比labels + series
growth與上一期間的百分比變化labels + series
cumulative累計總額labels + series
project「每期成長 X%,共 N 期」baserate_pctperiods
tier「在此使用量下,成本為何」includedrate_per_unitbase_fee — 加上 base/rate_pct/periods 以在一次呼叫中進行預測和計費

該工具會自動附加到任何已有工具的代理程式上,因此通常無需新增。請在您的租用戶上透過 list_tools() 進行確認。

兩個值得了解的防護機制,因為它們解釋了為何圖表「應該出現卻沒出現」:

  • 輸入也會被檢查。 交給 tier 的價格必須在素材中以「貨幣」形式存在——旁邊需有貨幣符號。模型若捏造每月費用,會產生一個基於無人發布的數值所精確計算的帳單,圖表會因此被捨棄。
  • 單位必須一致。 includedrate_per_unit 和使用量數值必須使用相同的單位。若提供原始 token 的使用量和百萬級的額度,呼叫將被拒絕,而非以百萬倍的費率計費。

您無法設定的樣式,以及原因

圖表顏色源自您的主題顏色——整個配色方案,包括淺色和深色模式、懸停狀態和工具提示。一個設定,適用於所有圖表類型。

不要嘗試透過 custom_css 來調整圖表:它們是在畫布上繪製的,CSS 無法進入其中。針對圖表的規則不會被覆蓋,它只是無效,這比被拒絕更糟。如果圖表看起來不符合您的品牌,請更改主題顏色。

何時保持沉默

三個數值是底線——「從 120k 增加到 150k」是一句話,不是長條圖。是/否問題和單一數值查詢會得到答案,而非圖片。每則回覆最多兩個圖表,且僅當兩個測量值使用不同單位時才會出現第二個。

如果在該回合中未檢索到任何內容,就無圖可繪。代理程式會說明它所知道和不知道的,這與它處理文字時的做法相同。