使用分析
通过详细的分析实时监控你的 API 用量。跟踪 Token 消耗、识别使用模式并优化你的集成。
访问使用分析
- 登录 Hindsight Cloud
- 在顶部导航栏中打开 Organization 菜单并选择 Usage
仪表盘概览
Usage 页面提供全面的分析，并每 30 秒自动刷新一次。
时间段选择
可选择三个时间段：
| 时段 | 数据粒度 | 适用场景 |
|---|---|---|
| 24 Hours | 按小时分桶 | 近期活动、调试 |
| 7 Days | 按天分桶 | 每周模式 |
| 30 Days | 按天分桶 | 月度趋势 |
点击时段按钮可切换视图。
汇总卡片
七张卡片显示所选时段的聚合指标：
总 Token 数
- 所有操作的合计使用量
- 显示带有 Activity 图标
Retain Token
- 由记忆存储操作消耗的 Token
- 蓝色色码
- 数据库图标
Recall Token
- 由记忆检索操作消耗的 Token
- 绿色色码
- 搜索图标
Reflect Token
- 由 AI 洞察操作消耗的 Token
- 紫色色码
- 大脑图标
Retrieve Model Token
- 由心智模型 GET 操作（轻量查找）消耗的 Token
- 青色色码
Refresh Model Token
- 由心智模型创建/刷新操作消耗的 Token
- 橙色色码
File Conversion (Iris) Token
- 由 Enhanced (Iris) 文件提取消耗的 Token
- 仅在使用过 Iris 提取时显示
- 按提取文本的输出 Token 计费
- 定价细节请参见 账单
每张卡片显示：
- 格式化的大数字（K 表示千，M 表示百万）
- 按操作类型用颜色编码
- 描述性图标
用量随时间变化的图表
一张堆叠面积图直观显示用量模式：
阅读图表
- X 轴：时间（24h 为小时，7d/30d 为天）
- Y 轴：Token 数
- 颜色：
- 蓝色：Retain
- 绿色：Recall
- 紫色：Reflect
- 青色：Retrieve Model
- 橙色：Refresh Model
- 红色：File Conversion (Iris)
交互功能
- 悬停：查看任意点的精确数值
- 图例：点击以切换操作类型
- 工具提示：显示按操作的分解
理解模式
注意：
- 峰值：突然的增加可能表示批量操作
- 规律：周期性高峰可能显示定时任务
- 趋势：逐步增加表明使用量在增长
按 API 密钥的用量
当 API 密钥被使用过时，会显示按密钥的用量分解：
密钥用量卡片
每张卡片显示：
- Key Name：你为密钥起的名称（或 "UI" 表示通过网页界面使用）
- Key Prefix：用于识别的前几位字符
- Token 分解：Retain、Recall、Reflect 计数
- Total：该密钥的合计 Token
- 百分比：占总使用量的比例
识别密钥
- 常规 API 密钥显示其自定义名称
- 通过网页界面的使用显示为 "UI" 并带有特殊标记
- 已撤销的密钥仅显示其前缀
优化用量
减少 Token 消耗
Retain 操作
- 在单次 API 调用中批量处理多条记忆
- 避免存储冗余信息
- 使用高效的文本格式
Recall 操作
- 使用具体、有针对性的查询
- 应用过滤器以缩小搜索范围
- 缓存常访问的结果
Reflect 操作
- 提出清晰、聚焦的问题
- 尽可能限制上下文
- 在类似查询之间复用洞察
心智模型操作
- 当近期数据足够时，检索模型而不是刷新
- 刷新模型会在内部运行 reflect，因此比简单检索成本更高
- 对频繁变化的记忆库谨慎使用自动刷新
文件转换（Iris）
- 对基于文本的文档（Word、Excel、文本文件、数字创建的 PDF）使用标准提取——它是免费的
- 仅在图像、扫描 PDF 和标准提取效果不佳的复杂版面文档中使用 Enhanced (Iris) 提取
监控成本
- 每周查看用量 以发现意外的增加
- 按 API 密钥审查 以识别低效集成
- 比较时段 以理解增长模式
数据解读
理解 Token 数
Token 是 AI 模型使用的子词单元：
- 一个英语单词 ≈ 1-2 个 Token
- 100 万 Token ≈ 75 万字
没有数据
如果未显示任何用量数据：
- 验证所选时间段
- 检查 API 密钥是否被使用过
- 确认你正在查看正确的组织
数据新鲜度
- 仪表盘每 30 秒自动刷新
- 历史数据可能有轻微延迟
- 实时用量在几分钟内准确