langfuse-laravel-ai
Installation
SKILL.md
Langfuse × laravel/ai
laravel/ai SDK(Laravel\Ai\)를 쓰는 Laravel 앱의 LLM/에이전트 호출을 Langfuse로 트레이싱한다.
핵심 전제 (먼저 알아야 할 것)
- laravel/ai는 OpenTelemetry를 지원하지 않고, 공식 PHP Langfuse SDK도 없다. 직접 OTLP/인제스션 클라이언트를 짜기 전에
axyr/laravel-langfuse를 먼저 채택한다 — laravel/ai를 zero-code 자동계측하고 Langfuse 인제스션 API로 큐 배칭 전송한다. - 패키지 비교(채택 전 근거):
| 패키지 | laravel/ai 자동계측 | 전송 | 주의 |
|---|---|---|---|
axyr/laravel-langfuse ✅ |
O | Langfuse 네이티브 인제스션 | require가 illuminate만 → laravel/ai 버전 비강제(충돌 없음) |
tracefast/laravel-ai-observability |
O | OTLP 경유 | laravel/ai ^0.7을 강제 → 낮은 버전과 충돌 위험 |
dropsolid/ · dij-digital/ · janzaba/ |
X (수동 trace API만) | Langfuse | 결국 이벤트 후킹은 직접 해야 함 |