Click 智能体 API：为应用接入托管 AI Agent

通俗易懂地解释：Click 是干什么用的？

Click 是一个面向开发者的托管智能体 API。你提供模型密钥、任务说明和允许调用的工具，Click 负责运行 AI Agent，保存会话历史，并处理模型调用、工具调用与执行恢复。应用通过 API 发送工作，再用事件流、Webhook 或读取接口取得结果。

可以把它理解为应用背后的“智能体运行服务”。例如，你的网站收到一份销售 CSV，希望 AI 读取数据、计算结果并生成 Markdown 报告：你负责界面、用户身份和业务规则，Click 提供智能体执行环境。它适合产品内置助手、后台调研、文件分析等需要多步处理的任务，接入仍需要后端开发。

Click 由 Click AI Labs, Inc. 运营。它的主要价值在于减少团队自行维护模型与工具循环、会话状态和后台执行的工作，而最终任务是否正确完成，仍需要应用侧检查。

从模型密钥到第一个智能体任务

一次完整接入可以按下面的顺序进行：

1. 在控制台准备 Click 平台 API Key，同时取得模型提供商的 API Key。按文档要求完成银行卡验证后，才能创建或修改资源；部分已有账户可能获豁免。验证本身不会收费或自动开启付费订阅。
2. 调用 POST /credentials 保存模型凭据，记录返回的凭据 ID。平台密钥和模型密钥都应保存在后端。
3. 通过 GET /models 查询当前模型目录，选择与凭据提供商匹配的模型。可用列表以接口返回为准。
4. 调用 POST /agents 配置模型、指令与工具授权，保存返回的 latest_version.id，再用它调用 POST /sessions 创建会话。
5. 向 POST /sessions/{session_id}/submissions 提交任务。为请求设置 request_id，可以在重试时取回原提交，减少重复提交的风险。
6. 读取提交状态，等待 done、cancelled 或 failed。完成时再读取它指向的答案条目；失败或取消时检查原因。

这里有个容易误解的细节：HTTP 202 代表输入已保存，不能据此认定 AI 已完成工作。把会话 ID 与自己的工单、文档或客户记录关联起来，才能在后续追问时继续使用对应历史。

接入 MCP、业务接口与文件处理能力

Click 支持连接 MCP Streamable HTTP 服务和自定义 HTTP 工具。连接需要使用公开可访问的 HTTPS 地址；创建连接后，还要明确授予智能体可用工具。HTTP 工具通过 JSON Schema 描述参数，平台以 JSON POST 调用接口，文档给出的调用超时为 120 秒。

实际接工单查询时，可以由业务后端提供一个只允许读取当前客户工单的接口，连接使用该用户范围内的短期令牌。智能体能调用工具，并不代表已经完成用户鉴权：后端依然要核实访问权限，应用也要自行管理预算、业务审批与结果检查。

平台还提供网页搜索、浏览器自动化和可读写文件、执行命令的沙箱。除 Click 托管沙箱外，文档列出 Blaxel、Daytona 方案；浏览器也可接入自己的 Browserbase 凭据。不同提供商的配置和费用需分别确认。

文件工作流建议使用 Click 托管沙箱：先通过 POST /files 上传输入，在任务中引用返回的文件 ID；让智能体处理工作副本，并调用 publish_file 保存交付物。最后查询会话 artifacts，再通过 GET /files/{file_id} 下载结果。沙箱中的临时工作文件与已发布的持久输出需要区分，生成后也应核对内容。

让长任务在后台运行，并把进度送回应用

通过 GET /sessions/{session_id}/events，应用可以显示文本增量、工具执行和任务状态。每次连接先返回完整状态快照，再推送后续事件；重新连接时要以新快照替换本地状态，避免遗漏或重复显示。

用户关掉页面或事件流断开后，任务仍可继续执行。会话进入 standby 时流会关闭，standby 本身不会因为读取事件流而被唤醒。需要后台交付时，可以订阅带签名的 submission.updated 和 artifact.created Webhook，再读取对应资源确认当前状态。前端展示、回调验签以及业务系统更新，都需要纳入自己的集成设计。

免费版和 Pro：平台费用与模型费用怎么算？

以下是 2026 年 11 月 3 日核实的官网美元月付标价，不是人民币报价或当地结算保证。最新条件请查看官方定价页。

• Free：0 美元/月。 2 个并发驻留会话、100 MB 文件存储；每月包含 1 小时托管沙箱、1 小时托管浏览器和 100 次搜索。
• Pro：199 美元/月。 50 个并发驻留会话、10 GB 文件存储；每月包含 100 小时托管沙箱、100 小时托管浏览器和 5,000 次搜索。
• Enterprise：定制报价。 并发、存储及托管资源额度按约定配置。

BYOK 表示使用自己的模型凭据，模型消耗不应理解为包含在上述免费额度或订阅价格中；自备第三方沙箱、浏览器等服务也可能产生独立费用。存储数字表示当前容量，并非每月新增空间；托管额度在租户内共享。Free 按 UTC 自然月重置，Pro 按付费账期重置。

并发统计包含具有运行时的活跃及空闲会话，standby 不计入。托管资源达到额度后，工具访问可能被拒绝，进行中的工作也可能停止；文档说明没有自动超额收费。因此，小规模试验应同时观察模型账单、会话并发和托管资源用量。

接入前要了解的数据处理与权限边界

Click 隐私说明表示，平台会处理指令、消息、上传和生成的文件、工具请求及结果，以及用户提供的连接凭据。执行任务时，相关信息可能发送给模型或工具提供商，并同时适用这些服务的政策。

官方说明团队可因入门协助、支持、排错及服务改进访问服务内容；保留时间按合理业务需要决定，没有给出统一固定天数。信息也可能在美国及其他国家处理。不能据此承诺本地部署、零保留或数据绝不用于训练。

密钥应放入指定凭据设置或接口，不应写进提示词和上传文件；政策要求不要提交受高度监管的敏感信息。对于客户数据，先确定允许提供的字段、工具范围和应用端审核规则，再用合适的测试材料验证整个流程。

常见问题

Click 可以免费使用吗？

可以。Free 提供有限的并发、存储、沙箱、浏览器和搜索额度，但模型调用使用自己的凭据，可能产生模型提供商费用。资源写入通常还需先完成银行卡验证。

需要自己准备模型 API Key 吗？

需要。官方采用 BYOK 路径：保存模型凭据，再从 GET /models 返回的目录选择匹配模型。Click 平台密钥与模型提供商密钥承担不同用途，都应留在后端。

能让智能体调用自己的业务接口吗？

可以。可连接 MCP 服务或自定义 HTTPS 工具，并授予对应权限。用户鉴权、短期令牌、预算和高影响动作的业务审批仍由应用负责。

官方资源与开发者入口

• API 参考文档：核对工具授权、事件、文件及 Webhook 的完整约定。
• 官方快速入门：按顺序完成凭据、Agent、Session 和任务提交。
• 服务条款与支持说明：查看托管服务条件及官方支持入口。