Рекомендуемый блог

Как использовать LangSmith в 2026 году: полное руководство от начинающего до продвинутого пользователя.

2026-05-14
ФАЙЛ · langsmith_guide.py ЗАПУСК · 14.05.2026
СЕАНС ​​· АКТИВНЫЙ
ДОК / 015 Руководство для разработчиков
— LangSmith 2026 · Начинающий → Продвинутый —
СБОРКА 26.05.14 ai.cc dev desk
Учебное пособие · 5 блоков · 18 мин чтения

Остановить отладочные агенты
с print().
Использовать ЛангСмит.

ЛангСмит LangGraph — это ведущая платформа для мониторинга, оценки и развертывания приложений LLM и Agentic AI, разработанная командой LangChain. Она отслеживает каждый вызов модели, использование инструмента и решение, принимаемое вашими агентами, а затем предоставляет вам панели мониторинга, инструменты оценки и подсказки для отладки, как у профессионального программного обеспечения. Это руководство для практикующих специалистов: учет, трассировка, отладка LangGraph, оценка и рабочий процесс производственного уровня.

Время чтения
18м
+ практическая настройка
Пролеты
5/5
Настройка → Производство
Куча
Пи·JS
+ LangGraph
Бесплатный уровень
0 долларов/для
Карта не требуется
§ Почему именно сейчас?

Почему компания LangSmith важна в 2026 году.

По мере того, как агентный ИИ становится все более распространенным, становится проще print() Отладка больше не работает. Современный запуск агента представляет собой дерево вложенных вызовов LLM, запусков инструментов, повторных попыток и условных переходов — и отладка этого с помощью отладчика невозможна. logger.infoLangSmith предоставляет пять возможностей, которые в совокупности образуют реальный рабочий процесс:

Ф / 01
Сквозная трассировка
Зафиксированы все звонки, использование инструментов и принятые решения в рамках программы LLM.
Ф / 02
Визуальная отладка
Многоагентные рабочие процессы в виде проверяемых деревьев.
Ф / 03
Автоматизированные оценки
Регрессионный анализ с использованием наборов данных и оценок экспертов из числа студентов магистратуры права.
Ф / 04
Оперативное управление
Версионирование, A/B-тестирование, анализ работы команды.
Ф / 05
Мониторинг производства
Стоимость, задержка, частота ошибок в масштабе.
Панель мониторинга трассировки LangSmith, отображающая трассировку выполнения агента с вызовами LLM и использованием инструментов.
Обзор трассировки Панель трассировки LangSmith — каждый вложенный сегмент, каждый вызов инструмента, каждая стоимость токена на одной временной шкале.
▾ ROOT · run_id: 5a3f...c91d 5 пролетов · общая длина ~45 м
SPAN · 01 НАСТРАИВАТЬ
т = 00:00 ~5 мин

Создайте свою учетную запись LangSmith & API-ключ.

Бесплатного уровня для разработчиков достаточно для начала работы — кредитная карта не требуется. Сервисные ключи предназначены для продакшена, персональные токены доступа — для разработки. Не смешивайте их.

  1. Перейти к smith.langchain.com и зарегистрироваться. План для разработчиков бесплатный. — Карта не требуется.
  2. Войдите через Google, GitHub или электронную почту — на ваш выбор.
  3. Перейти к Настройки → Ключи API.
  4. Создать Персональный токен доступа для разработчиков или Сервисный ключ для развертывания в производственной среде.
  5. Скопируйте ключ — вы увидите его только один раз. Сохраните его в менеджере секретов, а не в Git.
Берегись Ключи доступа имеют область действия на уровне организации. Если ключ выходит из строя, немедленно замените его на той же странице настроек — старый ключ перестает работать, новый становится активным, и при своевременном повторном развертывании не будет простоя.
SPAN · 02 УСТАНОВИТЬ
т = 00:05 ~3 мин

Установить Лонгсмит и настройте свою среду.

Установка с помощью pip, три переменные окружения. Четвертая, необязательная, предназначена для указания места жительства в ЕС или для маршрутизации пользовательских конечных точек.

Терминал Баш
1
пип установить langsmith

Установка переменных среды — добавить в .env или экспортировать напрямую:

.env Баш
1
2
3
4
экспорт LANGSMITH_TRACING=истинный  экспорт LANGSMITH_API_KEY=lsv2_xxxxxxxxxxxx  # Необязательно: для ЕС или пользовательских регионов  # export LANGSMITH_ENDPOINT=https://eu.api.smith.langchain.com
SPAN · 03 БЫСТРЫЙ СТАРТ
т = 00:08 ~10 мин

Включите трассировку в своем коде.

Он @traceable Декоратор оборачивает любую функцию и передает ее входные и выходные данные, задержку и вызовы инструментов в LangSmith. Вот и весь быстрый старт.

my_agent.py Python
1
2
3
4
5
6
7
8
9
10
11
от langchain_openai импорт ChatOpenAI  от Лонгсмит импорт отслеживаемый @traceable  деф мой_агент(запрос: стр): llm = ChatOpenAI(модель="gpt-4o") возвращаться llm.invoke(query) # Или включить глобально  импорт os os.environ["LANGSMITH_TRACING"] = "истинный"

Запустите свой код. Трассировка автоматически отобразится на панели мониторинга LangSmith — обычно в течение нескольких секунд.

Создание ключа API LangSmith в настройках.
Создание ключа API Настройки → Ключи API — выберите правильный тип ключа (PAT для разработки, Service Key для продакшена).
Код Python в паре с соответствующим представлением трассировки LangSmith.
Код → Трассировка Слева: ваша декорированная функция. Справа: трассировка, автоматически захватываемая LangSmith.
SPAN · 04 ЛАНГГРАФ
т = 00:18 ~15 мин

Отладка сложных агентов с помощью LangGraph.

Компания LangSmith наиболее эффективна в сочетании с LangGraph — рабочие процессы с сохранением состояния, многоузловые, многоагентные. Дерево трассировки становится самим выполнением графа.

  • Визуализируйте выполнение графа целиком. — каждый узел, каждое ребро, каждый переход состояния.
  • Отслеживайте изменения состояния на каждом узле. Больше не надо print(state) в двенадцати местах.
  • Воспроизведение трассировки с использованием различных моделей или запросов. — проверить гипотезу, не перезапуская производство.
  • Используйте LangSmith Studio для визуальной пошаговой отладки агента.
Визуализация многоагентного рабочего процесса LangGraph в LangSmith Studio.
Студия · Просмотр LangGraph Многоагентный рабочий процесс в виде визуального графа — отладка пошагово с помощью перетаскивания, проверка состояния на каждом узле.
SPAN · 05 ОЦЕНКИ
т = 00:33 ~12 мин

Оценка результатов выполнения и эксперименты.

Оценки — это то, что отличает демоверсию от готового продукта. Без них любая корректировка подсказок — это гадание на кофейной гуще. LangSmith закладывает этот рабочий процесс в:

  • Создание наборов данных количество тестовых случаев — начните с 10 примеров, постепенно увеличивая их число до сотен.
  • Определите оценщиков — Магистр права в качестве судьи, собственный код или обратная связь от человека.
  • Проведите эксперименты и сравните версии. бок о бок, с флагами регрессии.
  • Отслеживайте регрессию по мере итераций. Новая подсказка сломала пример №7? Вы увидите это до того, как она будет выпущена.
Производственный шлюз Это протокол, который отличает любительский проект от агентного ИИ промышленного уровня. Рассматривайте набор данных как набор тестов — сначала небольшой, а затем увеличивающийся каждый раз, когда возникает реальная ошибка.
§ Продвинутый уровень · 2026

Советы для опытных пользователей для развертывания в производственной среде.

  • Используйте движок LangSmith. (новинка 2026 года) — слой искусственного интеллекта, который анализирует трассировки и предлагает решения для сбоев или дорогостоящих запусков.
  • Интеграция с LangGraph для постоянной памяти и контрольных точек с участием человека — двух наиболее важных факторов, выходящих за рамки стадии прототипа.
  • Отслеживайте затраты, задержку и частоту ошибок. В рабочем режиме. Установите пороговые значения. Получайте оповещения раньше, чем клиенты.
  • Настройте оповещения об аномалиях. Трехкратный скачок количества токенов на звонок — это сигнал, а не совпадение.
Панель мониторинга производства LangSmith с показателями затрат и производительности.
Мониторинг производства Стоимость, задержка, частота ошибок, p95 — необходимые вам панели мониторинга перед запуском в эксплуатацию.
§ Ценообразование

Обзор цен • Уровни 2026 года.

План · Цены · Мощность ОБНОВЛЕНО 05.05.2026
Разработчик
Для индивидуальных разработчиков и создания прототипов. Ограниченный объем трассировки. Кредитная карта не требуется.
БЕСПЛАТНО
Плюс
Для небольших команд, занимающихся отправкой агентов в производство. Оплата за рабочее место плюс использование. Полные пробные версии + Studio.
39 долларов за место в месяц
Предприятие
Для крупных организаций. Доступны варианты с самостоятельным размещением и гибридным развертыванием. Индивидуальные соглашения об уровне обслуживания (SLA) и проверка безопасности.
Обычай
§ Варианты использования

Какие команды на самом деле существуют? для чего его использовать.

Дело / 01 · Отладка Чтобы понять, почему ваш агент испытывает галлюцинации, зацикливается или останавливается посреди выполнения задачи, нужно изучить фактическое дерево трассировки, а не гадать.
Корпус / 02 · Модель A/B Сравнение Claude и GPT-4o на идентичных входных данных — один и тот же набор данных, одни и те же оценщики, прямые результаты.
Дело / 03 · Соответствие требованиям Журналы аудита для регулируемых отраслей — каждый запрос, результат и решение фиксируются неизменяемо.
Дело / 04 · Подсказки для команды Совместная разработка и внедрение — версионирование, комментарии, проверка и развертывание в рамках всей команды.

Контрольный список действий — выполнить сегодня.

  1. Создайте учетную запись LangSmith и сгенерируйте ключ API.
  2. Включите трассировку в текущем проекте — один декоратор, две переменные окружения.
  3. Запустите один поток обработки данных от одного агента и проанализируйте полученное дерево трассировки.
  4. Создайте небольшой (5–10 примеров) набор данных для оценки.
  5. Откройте LangSmith Studio и визуально пройдитесь по своему агенту.

Компания LangSmith стала стандартный факт Для серьезной разработки агентного ИИ в 2026 году. Начните с бесплатного уровня сегодня и повышайте уровень по мере усложнения ваших агентов. Что вы создаете с помощью LangSmith? Поделитесь своим примером использования в комментариях — с удовольствием дам конкретные советы. Последнее обновление 14 мая 2026 г.Всегда проверяйте официальную информацию. Документация LangSmith для получения доступа к новейшим функциям.

// КОНЕЦ ТРАССИРОВКИ · run_id: 5a3f...c91d ai.cc · field_guide · DOC·015 · 2026.05.14

Более 300 моделей ИИ для
OpenClaw и агенты искусственного интеллекта

Сэкономьте 20% на расходах