工具名称

描述

示例 Prompt

msprof_analyze_advisor

调用 msprof-analyze advisor 提供全方位性能建议（计算/调度瓶颈）。

"分析 /path/to/data 目录下的性能数据，找出主要瓶颈。"

工具名称

描述

示例 Prompt

analyze_overlap

分析计算、通信与调度的重叠情况，判断负载特征（计算/通信密集型）。

"分析 /path/to/trace_view.json 的计算和通信重叠情况。"

find_slices

搜索 Trace 中的特定 Slice（算子/函数），支持模糊匹配和时间范围过滤。

"在 /path/to/trace_view.json 中查找所有 'MatMul' 算子。"

get_flow_data

根据时间范围获取 Flow 关联的 CPU/NPU 算子明细，支持按 cpu_op 或 npu_op 入口查询；结果过大时可通过 result_output_path 导出 CSV。

"获取 /path/to/trace_view.json 中 1000000000 到 2000000000 时间范围内的 NPU 算子关联 Flow 数据，并导出到 /tmp/flow_data.csv。"

execute_sql_query

执行自定义 SQL 查询，支持 Slice/Thread/Process 等表的深度分析。

"对 /path/to/trace_view.json 执行 SQL 查询，统计耗时超过 1ms 的 Slice 数量。"

工具名称

描述

示例 Prompt

analyze_kernel_details

分析 kernel_details.csv，提供耗时分布、Top N 算子、设备分布等。

"分析 /path/to/kernel_details.csv，列出耗时最长的 10 个算子。"

get_operator_details

查询特定算子（按名称或类型）的详细执行信息。

"从 /path/to/kernel_details.csv 中获取 'FlashAttention' 算子的详细信息。"

analyze_op_statistic

分析 op_statistic.csv，提供调用次数、总耗时及 Core 类型分布。

"统计 /path/to/op_statistic.csv 中的算子调用次数和总耗时。"

get_op_type_details

查询特定类型算子或 Core 类型算子的详细统计数据。

"查看 /path/to/op_statistic.csv 中所有 'AI_CORE' 类型的算子统计。"

search_csv_by_field

通用 CSV 字段搜索工具，支持按列值过滤。

"在 /path/to/file.csv 的 'Name' 列中搜索包含 'Conv' 的行。"

工具名称

描述

示例 Prompt

analyze_communication

分析 communication_matrix.json，识别 P2P/集合通信瓶颈及慢链路。

"分析 /path/to/communication_matrix.json，找出带宽利用率低的链路。"

analyze_communication_trace

分析 communication.json，提供通信操作的时间分解（Transit, Wait）和带宽详情。

"分析 /path/to/communication.json，查看通信操作的等待时间分布。"

工具名称

描述

示例 Prompt

get_profiler_config

获取 profiler_info.json 中的配置信息（版本、软硬件环境）。

"读取 /path/to/profiler_info.json，查看 Profiler 配置版本。"

工具名称

描述

示例 Prompt

execute_sql

执行只读 SQL 并返回结果，当结果行数/返回字符数超阈值时会返回失败并提示收敛查询。

"对 /path/to/ascend_pytorch_profiler.db 执行 SQL：SELECT name, SUM(total_time) AS total FROM COMPUTE_TASK_INFO GROUP BY name LIMIT 20。"

execute_sql_to_csv

执行只读 SQL 并将全量结果保存为 CSV，只返回导出状态、路径和行数，不返回查询结果内容。

"将 /path/to/ascend_pytorch_profiler.db 中 SELECT * FROM TASK WHERE taskType='AI_CORE' 的结果导出到 /tmp/op_statistic_ai_core.csv。"