平台操作手册
本手册完整介绍 Agentsflare 租户侧控制台（https://Your-slug.agentsflare.com）的操作方法，按功能组织，每一步都配有页面截图。
控制台支持中文和英文两种语言。本手册中每张截图都提供两个版本：中文（后缀 -zh）和英文（后缀 -en）。
1. 登录
在浏览器打开控制台地址，输入账号邮箱和密码，点击登录。
图1：登录页面
如果忘记密码，点击**忘记密码？**进行重置。
2. 仪表盘
登录后进入仪表盘，一览组织的用量情况。
顶部是三个统计卡片：
- 总费用 — 所选时间段内的总消费（美元）。
- 总Token — 消耗的总 Token，分为输入和输出。
- 总调用 — API 请求总次数。
卡片下方是趋势图（费用趋势、Token 趋势、调用趋势）和四个「Top 5」面板（项目 Top 5、API Key Top 5、模型 Top 5、模型品牌 Top 5），分别按费用、Token 量、调用量排序。
使用顶部筛选器缩小查看范围：日期范围选择器（默认今天）以及项目 / API Key / 模型品牌 / 模型下拉框。
图2：仪表盘
3. 模型
模型页面列出了组织可用的所有模型，每行显示：
- 模型 ID — API 调用时使用的模型标识（点击复制图标可复制）。
- 品牌 — 模型供应商。
- 价格表 — 模型所属的价格表。
- 发布日期 — 模型上线日期。
- 上下文长度 — 模型最大上下文窗口。
- 输出上限 — 最大输出 Token 数。
使用搜索框按 ID 查找模型，用品牌筛选器按供应商过滤，用显示列控制列显隐。
图3：模型列表
4. 项目管理
企业可以对内部不同团队或产品创建多个项目，用于资源隔离和费用独立核算。
项目管理页面列出所有项目及其名称、创建时间和关联 API Key 数量，支持搜索、导入 / 导出和显示列。
图4：项目管理页面
创建项目
在项目管理页面顶部点击新建项目。
图5：新建项目弹窗
输入项目名称（例如「项目A」），点击创建即可创建项目。
5. API Key 管理
API Keys页面列出所有 API Key，每行显示 Key 名称、脱敏后的 Key 值（sk-agf-...）、所属项目、模型限制、过期时间和创建时间。
图6：API Keys 列表
注意： API Key 属于项目级别；Key 值仅在创建时显示一次，请妥善保存。
创建 API Key
点击新建 API Key。
图7：新建 API Key 弹窗
输入名称并选择所属项目，点击创建——API Key 会自动生成并仅返回一次。
编辑 API Key
点击该行的操作菜单，选择编辑打开编辑弹窗，可修改名称、状态和过期时间（过期时间留空表示永不过期）；弹窗同时展示创建/更新时间与变更历史。
图8：编辑 API Key 弹窗
配置模型限制
点击某行的模型限制值（例如 claude-opus-4-6 / ...）打开模型限制配置弹窗，勾选该 API Key 允许访问的「模型-通道」组合，点击保存。
图9：模型限制（模型-通道选择）
6. IP 白名单
IP 白名单用于限制 API Key 仅允许来自指定 IP 地址或 CIDR 网段的请求，增强 API 调用安全。它是全局配置：一旦配置，对所有 API 请求生效；列表为空时不做任何限制。
图10：IP 白名单页面
添加规则
点击新建规则，选择地址类型（单个 IP 地址或 CIDR 网段），填写地址和可选描述，点击创建。
图11：添加 IP 白名单规则
重要： 添加白名单前，请确保你当前的 IP 已包含在内，否则你的 API 请求会被拒绝。
7. 配额管理
配额规则用于控制和限制 API 消费，防止意外的高额费用。配额管理页面列出所有规则及其对象类型、适用范围、周期、额度上限和创建时间。
图12：配额管理页面
创建配额规则
点击新建规则，配置：
- 配额对象类型 — 例如 API Key。
- 适用范围 — 该类型下的全部对象，或指定单个对象（类型规则作为该类型下所有对象的默认上限；单体规则为指定对象覆盖类型规则）。
- 周期 — 重置周期（例如每日）。
- 额度上限（USD） — 一个周期内允许消费的最大金额，超出后请求将被拒绝。
- 规则名称 — 便于后续搜索与管理的显示名称。
点击创建。
图13：新建配额规则弹窗
临时配额
点击临时配额管理进入临时配额页面，可创建短期覆盖规则（例如为某次活动临时提高上限），点击新建临时配额添加。
图14：临时配额（Quota Overrides）
8. 告警监控
告警监控在关键指标越过阈值时通知你。告警规则页面列出所有规则。
图15：告警规则页面
创建告警规则
点击新建规则，打开两步向导。
第 1 步 — 告警规则。 选择监控指标（例如配额使用率百分比或预付费余额），填写名称、比较运算符（如 >）、阈值和冷却时间（分钟，同一规则在冷却时间内仅触发一次），点击下一步。
图16：新建告警规则 — 第 1 步
第 2 步 — 通知渠道。 选择通知方式。可创建新的 Webhook（填写名称、类型、URL、自定义请求头和消息模板，模板支持 ${ruleName}、${triggerValue}、${threshold}、${viewLink} 等变量），测试后点击完成；也可以点击跳过仅记录告警不通知。
图17：新建告警规则 — 第 2 步（通知渠道）
告警记录
告警记录页面展示历史告警及其指标、触发时间、状态和已读状态，可用标记已读 / 批量标记已读管理读取状态。
图18：告警记录页面
9. Webhooks
Webhooks 将事件（告警触发或 API 请求完成）推送到你的 HTTPS 地址。Webhooks页面列出所有已配置的 Webhook。
图19：Webhooks 页面
创建 Webhook
点击新建 Webhook，选择事件，填写名称、类型和 URL（必须为 HTTPS），添加可选的自定义请求头，定义消息模板（Payload JSON）（可用恢复预置模板重置）。点击测试发送验证投递，再点击创建。
图20：新建 Webhook 弹窗
投递记录
投递记录页面记录每一次投递尝试，包括状态、目标 Webhook、重试次数和投递时间。
图21：Webhook 投递记录
10. 费用中心
充值记录
充值记录页面列出所有充值，包括充值金额（美元）、余额（美元）和创建时间，可用导出下载记录。
图22：充值记录页面
日志明细
日志明细页面展示每一次 API 请求的时间、总 Token、费用和响应耗时，可按日期范围、项目、通道和 API Key 筛选，用刷新重新加载。
图23：日志明细页面
用量分析
用量分析页面聚合用量统计。选择日期范围和维度，按按项目 / 按品牌 / 按模型 / 按API Key查看指标（调用次数、输入/输出/总 Token、费用），可用导出下载报告。
图24：用量分析页面
11. 审计日志
审计日志页面记录控制台操作以便追溯，可按日期范围、操作、资源类型、操作人和状态筛选，支持导出和刷新。
图25：审计日志页面
12. 设置
账号设置页面可修改控制台语言（中文 / English）和时区，修改后点击保存，页面会以新语言刷新。
图26：账号设置（语言与时区）