# Langfuse

Langfuse LLM observability — трейсы, генерации, скоры, сессии, промпты, датасеты

## Сценарии

### Разбор трейсов за сутки
Агент разберёт трейсы за сутки и покажет, где генерации падали и на каких шагах терялось больше всего времени.

### Просадка качества ответов
Агент сопоставит скоры с сессиями и назовёт диалоги, в которых качество ответов просело сильнее всего.

### Сводка по наблюдаемости
Агент пришлёт сводку по расписанию: сколько трейсов, какая доля ошибок и как изменились скоры за выбранный период.

### Промпты и датасеты
Агент поднимет версии промптов и элементы датасетов проекта, чтобы связать правку промпта с изменением скоров.

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

### Войдите в Langfuse в своём регионе
EU — https://cloud.langfuse.com, US — https://us.cloud.langfuse.com, Япония — https://jp.cloud.langfuse.com. Ключи выдаются на один проект, поэтому откройте именно тот проект, данные которого нужны агенту.

### Откройте Settings → «API Keys» в проекте
В открытом проекте: Settings → «API Keys». Нужна роль Owner или Admin: Member и Viewer настройки проекта не конфигурируют, и раздел с ключами им не откроется.

### Создайте новую пару ключей и скопируйте обе
Пара состоит из публичного ключа с префиксом pk-lf- и секретного с префиксом sk-lf-. Скопируйте оба значения сразу после создания — секретный ключ понадобится целиком, укороченный показ в списке не годится.

### Запишите адрес своего хоста
Если проект не в EU-регионе, кроме ключей понадобится адрес хоста: https://us.cloud.langfuse.com, https://jp.cloud.langfuse.com, https://hipaa.cloud.langfuse.com или домен вашей self-hosted-установки.

## Частые вопросы

### Как подключить Langfuse?
Парой ключей проекта: откройте нужный проект → Settings → «API Keys» и создайте пару. Публичный ключ начинается с pk-lf-, секретный — с sk-lf-. Если проект не в EU-регионе, укажите host: например, https://us.cloud.langfuse.com или домен своей установки.

### Что агент видит в Langfuse?
Трейсы и генерации, скоры, сессии, версии промптов и датасеты одного проекта: ключи выдаются на проект, а не на всю организацию.

### Пишет ли агент в Langfuse?
По умолчанию агент читает наблюдаемость и отчитывается в чате: собственных трейсов он не отправляет и промпты не меняет без вашего запроса.

### Нужна ли отдельная роль?
Пару ключей создаёт только Owner или Admin проекта — Member и Viewer раздел настроек не откроют. Самому агенту достаточно уже созданной пары ключей.

[Открыть Langfuse](https://cloud.langfuse.com)