Recommended action: Unset OTEL_SDK_DISABLED (or set it to false) in processes that should send Langfuse traces; disable unwanted exporters individually instead. Option: Remove OTEL_SDK_DISABLED [evidence: official_recommended_action] Applies when: Processes that should trace to L
Recommended action: Emit text-start {id} -> text-delta {id, delta} -> text-end {id} (similarly for reasoning and tool-input); prefer result.toUIMessageStreamResponse() or writer.merge(result.toUIMessageStream()) over hand-built chunks. Evidence basis (self-declared by the contrib
Recommended action: Upgrade PEFT (>=0.12) or cast trainable params to float32 (peft.cast_mixed_precision_params), or use bf16. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Replace with system_database_url (and move app transactions to datasources if used). Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Set the "model" field to a name listed by GET /v1/models, add ?model= to GET endpoints like /props, and enable autoload (default) or load the model via the router API first. Evidence basis (self-declared by the contributing chat
Recommended action: Compare required vs available in the message and `ray status`; lower num_gpus/num_replicas, add GPU nodes, or check autoscaler/runtime_env progress. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: `unset AWS_ACCESS_KEY_ID AWS_SECRET_ACCESS_KEY AWS_SESSION_TOKEN AWS_SECURITY_TOKEN` before relying on a profile; verify with `aws sts get-caller-identity` and `aws configure list` (shows the source of each value); in code pass boto3.Session(profile_name=...).
Recommended action: Ensure LANGFUSE_PUBLIC_KEY / LANGFUSE_SECRET_KEY (and LANGFUSE_BASE_URL for non-default regions/self-hosted) are set before the first Langfuse()/get_client() call, or pass them explicitly; use langfuse.auth_check() once during setup to fail loudly. Option: Loa
Recommended action: Make LLM steps async def to use timeout_seconds; size the timeout for model latency and combine with retries. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Start with --media-path <dir> and send file://<relative path>, or send base64 data: URLs; for remote images ensure they are reachable and under 10 MB, or download client-side. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Upgrade transformers (>=5.13 avoids jmespath) and use a tool-capable chat template. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Send instructions='' or metadata={} to clear; include at least one field. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Use a supported scheme (check the list printed in the error) and inspect init container logs (kubectl logs <pod> -c storage-initializer). Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Disable the pager: export AWS_PAGER="" or pass --no-cli-pager, or set cli_pager= in ~/.aws/config. Option: Disable the pager [evidence: official_recommended_action] Applies when: See record scope. Steps: 1. export AWS_PAGER="" 2. or append --no-cli-pager Expec
Recommended action: Stage secrets (`fly secrets set --stage` or plain set on an undeployed app) and run `fly deploy`; the deploy picks up staged secrets. Option: Deploy first [evidence: official_recommended_action] Applies when: See record scope. Steps: 1. fly deploy Expected:
Recommended action: Run `fly logs` to see the boot failure, fix CMD/ENTRYPOINT; if the app is genuinely slow, increase --wait-timeout or try another region. Option: Inspect boot logs and fix the start command [evidence: official_recommended_action] Applies when: See record scope.
Recommended action: Normalize embeddings to unit length before indexing/querying when using dot_product (or use cosine), and filter out empty chunks instead of indexing zero vectors. Option: Normalize vectors or switch to cosine [evidence: documented_workaround] Applies when: dot
Recommended action: Find the crash cause (e.g. memory in a large step), fix it, then resume the workflow manually (DBOS.resume_workflow / CLI) or raise max_recovery_attempts. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Map the dataset to messages or prompt/completion (see TRL dataset formats) or pre-tokenize with input_ids. Evidence basis (self-declared by the contributing chat client): untested.