langsmith-cli
CLI для агентов: проекты, трейсы, прогоны, датасеты, оценщики и эксперименты LangSmith одной командой из Claude Code или Cursor.
- 81 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- CLI читает трейсы и данные рабочего пространства, а в них бывают пользовательские запросы и персональные данные.
- Ключ дает доступ ко всем ресурсам выбранного рабочего пространства.
Установка
- Работает в
Ручная установка
curl -fsSL https://cli.langsmith.com/install.sh | shmacOS и Linux. Для Windows `irm https://cli.langsmith.com/install.ps1 | iex`. Прочитайте скрипт до запуска.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- CLI читает трейсы и данные рабочего пространства, а в них бывают пользовательские запросы и персональные данные.
- Ключ дает доступ ко всем ресурсам выбранного рабочего пространства.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
langsmith-cli, официальный инструмент LangChain, дает кодинг-агентам быстрый скриптуемый доступ к ресурсам LangSmith. Команды `langsmith projects list`, `traces list`, `traces get <id> --full`, `runs list --run-type llm --include-metadata`, `datasets list` и `experiments list --dataset <имя>` показывают проекты, трейсы, вызовы моделей с числом токенов, наборы данных и эксперименты. Авторизация идет через переменную `LANGSMITH_API_KEY` либо профили: `langsmith auth login` по OAuth, `langsmith profiles create` с ключом из переменной окружения, команды или связки ключей ОС. Профили лежат в `~/.langsmith/config.json`, который пишется с правами только для владельца. Для самостоятельного размещения задается `LANGSMITH_ENDPOINT`.
Для кого. Разработчикам агентов на LangChain и LangGraph, которые разбирают трейсы и эксперименты LangSmith вместе с кодинг-агентом.
Подходит, если
- Продакшен-агент ответил странно, и Claude Code должен найти трейс и показать вызовы модели с токенами.
- Нужно выгрузить датасет для оценки и список экспериментов по нему.
- Скрипт в CI опрашивает проект LangSmith и разбирает вывод.
- Ключ API надо хранить в связке ключей, а не в файле конфигурации.
Не подходит, если
- Вы не используете LangSmith.
- Нужен интерфейс с графиками: инструмент консольный.
- Ключ API нельзя давать агенту.
Пример запроса к агенту
Покажи последние пять трейсов проекта my-app и вызовы моделей с числом токенов, затем найди самый дорогой.Ограничения
Для работы нужен аккаунт LangSmith и ключ API вида `lsv2_pt_...`. Ключ в профиле по умолчанию хранится в файле `~/.langsmith/config.json`, а при отсутствии связки ключей CLI выводит предупреждение. Вход `auth login` пока не работает с профилями в связке ключей. Go SDK читает такие профили, а Python, JavaScript и Java SDK нет. Агенту, который запускает CLI, доступны все ресурсы выбранного рабочего пространства, поэтому ограничьте ключ нужным рабочим пространством.
Как отключить. Удалите бинарный файл `langsmith`, каталог `~/.langsmith/` с профилями и переменные `LANGSMITH_*` из окружения. Ключ API отзовите в LangSmith.
Частые вопросы
Как установить langsmith-cli?
macOS и Linux: `curl -fsSL https://cli.langsmith.com/install.sh | sh`. Windows: `irm https://cli.langsmith.com/install.ps1 | iex`. Обновление командой `langsmith self-update`, готовые бинарные файлы лежат в релизах GitHub.
Как хранить ключ без файла?
Создайте профиль с `--api-key-env` или `--api-key-cmd`, либо с `--keychain`. Переменная `LANGSMITH_SECRET_STORE=keychain` включает связку ключей для всех профилей.
Как работать с самостоятельно размещенным LangSmith?
Задайте `LANGSMITH_ENDPOINT` адресом вашего сервера. Рабочее пространство и проект по умолчанию задают `LANGSMITH_WORKSPACE_ID` и `LANGSMITH_PROJECT`.
Где посмотреть, откуда ключ?
Команда `langsmith auth info` показывает источник ключа активного профиля.
Чем это отличается от скиллов LangSmith?
CLI дает команды доступа к данным, а скиллы LangChain учат агента запрашивать трейсы и строить датасеты. Их ставят вместе.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыСкиллы LangSmith
LangSmith Skills
Официальные скиллы LangChain для LangSmith: запрос и выгрузка трейсов, датасеты для оценки и собственные эвалюаторы прямо из агента
Девять скиллов по LangChain, LangGraph, LangSmith и Deep Agents: структура проекта, паттерны агентов, тесты, трассы и выкладка.
Официальные скиллы LangChain: выбор между LangChain, LangGraph и Deep Agents, квикстарты, RAG, память, согласование с человеком и разработка оценок
Официальные скиллы Langfuse: Claude Code и Cursor настраивают трассировку LLM, ведут промпты и датасеты и переносят проекты с LangSmith
Скилл с руководством по LangGraph 1.0: ReAct-агенты, StateGraph, middleware, память, MCP и RAG, чтобы Claude Code писал код на LangChain без устаревших API
Терминальный агент на TypeScript: потоковый REPL, свои и совместимые с OpenAI модели, планирование и откат правок.
Коротко о README
CLI на Go для работы агентов с LangSmith: список и просмотр проектов, трейсов, прогонов, датасетов и экспериментов, профили и OAuth.