用途
本技能用于在明确指定的 Speakeasy AI Control Plane 项目中，探索客户自定义信号随时间的变化，以及它在可用属性上的分布。它回答关于已采集活动的范围明确的问题，并保留匹配规则、计数口径和限制说明。
主要能力
- 通过该客户端自身的连接调用 list_projects，选择用户指定的确切项目。
- 调用 describe_analytics_catalog 获取有权使用的信号度量契约、当前传感器名称、模式、有序信号成员和信号名称。该能力需要 Signals Intelligence 与项目读权限。
- 通过 list_analytics_dimension_values 发现标签：使用 dataset: signals、包含传感器和 trigger/run 的 signal_scope，以及 dimension: attribute_keys；发现具体值时使用 dimension: attribute 和确切的属性键。
- 调用 run_analytics_query 执行语义化查询，参数包括 dataset: signals、明确的 from/to、grain: auto（或允许的 UTC 区间）以及 signal_query。
- signal_query 支持 selection（sensor_id、signal_id 或 minimum_level，以及 threshold）、trigger（stream 或带确切 run_id 的 manual）、group_by（结构化的 {attribute: key} 或 {field: name}）、filters（以 AND 连接的 dimension/operator/value 对象，exists 和 missing 不带值），以及可选的 groups 和 points 预算。
- 当定义混合或需要检查解释时，调用 get_signal_definition 获取确切贡献的传感器和指纹。
- 对跨会话问题调用 find_signal_sessions，使用相同窗口、来源和谓词并省略 group_by；presence 和 breadth 统计确切的对话数，concentration 用顶会话命中数除以所有链接到对话的命中数。
- compare_previous: true 可保留上一窗口的值、描述性占比差异和可比性门槛。
- 请求 evidence: true 可获得有界的允许示例，但不包含完整转录或穷尽会话列表。
使用方式
- 先成功调用 list_projects，并选定用户请求的确切项目。
- 用该项目 ID 调用 describe_analytics_catalog，确认可用的传感器、信号和有序层级。
- 选择能回答用户问题的传感器及其信号；共享信号标识不代表不同传感器等价。
- 明确说明时间窗口和匹配规则：多标签概率阈值、独占选定信号，或零基有序层级上等于或高于某层的累计概率。仅在明确说明时，探索性阈值可用 0.5；它不是通用的质量或严重性标准。绝不要对 expected_index 做阈值判定或取平均。
- 需要时用 list_analytics_dimension_values 发现属性键和值；present: false 表示缺失，present 的空字符串属于另一分组。department、model_family、inference_provider、model_name 等只是起始标签，不是封闭词表。
- 调用 run_analytics_query，使用语义化请求而非自行拼装的 measures/dimensions。若物理读取被拒绝，可缩小窗口；仅输出更粗粒度并不能减少扫描的规范输入。
- 用 signal_result.metadata、signal_result.summary、signal_result.groups 和按 series_id 连接的完整顶层 rows 解释结果。
结果解释
- 区分匹配消息、精确去重会话、在已测量回答中的占比，以及 failed/not_applicable/draft/unmeasured 等伴随计数和未知的普查覆盖范围。
- 缺口表示未知，不能当作有支撑的零。
- 报告部分边缘桶和顶部分组的选择情况。
- 同一会话可属于多个属性组，因此去重会话计数不可相加。
- 诸如 invalid_evaluation_context 的终端事件级失败不会产生传感器结果；它们计入未知普查覆盖，而不计入 failed 计数器或其他传感器结果伴随项。
解释与比较
- 历史快照可能不可用；当前配置不是对过去测量的重建。定义、分类器或输入变化都可能解释趋势。
- 对跨会话问题，使用相同窗口、来源和谓词调用 find_signal_sessions，省略 group_by。对等的谓词会产生独立的同消息和同会话联合回答分母，不要互换单位。
- compare_previous: true 保留上一值、描述性占比差异和失败可比性门槛；近期窗口、稀疏观察或定义变化不支持无保留的趋势声明。即使门槛通过，未知普查覆盖仍是限制。
- evidence: true 仅在支持性对话引用有帮助时请求；结果为有界的允许示例，缺失示例不能证明匹配活动不存在。
适用场景
适合在已配置的项目中探索信号趋势、属性分布和跨会话出现范围，并需要在报告中同时保留范围、规则、分子/分母、支撑度量、查询时间和限制的描述性分析。
限制
- 结果是描述性观察，不是任务计数、工作时长、已验证的代理错误或因果发现。
- 实时读取可能因更正和导入而变化；需要可复现性时应保留实际结果和请求。
- 不要索取凭据，也不要提出原始 SQL 访问。
- 工具是否存在由 describe_platform_tool 以确切名称判定；not_found 表示不可用，应如实说明而非猜测。
- 若连接列出 call_platform_tool 而非工作流中的具名工具，需先用 search_platform_tools 查找、describe_platform_tool 描述，再用 call_platform_tool 以相同参数运行。
- 若同时列出 execute，多步读取可在 execute 中通过 tools.search、tools.describe、tools.call 对 platform--<tool name> 路径运行；每次 execute 运行必须在确认点结束，任何写入前询问用户。
暂未提供
官方未提供关于收费、价格、平台兼容范围或具体安装命令的信息。