답변의 차트 — 기본 제공 기능과 금지 사항
답변에 비교 가능한 숫자가 포함되어 있으면 에이전트가 차트를 그립니다. 별도의 활성화 설정은 필요하지 않습니다. 사용자가 제어할 수 있는 것은 해당 수치가 지식 베이스에 있는지, 그리고 유도된 숫자가 도구를 통해 처리되는지 여부입니다.
list_toolsupdate_agentsearch_knowledge_base원칙 — 에이전트는 숫자를 계산하지 않고 복사만 합니다. 검색된 텍스트에서 숫자를 복사하는 것은 신뢰할 수 있지만, 산술 연산은 그렇지 않습니다. 이 페이지의 모든 내용은 이 하나의 측정 항목에서 비롯됩니다. 자세한 내용은 디자인 원칙을 참조하십시오.
답변에 이미 비교 가능한 숫자 세트가 포함되어 있으면, 에이전트는 프롬프트 없이도 일반 대화 중간에 이를 차트로 그립니다. 이를 활성화할 별도의 설정이 필요하지 않습니다. 지식베이스나 도구를 갖춘 모든 에이전트는 이를 수행합니다. 차트는 위젯, 콘솔, 테스트 패널 및 Inbox에서 렌더링되며, Telegram, WhatsApp 및 스크린 리더에서는 컴팩트한 테이블로 대체됩니다.
따라서 유용한 질문은 "차트를 어떻게 켜는가"가 아닙니다. 차트가 표시되는 것과 버려지는 것을 구분하는 요소는 무엇인가입니다.
모든 수치는 자료에 포함되어야 합니다
차트가 렌더링되기 전에 결정론적인 검사가 실행됩니다. 각 레이블-값 쌍은 에이전트가 해당 턴에 실제로 검색한 구절에 반드시 존재해야 합니다. 찾을 수 없는 쌍이 있으면 전체 블록이 삭제됩니다. 방문자는 텍스트는 유지하지만 그림은 잃게 되며, 답변에는 그 이유에 대한 언급이 없습니다.
이러한 검사 때문에 실용적인 작업은 설정이 아닌 지식베이스에서 이루어집니다.
- 짧고 구체적인 문서가 우세합니다. 가격이 명시되지 않은 긴 제품 페이지는 가격 관련 질문을 위해 검색되더라도 아무런 정보를 제공하지 못할 것입니다. 각 항목에 해당 숫자를 명시하는 짧은 문서를 각각 제공하십시오.
- 사람들이 묻는 방식으로 숫자를 작성하십시오.
25M,25,000,000,2500만은 모두 일치하며,$49,49 USD,49 美元도 마찬가지입니다. 단위는 확인되지 않으므로 숫자 옆에 단위를 텍스트에 포함하십시오. search_knowledge_base를 통해 신뢰하기 전에 검증하십시오. 반환된 구절에 숫자가 없으면 차트도 생성되지 않습니다.
파생된 숫자는 compute_chart를 통해 처리됩니다
주식, 성장률, 누계 합계 및 청구서는 모델이 정확히 틀리는 부분이며, 동시에 차트를 볼 가치가 있게 만드는 요소입니다. 따라서 에이전트는 이를 계산하지 않습니다. 대신 원문 그대로의 숫자를 compute_chart에 전달하며, 플랫폼은 코드를 통해 시리즈를 계산하고, 모델로 다시 전달하지 않고도 숫자를 차트에 채웁니다.
derive | 용도 | 제공해야 할 항목 |
|---|---|---|
share | 전체 대비 비율 | labels + series |
growth | 이전 기간 대비 변화율 | labels + series |
cumulative | 누계 합계 | labels + series |
project | "N 기간 동안 기간마다 X% 성장" | base, rate_pct, periods |
tier | "해당 사용량에서 비용은 얼마인가" | included, rate_per_unit, base_fee — 그리고 base/rate_pct/periods를 사용하여 한 번의 호출로 프로젝트 및 청구 |
이 도구는 이미 도구를 갖춘 모든 에이전트에 자동으로 연결되므로, 일반적으로 추가할 것이 없습니다. 테넌트에서 list_tools()를 통해 확인하십시오.
"표시되어야 했는데" 표시되지 않은 차트의 원인을 설명하는 두 가지 주의할 사항을 알아두십시오.
- 입력값도 검증됩니다.
tier에 전달된 가격은 자료에 통화 표시와 함께 존재해야 합니다. 모델이 월 요금을 임의로 생성하면, 아무도 게시하지 않은 숫자를 기반으로 정확하게 계산된 청구서가 생성되지만, 차트는 삭제됩니다. - 단위가 일치해야 합니다.
included,rate_per_unit및 사용량 값은 모두 동일한 단위를 사용해야 합니다. 사용량을 원시 토큰 단위로 제공하고 허용량을 백만 단위로 제공하면, 백만 배의 요금으로 청구되기보다는 호출이 거부됩니다.
스타일링할 수 없는 이유와 방법
차트 색상은 테마 색상에서 파생됩니다. 라이트 모드와 다크 모드 모두의 전체 팔레트, 호버 상태 및 툴팁이 포함됩니다. 하나의 설정으로 모든 차트 유형에 적용됩니다.
custom_css를 통해 차트에 접근하려고 시도하지 마십시오. 차트는 캔버스에 그려지며, CSS는 캔버스 내부에 접근할 수 없습니다. 차트를 타겟팅하는 규칙은 재정의되는 것이 아니라 단순히 작동하지 않으며, 이는 거부되는 것보다 더 나쁜 결과입니다. 차트가 브랜드에 맞지 않는다면 테마 색상을 변경하십시오.
침묵하는 경우
세 개의 숫자가 최소 기준입니다. "120k에서 150k로 증가"는 문장이지 막대 차트가 아닙니다. 예/아니오 질문 및 단일 값 조회에는 그림이 아닌 답변이 제공됩니다. 최대 두 개의 차트까지 지원되며, 두 번째 차트는 두 측정 항목의 단위가 다를 경우에만 표시됩니다.
그리고 해당 턴에 검색된 것이 없으면 그릴 것이 없습니다. 에이전트는 아는 것과 모르는 것을 말로 표현하듯, 그대로 전달합니다.