diff --git a/src/langsmith/langsmith-cli.mdx b/src/langsmith/langsmith-cli.mdx index d7adb6c194..f1e268c40c 100644 --- a/src/langsmith/langsmith-cli.mdx +++ b/src/langsmith/langsmith-cli.mdx @@ -2,7 +2,7 @@ title: LangSmith CLI sidebarTitle: CLI icon: terminal-2 -description: Query and manage LangSmith projects, traces, runs, datasets, evaluators, experiments, and threads from the terminal +description: Query and manage LangSmith projects, traces, runs, datasets, evaluators, experiments, insights, and threads from the terminal --- The LangSmith CLI is a fast, agent-friendly command-line tool for working with your LangSmith data and workflows directly from the terminal. It’s designed for both humans and AI coding agents to list, filter, retrieve, and export data—with predictable JSON output by default and a pretty table mode for humans. @@ -153,3 +153,14 @@ langsmith evaluator delete accuracy --yes langsmith experiment list --dataset my-eval-set langsmith experiment get my-experiment-2024-01-15 ``` + +### insights—view trace analysis reports + +The [Insights Agent](/langsmith/insights) automatically clusters and analyzes your traces to surface usage patterns, failure modes, and key findings. Use these commands to list and retrieve completed reports. + +```bash +langsmith insights list --project my-app +langsmith insights list --project my-app --limit 5 --format pretty +langsmith insights get --project my-app +langsmith insights get --project my-app --format pretty +```