回答内のチャート — 無料で得られるもの、そしてやってはいけないこと

原則 — エージェントは数値をコピーすることはできるが、計算してはならない。 取得したテキストからのコピーは信頼できますが、算術演算は信頼できません。このページの内容はすべて、この1つの測定から導き出されます。詳細は 設計原則 をご覧ください。

回答に比較可能な数値のセットがすでに含まれている場合、エージェントはプロンプトなしで、通常の会話の最中にそれらを図表化します。これを有効にするための設定は ありません：ナレッジベースやツールを持つエージェントであれば、誰でもこれを行います。チャートはウィジェット、コンソール、テストパネル、Inbox でレンダリングされ、Telegram、WhatsApp、スクリーンリーダーではコンパクトなテーブルにフォールバックします。

したがって、有用な質問は「チャートをどのように有効にするか」ではありません。それは 表示されるチャートと破棄されるチャートの違いは何なのか です。

数値はすべて素材に含まれていなければならない

チャートがレンダリングされる前に、決定論的なチェックが実行されます：各ラベルと値のペアは、エージェントが実際に取得した そのターン の段落に含まれていなければなりません。見つけられないペアがある場合、ブロック全体がドロップされます — 訪問者はテキストは保持しますが、画像を失い、返信にその理由が記載されることはありません。

このチェックがあるため、実務的な作業は設定ではなくナレッジベースで行う必要があります：

• 短く、具体的な文書が勝つ。 価格を一切記載していない製品に関する長いページは、価格に関する質問に対して取得されますが、何の回答もできません。各項目について、その数値を明記した短い文書を用意してください。
• 人々が尋ねる方法で数値を記載する。 25M、25,000,000、2500万 はいずれも一致し、$49、49 USD、49 美元 も同様です。単位はチェックされないため、数値の隣に単位をテキストとして含めてください。
• search_knowledge_base で検証してから依存する。 返された段落に数値が含まれていない場合、チャートも表示されません。

派生数値は compute_chart を通じて処理される

株式、成長率、累計合計、請求書は、モデルが誤って計算しがちな項目であり、同時にチャートを見る価値がある項目でもあります。そのため、エージェントはそれらを計算しません：検証済みの数値を compute_chart に渡し、プラットフォームがコード内でシリーズを計算し、モデルを介さずにチャートに数値が反映されます。

このツールは、すでにツールを持つエージェントに自動的にアタッチされるため、通常追加する必要はありません。テナントで list_tools() を実行して確認してください。

「表示されるはずだった」チャートの原因を説明する、知っておくべき2つのガードがあります：

• 入力もチェックされます。 tier に渡された価格は、素材内で 通貨として 存在していなければなりません — 通貨記号の隣にある必要があります。月次料金を捏造したモデルは、誰も公開していない数値に基づいて正確に計算された請求書を生成しますが、そのチャートはドロップされます。
• 単位は一致していなければなりません。 included、rate_per_unit、および使用量値はすべて同じ単位である必要があります。使用量を生のトークン数で、割り当てを百万単位で指定すると、レート百万倍での請求よりも、呼び出しが拒否されます。

スタイル設定できない理由と方法

チャートの色は テーマカラー から派生します — 全体のカラーパレット、ライトモードとダークモードの両方、ホバー状態、ツールチップです。1つの設定で、すべてのチャートタイプが適用されます。

custom_css からチャートを操作しようとしないでください：これらはキャンバス上に描画されており、CSS はその内部にアクセスできません。チャート対象のルールは上書きされるのではなく、単に何もしないため、拒否されるよりも悪いです。チャートがブランドに合わない場合は、テーマカラーを変更してください。

沈黙する場合

3つの数値が下限です — 「12万から15万に増加」は文であり、棒チャートではありません。Yes/No 質問や単一値の参照には、画像ではなく回答が返されます。返信あたり最大2つのチャートまで、2つ目は2つの測定値が異なる単位である場合にのみ表示されます。

また、そのターンに何も取得されなかった場合、描画するものは何もありません。エージェントは知っていることと知らないことを述べます — これはテキストの場合と同じ動作です。