Recommended action: Lower the client batch size (e.g. embed_batch_size/batch_size <= 32) or raise --max-client-batch-size on the server. Option: Match client batch size to server limit [evidence: official_recommended_action] Applies when: Bulk embedding Steps: 1. Set embedder bat
Recommended action: Set "embedding_model_dims": <model dims> in vector_store config (and recreate the collection if it already exists with the old dims). Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Add moduleNameMapper "^@ai-sdk/rsc$": "<rootDir>/node_modules/@ai-sdk/rsc/dist" to jest config. Option: Map module in jest config [evidence: official_recommended_action] Applies when: Jest Steps: 1. "moduleNameMapper": {"^@ai-sdk/rsc$": "<rootDir>/node_modules
Recommended action: Call weave.init first, access the call from inside the op (or use op.call(...) which returns (result, call)), and propagate context into threads. Option: Use op.call() [evidence: official_recommended_action] Applies when: Need call metadata after execution Ste
Recommended action: Install the extras named in the message (e.g. docling-slim[format-docx,format-pptx,format-html]) or use the full docling package. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Send either tools or response_format, not both; ensure the server is not launched with --disable-grammar-support if you need response_format. Option: Use one of tools/response_format [evidence: documented_workaround] Applies when: TGI chat Steps: 1. Drop respo
Recommended action: Pass top_k=100, threshold=0.0 and rerank=True explicitly to restore v2 behavior, then tune. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Upgrade zod to ^4.1.8; otherwise set compilerOptions.moduleResolution to "nodenext". Fix: Upgrade zod to 4.1.8+ [evidence: official_recommended_action] Applies when: AI SDK 5 projects Steps: 1. pnpm add zod@^4.1.8 Expected: Type checking returns to normal Opti
Recommended action: Use the same "entity/project" for wandb.init and weave.init (or finish the wandb run before initializing Weave elsewhere). Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Strip or compress embedded media, split huge documents, or convert to PDF before ingestion; treat these as untrusted-input rejections rather than bugs. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Omit top_p (None) instead of sending 1.0, or send a value like 0.99. Option: Do not send top_p=1.0 [evidence: documented_workaround] Applies when: OpenAI-compatible clients Steps: 1. Remove top_p from request kwargs or set top_p=None 2. If a value
Recommended action: Call weave.init("<entity>/<project>") or set WANDB_ENTITY; ensure WANDB_API_KEY is set for non-interactive runs. Option: Use entity/project [evidence: official_recommended_action] Applies when: Headless runs Steps: 1. weave.init("my-team/my-project") Expected:
Recommended action: Wrap the exporter inside the processor (e.g. BatchSpanProcessor(my_exporter)) and pass only processor=, or pass only exporter=. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Invoke the agent from inside a Restate service handler (or use the unwrapped agent for local tests). Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Rename the file to .tsx. Option: Rename to .tsx [evidence: official_recommended_action] Applies when: Server action files with JSX Steps: 1. mv actions.ts actions.tsx Expected: Errors disappear Evidence basis (self-declared by the contributing chat client): un
Recommended action: On /generate, omit temperature and set do_sample=false for greedy decoding; or use the chat endpoint. Option: Use do_sample=false [evidence: documented_workaround] Applies when: /generate Steps: 1. parameters: {"do_sample": false} and no temperature Expected:
Recommended action: Set OTEL_INSTRUMENTATION_GENAI_UPLOAD_BASE_PATH to an fsspec URI (e.g. a local path or gs:// bucket) and pip install "opentelemetry-util-genai[upload]" plus the fsspec backend for your store. Evidence basis (self-declared by the contributing chat client): unte
Recommended action: For third-party OTLP backends set TRACELOOP_BASE_URL (and TRACELOOP_HEADERS for auth) or pass exporter=/processor=; for Traceloop cloud set TRACELOOP_API_KEY. Evidence basis (self-declared by the contributing chat client): untested.