Agentic Trust

⚠️ Pain Points

Traditional API gateways were never designed for the AI Agent era.

Agent 调用不可区分

人工与 Agent 调用混在同一个 API Key 里，无法独立统计和管控。管理员完全分不清哪些是人在用、哪些是 Agent 在跑。

成本失控

没有单 Agent 预算限制。一个有 Bug 的 Agent 循环调用能在你发现前烧光所有账户余额。

审计缺失

所有调用匿名。出问题时只能看到 IP 和 Key，几小时都定位不到根因。

限流一刀切

一个限流规则影响所有 Agent。要么限制太松防不住，要么限制太紧误伤正常业务。

How It Works

Just one HTTP header. No code changes needed.

🤖 Agent 应用

在请求中添加身份头
X-Agent-Identity

→

🛡️ TokenCNN 网关

解析身份 + 执行策略
熔断/限流/告警

→

📊 监控面板

单 Agent 费用统计
调用频率 + 信任评分

代码示例

在现有 SDK 中增加一个 Header 即可启用，无需任何其他改动。

# Python: 使用 OpenAI SDK 添加 Agent 身份
from openai import OpenAI
 
client = OpenAI(
  api_key="sk-your-key",
  base_url="https://www.tokencnn.com/v1"
)
 
# 只需添加这一行：声明 Agent 身份
client.default_headers = {
  "X-Agent-Identity": "name=code-reviewer;purpose=pr-review;owner=team-alpha"
}
 
# 之后的每次调用都会自动带上身份信息
resp = client.chat.completions.create(
  model="qwen3.5-flash",
  messages=[{"role": "user", "content": "review this PR"}]
)

# curl 用法
curl https://www.tokencnn.com/v1/chat/completions \
  -H "Authorization: Bearer sk-your-key" \
  -H "X-Agent-Identity: name=my-bot;purpose=customer-service;owner=support" \
  -H "Content-Type: application/json" \
  -d '{"model": "qwen3.5-flash", "messages": [{"role": "user", "content": "你好"}]}'

💡 X-Agent-Identity 格式：name=标识名;purpose=用途;owner=归属团队
三个字段均为可读字符串，方便在 Dashboard 中区分和统计。

Core Features

🎯

单 Agent 独立熔断

异常 Agent 单独限流/熔断，不影响同一 Key 下其他正常 Agent 和人工调用。

🔍

全链路审计追溯

每笔调用按 Agent/用途/归属者维度记录。问题定位从小时级缩短到分钟级。

⭐

动态信任评分

5 维评分（波动性/稳定性/多样性/时段/历史）。低分自动降权，高分优先路由。

🛡️

Agent 级策略控制

预算额度、限流阈值、可用模型范围均可按 Agent 独立设置，不再一刀切。

FAQ

需要修改代码吗？▾

完全不需要修改业务代码。只需在创建 OpenAI 客户端时添加一个 HTTP Header（X-Agent-Identity），对现有的 API 调用逻辑零侵入。如果忘记添加，调用会正常处理，只是不会被标记为特定 Agent。兼容所有 OpenAI SDK（Python、Node.js、Java、Go 等）。

会额外收费吗？▾

Agentic Trust 对当前所有套餐免费开放。您只需支付正常的 API 调用费用，新增的 Agent 身份标识功能不产生额外费用。Dashboard 和信任评分功能也免费使用。

支持哪些模型？▾

TokenCNN 平台上的所有模型均支持 Agentic Trust，包括 qwen3.5-flash、deepseek-v4-flash、glm-4.7-flash 等 200+ 模型。无论使用哪个模型，只需在请求中添加 X-Agent-Identity 头部即可启用。

一个 API Key 下可以有多少个 Agent？▾

不限数量。每个 Agent 由 X-Agent-Identity 中的 name 字段唯一标识。您可以为不同的用途、团队、项目分别声明不同的 Agent，系统会自动识别并独立统计。Dashboard 中会列出所有活跃的 Agent 及其费用和信任评分。

信任评分是怎么计算的？▾

基于 5 个维度的行为分析：① 调用量波动性（是否忽高忽低）② 请求间隔稳定性（是否均匀）③ 模型多样性（是否只调用单一模型）④ 时段分布（是否在非工作时间大量调用）⑤ 活跃历史（稳定运行时间越长评分越高）。评分范围 0-100，系统每 6 小时更新一次。

低信任 Agent 会怎么样？▾

LOW 信任（0-30 分）：系统自动降低其日预算上限，触发告警通知。MEDIUM 信任（30-70 分）：标准限制，定期审查。HIGH 信任（70-90 分）：提高预算上限，优先分配高质量路由通道。TRUSTED（90-100 分）：最高限额，优先响应。