AIKraft/AI/Войти
AIKraft/Skills/наблюдаемость

наблюдаемость

Adds tracing, telemetry, and observability to an assistant-ui backend. Use when wiring an AI SDK route handler (streamText/generateText, toUIMessageStream, createUIMessageStreamResponse) to a tracing backend: Langfuse via OpenTelemetry (LangfuseSpanProcessor and NodeSDK in instrumentation.ts, experimental_telemetry isEnabled, propagateAttributes with traceName/userId/sessionId, langfuseSpanProcess

assistant-ui official Дизайн

Что делает навык

Наблюдение за бэкендом и фронтендом assistant-ui: интеграция Langfuse, LangSmith или Helicone для трассировки вызовов моделей и рендеринг собранных данных в интерфейсе через @assistant-ui/react-o11y. Решает задачу обеспечения прозрачности работы AI-приложений на уровне бэкенд-вызовов и визуализации на клиенте.

Когда применять

  • Настройка трассировки вызовов AI SDK (streamText/generateText) через OpenTelemetry для Langfuse.
  • Визуализация временной шкалы и атрибутов спанов в интерфейсе с помощью SpanResource и TraceWaterfall.
  • Интеграция LangSmith с использованием wrapAISDK и метаданных.
  • Настройка прокси Helicone для маршрутов AI SDK и OpenAI SDK.
  • Серверное сбрасывание (flushing) данных в условиях serverless-окружения.

Как работает

  1. Выбрать один провайдер бэкенда (Langfuse, LangSmith или Helicone) в зависимости от нужной модели данных.
  2. Настроить бэкенд-инструментацию: для Langfuse — OpenTelemetry (LangfuseSpanProcessor, NodeSDK), для LangSmith — wrapAISDK, для Helicone — прокси.
  3. Настроить передачу атрибутов трассировки (traceName, userId, sessionId) через propagateAttributes или метаданные.
  4. Обеспечить корректное сбрасывание данных (flushing) для serverless-окружения.
  5. Подключить @assistant-ui/react-o11y для рендеринга собранных спанов в интерфейсе (SpanResource, TraceWaterfall).
  6. Проверить актуальность API в assistant-ui.com/llms.txt.

Примеры запросов агенту

Настрой трассировку бэкенда assistant-ui через Langfuse с использованием OpenTelemetry и серверным сбросом.
Добавь визуализацию спанов в интерфейс assistant-ui с помощью @assistant-ui/react-o11y и TraceWaterfall.
Интегрируй LangSmith в бэкенд assistant-ui, обернув AI SDK и передав метаданные.

Что понадобится

  • Доступ к документации assistant-ui.com/llms.txt для актуальных API.
  • Установленные пакеты @assistant-ui/react-o11y и соответствующий бэкенд-инструментарий (Langfuse/LangSmith/Helicone).
  • Конфигурация instrumentation.ts или аналогичных файлов для настройки OpenTelemetry/прокси.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «observability» из репозитория: # https://github.com/assistant-ui/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r observability/ ~/.claude/skills/observability/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.