2026 年 4 月 13 日：改进 Cortex Agents 中 SQL 的生成机制

现在，使用 Cortex Analyst 语义视图作为工具的 Cortex Agents 可直接生成 SQL，而不再将 SQL 生成作为单独步骤委托给 Cortex Analyst 服务。这将提升分析查询的准确性并降低延迟。

代理配置中的工具定义保持不变。无需更改代理配置或语义视图。语义视图中定义的其他资源（如 Cortex Search 服务）仍会继续被代理使用。

响应格式变更

  • 类型为 cortex_analyst_text_to_sql 的工具使用和工具结果块已替换为 system_execute_sql 类型的块。system_execute_sql 类型的工具使用块包含一个 sql 字段，其中存放由代理生成的 SQL。工具结果块包含 query_id、result_set 以及最终的 sql。

  • 如果您的应用程序会解析代理响应中的 cortex_analyst_text_to_sql 数据块，请将其更新为识别 system_execute_sql。

可观察性变更

  • 在 CORTEX_AGENT_USAGE_HISTORY 视图中，TOKENS_GRANULAR 和 CREDITS_GRANULAR 列将不再包含服务类型为 cortex_analyst 的记录。所有令牌和 Credit 使用量现统一归入 cortex_agents。

  • 在 代理监控日志 中，执行追踪跨度将显示 system_execute_sql，而不再显示 Cortex Analyst 工具调用。如果您的监控查询基于工具类型进行筛选，请同步更新相关逻辑。