Recommended action: Export GEMINI_API_KEY (or GOOGLE_API_KEY, which wins if both set); for Vertex set project/location (GOOGLE_CLOUD_PROJECT/GOOGLE_CLOUD_LOCATION) and configure ADC or pass credentials explicitly. Option: Provide credentials [evidence: official_recommended_action
Recommended action: Start history with a user Content, map assistant->model, and put system prompts in GenerateContentConfig.systemInstruction. Option: Normalize roles [evidence: documented_workaround] Steps: 1. role 'assistant' -> 'model' 2. prepend a user turn 3. systemInstruct
Cause (Documented platform behavior): tTool runs processJsonSchema unless parameters contain '$schema' (then moves them to parametersJsonSchema). processJsonSchema throws if type and anyOf coexist or type is only 'null', and skips additionalProperties. Fix status: documented_beha
Recommended action: Remove the local entry (claude mcp remove <name>) so it does not shadow the connector, then connect the service at claude.ai connectors while signed in with the same account; it then appears in Claude Code automatically with a
Recommended action: Use https://bedrock-runtime.<region>.amazonaws.com (or a gateway that proxies Converse verbatim) and matching region_name. Option: Fix endpoint_url/region [evidence: official_recommended_action] Steps: 1. Remove custom endpoint_url or set it to bedrock-runtime
Recommended action: If your code: add the dependency to package.json. If a third-party package: add it via packageExtensions in .yarnrc.yml (and upstream a fix). Alternatives: pnpMode: loose (still unsafe) or nodeLinker: node-modules. Option: Declare the dependency (or extend the
Recommended action: Add <arg>-parameters</arg> to maven-compiler-plugin compilerArgs (or options.compilerArgs += '-parameters' in Gradle), or pass parameter names explicitly; use public static methods or provide the instance. Option: Compile with -parameters [evidence: official_r
Recommended action: Provide exactly one of FileName (files/...) or InlinedRequests; use 'batches/<id>' with the Gemini API and 'projects/.../batchPredictionJobs/<id>' with Vertex. Option: Use exactly one source and backend-correct names [evidence: official_recommended_action] Ste
Recommended action: Use string Literals/enums in Gemini schemas and convert on the client, or use response_json_schema. Option: Use string enums and map back [evidence: documented_workaround] Applies when: See trigger Steps: 1. Change Literal[1,2] to Literal['1','2'] (or str Enum
Recommended action: Use --scope local (default), user or project; to provide org-wide servers, add them to managedMcpServers in deployed managed settings. Option: Pick a writable scope or use managed settings [evidence: official_recommended_action] Applies when: See trigger Steps
Recommended action: Use CacheConfig(strategy='anthropic') explicitly for ARN-based profiles of Claude models. Option: Set the caching strategy explicitly [evidence: official_recommended_action] Steps: 1. CacheConfig(strategy='anthropic') for Claude-backed application profiles. Ex
Recommended action: Pass the JSON schema via response_json_schema (config) instead of response_schema, avoid dict-typed fields, or use a Vertex AI client. Option: Use response_json_schema [evidence: documented_workaround] Applies when: See trigger Steps: 1. config={'response_mime
Recommended action: Replace bare true with {"type":"object","additionalProperties":true} (a contract change), split type arrays into anyOf branches, inline remote $ref into $defs; use --strict as a CI gate. Option: Rewrite unportable constructs [evidence: official_recommended_act
Recommended action: Inspect ReplicaSet/Job events for the violation list and add the required securityContext settings; or, if appropriate, adjust the namespace's enforce level/version label or configure exemptions. Option: Make the pod template compliant [evidence: official_reco
Recommended action: Add the regex 'prompt tokens \((\d+)\) exceed model maximum \((\d+)\)' to overflow detection (LiteLLM rewrites it to 'prompt is too long: N tokens > M maximum'). Option: Match Mantle's overflow wording [evidence: documented_workaround] Steps: 1. Regex-match 'p
Recommended action: Mark only critical tools strict, make parameters required (nullable instead of optional), cut union types, flatten nesting, or split tools across requests/sub-agents. Option: Reduce strict surface per request [evidence: official_recommended_action] Applies whe
Recommended action: Use an exact semver; declare every {var} under the remote/transport variables (or environment/arguments for packages); trim _meta; put flag names only in name. Option: Fix server.json [evidence: official_recommended_action] Applies when: See trigger Steps: 1.
Recommended action: Set GOOGLE_API_KEY or GEMINI_API_KEY (Gemini API) or set Backend: genai.BackendVertexAI with GOOGLE_CLOUD_PROJECT/GOOGLE_CLOUD_LOCATION; avoid logging the error verbatim if ClientConfig may hold credentials. Option: Provide backend credentials [evidence: offic