Changelog

新增端点

ElevenAgents

• 新增 9 个对话分诊工单端点：
  • 创建对话工单 - POST /v1/convai/triage-tickets。请求需要 conversation_id（字符串），并接受 qa_comment（可为 null 的字符串，1–10,000 个字符）以及最多 200 条轮次评论。
  • 列出工单 - GET /v1/convai/agents/{agent_id}/triage-tickets，支持游标分页。
  • 创建手动工单 - POST /v1/convai/agents/{agent_id}/triage-tickets。请求需要 qa_comment（字符串，1–10,000 个字符）。
  • 列出可分配用户 - GET /v1/convai/agents/{agent_id}/triage-tickets/assignable-users。响应会列出非服务账号的工作区成员，以及每位成员是否有权访问该智能体。
  • 获取工单 - GET /v1/convai/triage-tickets/{agentqa_ticket_id}。
  • 更新工单 - PATCH /v1/convai/triage-tickets/{agentqa_ticket_id}。请求接受可选的 status 和可为 null 的 assignee_user_id。
  • 删除工单 - DELETE /v1/convai/triage-tickets/{agentqa_ticket_id}。
  • 添加评论 - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/comments。请求需要 comment（字符串，1–10,000 个字符）。
  • 添加轮次评论 - POST /v1/convai/triage-tickets/{agentqa_ticket_id}/turn-comments。请求需要从 0 开始的 turn_index（整数）和 comment（字符串，1–10,000 个字符）。

更新的端点

ElevenAgents

• 获取签名 URL - GET /v1/convai/conversation/get-signed-url
  • 新增可选的 debug_events_request（布尔值，默认 false）。调试事件需要智能体编辑者权限。
• 获取 WebRTC token - GET /v1/convai/conversation/token
  • 新增可选的 debug_events_request（布尔值，默认 false）。旧版 GET /v1/convai/conversation/get_signed_url 路由接受相同参数。
• 列出对话 - GET /v1/convai/conversations
  • 新增可选的 triggered_procedure_ids（可为 null 的字符串数组，最多 50 个），用于匹配运行过任一指定操作流程的对话。
  • 新增可选的 include_invalid_tool_calls（布尔值，默认 false），以包含未运行的工具调用。
  • 新增用于通话开始时间的可选 sort_direction（asc 或 desc，默认 desc）。
• 文本搜索对话消息 - GET /v1/convai/conversations/messages/text-search
  • 新增可选的 triggered_procedure_ids（可为 null 的字符串数组，最多 50 个）。
  • 新增可选的 include_invalid_tool_calls（布尔值，默认 false）。
• 获取智能体对话主题 - GET /v1/convai/agents/{agent_id}/topics
  • 新增可选的 include_evaluation_criteria（布尔值，默认 true）。
  • sort_by 新增 frustration。
  • 主题响应新增可为 null 的 success_rate（数字），整体响应新增 aggregated_run_count（整数，默认 0）。
  • from_unix_secs 会向下取整至其 UTC 日期的起始时间。有界范围会聚合已完成的每日发现运行；省略两个边界则返回最新运行。
• 列出操作流程（GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures）和 获取操作流程（GET /v1/convai/agents/{agent_id}/branches/{branch_id}/procedures/{procedure_id}）
  • 新增可选且可为 null 的 agent_version_id（字符串），用于从特定智能体版本获取操作流程。
• 创建测试 和 更新测试
  • 响应、模拟和工具调用单元测试 schema 新增可选且可为 null 的 environment（字符串）。该值用于选择特定环境的 URL、标头和身份验证连接；默认为 production。
• 创建 URL 文档、创建爬取任务 和 创建文件夹
  • 自动同步新增可选且可为 null 的 minimum_frequency_days（整数，1–180）。默认值为 7，更严格的父文件夹频率优先。

音乐

• 列出音乐 Finetune - GET /v1/music/finetunes
  • 最大 page_size 从 100 提高到 150。默认值仍为 50。

Schema 变更

ElevenAgents

• 智能体更新请求新增可选且可为 null 的 procedures（object<string, ProcedureVersionRef>）。每个值都需要 procedure_id 和 version_id（字符串）。空对象会移除所有操作流程。
• 对话初始化配置新增 enable_procedure_ids_from_client（布尔值，默认 false）。初始化数据新增可选且可为 null 的 procedure_ids（字符串数组）；空数组会禁用起始智能体的所有操作流程。
• ClientEvent 新增 context_usage。
• 软超时覆盖新增可选且可为 null 的 additional_soft_timeout_messages（字符串数组）。
• 分析和 schema 覆盖模型中的常量值现在接受 null。
• 小组件配置中 mic_muting_enabled 和 transcript_enabled 的默认值已从 false 改为 true。请显式将其设为 false 以保留此前行为。

工作区

• 获取用户 响应已从 UserResponseModel 移除 xi_api_key。
• ResourceMetadataResponseModel.role_to_group_ids 现在接受自定义角色 ID 作为键，不再将键限制为 admin、editor、commenter 和 viewer。
• 直接发布响应新增可选且可为 null 的 restricted_to_user_email_domains（字符串数组）。
• 待处理订阅切换响应的 next_tier 新增 go。