Agent API

很多“Agent 不稳定”问题，看起来像 prompt 问题，实际上是连接策略问题：

• 昨天输出正常，今天突然风格和质量都变了
• 成本突然飙升，但你不知道是哪条连接导致的
• 同一任务在不同会话里表现不一致

Agent API 的作用，就是把这些不确定性收敛：你明确连接，系统明确行为。

你真正关心的三件事

• 能力：这个连接能跑哪些模型，推理和代码质量到什么水平
• 稳定性：延迟、可用性、失败重试表现如何
• 成本：每条任务的价格和配额边界是否可控

什么时候该换连接

• 质量明显下降，且不是任务本身变化导致
• 延迟明显抖动，影响你的交付节奏
• 当前连接的成本结构已经不适合这个工作流

最实用配置策略

• 一个 Workspace 固定一条主连接，保证结果可比
• 生产和实验分开连接，别混在一条线上
• 先定连接与默认模型，再调 prompt

一句话：先把“路”修平，再追求“车”更快。

你可能需要的底层细节

连接入口在 设置 → Agent API。常见字段包括：

• name
• baseUrl
• apiFormat
• models / defaultModel / customModel

凭据存储：

• 配置：~/.tentarc/config.json
• 密钥：~/.tentarc/credentials.enc

模型解析优先级：

session model -> active connection default -> workspace defaults.model -> global config model -> DEFAULT_MODEL