langfuse

# Langfuse ## 1. Langfuse API via CLI Use `langfuse-cli` to interact with the full Langfuse REST API. Run via bunx (auto-loads `.env`): ```bash bunx langfuse-cli api --help # 列出所有 resources bunx langfuse-cli api <resource> --help # List actions for a resource bunx langfuse-cli api <resource> <action> --help # Show args for an action bunx langfuse-cli api <resource> <action> [options] # Execute ``` ### Credentials bunx automatically loads `.env`. Ensure it contains: ```bash LANGFUSE_PUBLIC_KEY=pk-lf-... LANGFUSE_SECRET_KEY=sk-lf-... LANGFUSE_HOST=https://cloud.langfuse.com # Required ``` If credentials are missing, ask the user to add them to `.env`. Do not ask to paste keys in chat. ### CLI Tips - Use `--json` for machine-readable output - Use `--curl` to preview HTTP request without executing - Prefer `observations-v2s` over `observations`, `score-v2s` over `scores` ## 2. Data Retrieval Tools (脚本工具集) All scripts accept common filtering options for time range and metadata: | Option | Description | Example | |--------|-------------|---------| | `--from <ISO>` | Start timestamp | `--from 2026-07-01T00:00:00Z` | | `--to <ISO>` | End timestamp | `--to 2026-07-31T23:59:59Z` | | `--days <N>` | Last N days (from now) | `--days 7` | | `--tag <tag>` | Filter by tag | `--tag production` | | `--user <id>` | Filter by user ID | `--user user_123` | | `--session <id>` | Filter by session ID | `--session sess_a...