Для получения чистого Markdown любой страницы добавьте .md к URL‑адресу страницы.
Для полного индекса документации см. https://api.vega.chat/docs/llms.txt.
Для полного содержания документации см. https://api.vega.chat/docs/llms-full.txt.
Для интеграции AI‑клиентов (Claude Code, Cursor и др.) подключитесь к серверу MCP по адресу https://api.vega.chat/docs/_mcp/server.

Langfuse

MD версия

Langfuse — это открытая платформа для инженерии LLM, предназначенная для трассировки, оценки и отладки приложений LLM.

Шаг 1: Создать API‑ключ Langfuse

В Langfuse перейдите в Settings > API Keys вашего проекта и создайте новую пару ключей. Скопируйте как Secret Key, так и Public Key.

Langfuse API Keys

Шаг 2: Включить Broadcast в VEGA

Перейдите в Settings > Observability и переключите Enable Broadcast.

Enable Broadcast

Шаг 3: Настроить Langfuse

Нажмите значок редактирования рядом с Langfuse и введите:

Secret Key: ваш Secret Key Langfuse
Public Key: ваш Public Key Langfuse
Base URL (необязательно): по умолчанию https://us.cloud.langfuse.com. Измените для других регионов или самохостинговых экземпляров

Langfuse Configuration

Шаг 4: Протестировать и сохранить

Нажмите Test Connection, чтобы проверить настройку. Конфигурация сохраняется только при успешном тесте.

Langfuse Configured

Шаг 5: Отправить тестовый трасс

Сделайте API‑запрос через VEGA и просмотрите трассировку в Langfuse.

Langfuse Trace

Пользовательские метаданные

Langfuse поддерживает богатые иерархии трассировок и метаданные. Используйте поле trace, чтобы настроить отображение ваших трасс в Langfuse.

Поддерживаемые ключи метаданных

Ключ	Отображение в Langfuse	Описание
`trace_id`	Trace ID	Группировать несколько запросов в одну трассировку
`trace_name`	Trace Name	Пользовательское имя, отображаемое в списке трассировок Langfuse
`span_name`	Span Name	Имя промежуточных спанов в иерархии
`generation_name`	Generation Name	Имя наблюдения генерации LLM
`parent_span_id`	Parent Observation ID	Ссылка на существующий спан в иерархии трассировки
`environment`	Environment	Заполняет первоклассное поле `Environment`, используемое фильтром проекта Langfuse (например, `production`, `staging`). Передаётся как атрибут ресурса и как атрибут наблюдения.
`release`	Release	Версия/релиз приложения, связанный с трассировкой. Передаётся как атрибут ресурса и как атрибут наблюдения.

Пример

json

{
  "model": "openai/gpt-4o",
  "messages": [{ "role": "user", "content": "Summarize this document..." }],
  "user": "user_12345",
  "session_id": "session_abc",
  "trace": {
    "trace_id": "workflow_12345",
    "trace_name": "Document Processing Pipeline",
    "span_name": "Summarization Step",
    "generation_name": "Generate Summary",
    "environment": "production",
    "release": "2.1.0",
    "pipeline_version": "2.1.0"
  }
}

Это создаёт иерархическую структуру трассировки в Langfuse:

Document Processing Pipeline (trace)
└── Summarization Step (span)
    └── Generate Summary (generation)

Дополнительный контекст

Поле user сопоставляется с User ID в Langfuse для аналитики на уровне пользователей.
Поле session_id сопоставляется с Session ID в Langfuse для группировки разговоров.
Любые дополнительные ключи в trace передаются как метаданные трассировки и могут использоваться для фильтрации и анализа в Langfuse.

Режим конфиденциальности

Когда Privacy Mode включён для этого назначения, содержимое запросов и ответов исключается из трассировок. Все остальные данные трассировки — использование токенов, затраты, время выполнения, информация о модели и пользовательские метаданные — продолжают отправляться как обычно. См. Privacy Mode для подробностей.