Агент читает публичный API Langfuse: трейсы и вложенные в них генерации, скоры, сессии, версии промптов и элементы датасетов проекта. На этом он строит разбор — сколько трейсов было за период и какая доля из них завершилась ошибкой, на каких шагах терялось время, как двигались скоры и какие диалоги просели по качеству сильнее остальных. Тот же разбор он присылает сводкой по расписанию.

Трейс здесь не плоская запись, а дерево наблюдений, поэтому «медленно» на уровне трейса ещё не значит медленную генерацию: время может уходить в соседний шаг, и агент называет конкретное звено. Скор тоже живёт отдельной сущностью, привязанной к трейсу, а сессия склеивает много трейсов в один диалог — просадку качества агент ищет по этой связке, а не по одной оценке в отрыве от разговора.

Наблюдаемость агент только читает: собственных трейсов он в ваш проект не отправляет и версии промптов не меняет без явного запроса — правка промпта остаётся вашим действием, агент лишь связывает её с изменением скоров. Вебхуков у Langfuse в этом подключении нет, поэтому о просадке он сообщает по вашему вопросу или по согласованному расписанию сводок, а не в момент, когда она случилась.

Ключи агент хранит зашифрованными и передаёт basic-авторизацией на каждый запрос; отзыв пары в списке ключей гасит подключение сразу, без ожидания истечения срока. Пара действует на один проект: соседние проекты той же организации агент не видит, под каждый нужна своя пара. Длинные периоды он забирает страницами и держит невысокую частоту запросов, чтобы один отчёт не съел лимит проекта. Когда данных за период нет, агент говорит об этом прямо, а не рисует пустой график.