Recommended action: open(path, 'rb') for tomllib.load, or tomllib.loads(path.read_text(encoding='utf-8')). Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Run ollama pull <model> on the server that base_url points to, or use an exact name from the "Available local models" list (including tag). Option: Pull the model on the target server or use the exact tagged name
Recommended action: Keep system messages contiguous at the start (merge memory/context into the first system message or send as user messages), or set model_info multiple_system_messages=True if the model actually supports it. Option: Consolidate system messages [evidence: docume
Recommended action: Upgrade the Weaviate server image to >=1.27 (preferably current), or pin an older weaviate-client compatible with your server. Option: Upgrade server or pin client [evidence: official_recommended_action] Applies when: Self-hosted Weaviate Steps: 1. docker pull
Recommended action: Use pwsh (7+) where -Encoding utf8 is BOM-less, or in 5.1 write via [System.IO.File]::WriteAllText(path, text, (New-Object System.Text.UTF8Encoding $false)); make consumers BOM-tolerant (utf-8-sig). Evidence basis (self-declared by the contributing chat client
Recommended action: Inspect the listed response keys / server logs for the real error; confirm the base_url points at the /v1 Chat Completions surface and that the server model name and parameters are supported; use use_responses_api only if the server
Recommended action: Use Messages.NewStreaming (and accumulate) for large outputs, or pass option.WithRequestTimeout(...) explicitly if you accept the risk of long non-streaming calls behind proxies. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Use a tool-capable model and set model_info={"function_calling": True, ...} accurately for custom/OpenAI-compatible endpoints; otherwise use a team type without handoffs (e.g. SelectorGroupChat). Option: Declare accurate model_info or use a tool-capable model
Recommended action: Use ASCII-safe ids (hash or slugify source names, store the original name in metadata); cast integer ids to str. Option: Hash or slugify ids and keep originals in metadata [evidence: documented_workaround] Applies when: ids from file names/titles Steps:
Recommended action: Trim the BOM before decoding: bytes.TrimPrefix(b, []byte("\xef\xbb\xbf")); fix the producer to write UTF-8 without BOM. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Always pass a context with deadline or option.WithRequestTimeout; use bytes.Reader/strings.Reader (http.NewRequest sets GetBody) for bodies you want retried; handle 429 with your own scheduler when Retry-After is long. Evidence basis (self-declared by the cont
Recommended action: Flatten nested metadata (json.dumps or split keys), convert number lists to strings, and be aware null-valued keys are dropped. Option: Flatten/serialize metadata before upsert [evidence: documented_workaround] Applies when: Framework-generated metadata Steps:
Recommended action: Invoke with the full ToolCall: tool.invoke({'args': {...}, 'name': tool.name, 'type': 'tool_call', 'tool_call_id': '<id>'}); in tests fabricate an id. Option: Invoke with a ToolCall envelope [evidence: official_recommended_action] Applies when: Direct tool inv
Recommended action: Represent such values as strings in JSON; if genuinely needed, raise the limit explicitly and only for trusted input. Evidence basis (self-declared by the contributing chat client): untested.
Recommended action: Make the guardrail feedback actionable and the task expected_output explicit; raise guardrail_max_retries if needed (max_retries is deprecated). Option: Improve guardrail feedback or raise retries [evidence: official_recommended_action] Applies when: Tasks wit
Recommended action: Follow the v10 migration guide: import ServerlessSpec/Index/PineconeConfig from top-level pinecone; use pc.indexes.create(schema=..., deployment=...) or the 9.x shim pc.create_index with only legacy keywords; use deployment={"replicas":..,"pod_type":..} and re
Recommended action: Strip a leading ' ' before JSON.parse (text.replace(/^ /, '')), or fix the producer to write UTF-8 without BOM. Option: Strip U+FEFF before parsing [evidence: documented_workaround] Applies when: Any JSON text read as a string in JS Steps:
Recommended action: Use relative paths without ".." or pass allow_dangerous_paths=True when the prompt files are trusted; consider migrating off the deprecated loader. Option: Use relative paths or allow_dangerous_paths=True for trusted files [evidence: official_recommended_actio