Troubleshooting

Agent failures

• Provider unavailable: verify the selected model and its provider key in Environment.
• Schema validation failed: reduce optional complexity and confirm every required field can be produced.
• Tool call rejected: confirm assignment, connector authentication, and the exact input contract.
• Public request returns 403: enable deployment and use a valid scoped integration key.

Knowledge failures

• No sources returned: wait for Indexed and confirm the knowledge base is attached.
• Poor matches: check source quality, query wording, and whether unrelated material shares the same base.
• Embedding error: confirm the provider key for the pinned embedding model.
• Model change blocked: create a new base or re-index because vector dimensions are pinned.

Fleet failures

• Wrong branch: inspect the producers structured output and condition field.
• Loop does not stop: set a hard maximum iteration count.
• Run pauses: check whether it is waiting for human approval.
• Run stops early: inspect token budget, timeout, and the first failed node.