Cisco IQ 如何为智能体时代设计 API

Cisco IQ 自设计之初就采用 API-first 架构，上周在 Partner Summit 2026 上正式开放了完整的生产级 REST API 套件和 Model Context Protocol（MCP）server，合作伙伴也可通过 API 与 MCP 接口把 Cisco IQ 能力集成进自己的托管服务。自 2026 年 4 月正式可用以来，已有超过 16,000 家客户部署 Cisco IQ。 Cisco IQ 的核心做法是只维护一份规范化领域模型：每个实体、关系、字段定义和业务规则只定义一次，OpenAPI 3.2 描述、数据存储 schema、细粒度权限目录以及智能体通过 MCP 使用的查询与工具契约都从这一模型编译生成，因此不会彼此漂移。API 在 URL 结构、CEL 查询参数、keyset 分页、RFC 9457 错误返回、JSON Merge Patch 与 ETag 并发控制上保持统一，权限直接按模型中的动作命名。 针对智能体，Cisco IQ 认为把每个 API 操作包装成单独工具并不够：在基线测量中，回答一个跨域问题、组装 40 行数据约需 120 次工具调用，数据关联被压到模型上下文窗口里，容易丢上下文并产生幻觉式 join。为此平台提供 Structured Query 和 Bulk Engine 两个通用操作，把跨域关联放到平台侧完成，Bulk Engine 还能自动解析依赖顺序并支持同步部分成功。 因此 MCP server 只暴露 discover、describe、query、mutate 四个工具，新实体加入后智能体可自动发现。智能体通过标准 API 认证接入 Cisco Unified Identity，继承调用方的授权范围，不会因走 MCP 获得额外权限。所有查询在执行前都会对照领域模型校验，出错时一次性返回结构化错误和已预校验的修正请求。在 17 个复杂企业场景的脚本测试中，总工具调用从 256 次降至 36 次，交互审批提示从 181 次降至 1 次，标准多域读取调查只需 discover 加 query 两次调用。