Recommended action: Upgrade libpq/client to a version with SNI (>= 14); otherwise pass options=endpoint%3D<endpoint-id> in the connection string, use libpq key=value in the database field, or put endpoint=<id>$<password> in the password field. Option: Upgrade client or pass endpo
Recommended action: Treat a RateLimitError with a long Retry-After as a scheduling signal: read err.response.headers["retry-after"] / "retry-after-ms" and re-queue the job after that time instead of raising max_retries. Option: Schedule a later retry from the Retry-After header [
Recommended action: Use strict function schemas with providers that support them, or wrap tools with failure_error_function / a model adapter that normalizes 'null' to '{}'; check provider streaming of tool-call deltas. Option: Normalize arguments at the model boundary [evidence:
Recommended action: Grant the deployer 'Service Account User' (roles/iam.serviceAccountUser) on the runtime service account (or project), plus the Cloud Functions/Run deploy roles. Option: Grant Service Account User to the deployer [evidence: official_recommended_action] Applies
Recommended action: In task mode enqueue the Task first (e.g. via TaskUpdater after creating/submitting the task), then status/artifact updates; in message mode emit exactly one Message and nothing else. Option: Emit a valid event sequence [evidence: official_recommended_action]
Recommended action: Add bedrock:InvokeTool (in addition to InvokeModel) to the role; do not copy the example statement verbatim since it only shows bedrock:InvokeModel. Option: Grant bedrock:InvokeTool [evidence: official_recommended_action] Steps: 1. Add an IAM statement allowin
Recommended action: Raise the origin response timeout (max 240 s), stream responses, or move long jobs to async polling. Option: Increase timeout or stream [evidence: official_recommended_action] Applies when: See trigger Steps: 1. Set origin response timeout up to 240 s
Recommended action: Upgrade the project to Blaze (attach billing) via the console URL in the message, or use the Emulator Suite for local-only development. Option: Upgrade to Blaze or stay on emulators [evidence: official_recommended_action] Applies when: Spark projects needing F
Recommended action: Check e.response / e.body for the server's actual error; verify TOGETHER_API_KEY with a cheap authenticated call (e.g. list models) before assuming billing; if the key is valid, check account credits. Option: Inspect the attached response [evidence: documented
Recommended action: Pass only one auth mode; pin botocore/langchain-aws together if you rely on api_key; unset AWS_BEARER_TOKEN_BEDROCK when you intend profile/role auth. Option: Use a single auth mode and pin versions [evidence: official_recommended_action] Steps: 1. Remove api_
Recommended action: Flatten the schema to top-level primitive properties (split nested structs into separate fields), use supported formats, and string enums. Option: Flatten the elicitation schema [evidence: official_recommended_action] Applies when: See trigger Steps: 1. Use a
Recommended action: Upload a validation file and pass validation_file=...; set n_evals >= patience + warmup_evals + 1. Option: Provide validation data and enough evals [evidence: official_recommended_action] Steps: 1. validation_file=<file-id> 2. n_evals=4 (defaults) Expected: Jo
Recommended action: Convert fine-tuning data to JSONL (or Parquet with pip install 'together[pyarrow]'); use CSV/JSONL for evaluations; read the printed report's message field. Option: Match format to purpose [evidence: official_recommended_action] Steps: 1. fine-tune: JSONL or P
Recommended action: Check logs for the excess-pings message / GOAWAY; raise keepalive_time_ms to at least the server's minimum (e.g. >= 5 min unless the server permits more), and don't set keepalive_permit_without_calls unless the server allows it. Don't route this RESOURCE_EXHAU
Recommended action: Bind to 0.0.0.0 (or ::) on the port the platform expects; for Next.js standalone set HOSTNAME=0.0.0.0 and PORT=<internal_port> in the Dockerfile/env; ensure fly.toml internal_port matches. Option: Bind on all interfaces at the expected port [evidence: official
Recommended action: Set AWS_REGION (or aws_region=) or an explicit base_url. Option: Provide region or base URL [evidence: official_recommended_action] Steps: 1. export AWS_REGION=us-east-1 (or pass aws_region). Expected: Client constructs. Evidence basis (self-declared by the co
Recommended action: Keep legacy (initialize) support enabled on servers that must serve Java clients (e.g. hybrid/StatefulForInitializeClients or legacy stateless modes); upgrade clients to java-sdk 3.x once released. Option: Serve legacy initialize for Java clients [evidence: of
Recommended action: Choose one auth mode: unset AWS_BEARER_TOKEN_BEDROCK for SigV4/profile auth, or drop the AWS credential args to use the Bedrock API key. Older SDKs without api_key ignore the env var entirely and fall back to SigV4. Option: Use exactly
Recommended action: Send format as a JSON object (the schema itself) or the exact string "json". Option: Pass the schema object, not a string [evidence: official_recommended_action] Applies when: See trigger Steps: 1. format: {"type":"object",...} (not "{...}"). Expected: Error n
Recommended action: Use corepack or let pnpm download the pinned version (v11: pmOnFail: download), or align your global pnpm; on 9/10 relax package-manager-strict settings if needed. Option: Let pnpm/corepack provide the pinned version [evidence: official_recommended_action] App