Handle a document-gate refusal and retry the agent task
Manage cases where an uploaded document is rejected by the agent, review the refusal message, adjust your inputs and safely retry the task.
Audience
This guide is designed for project manager.
Steps
Step 1: Review the refusal message in the task dialog
When a document is refused, keep the Agent task dialog open and review the focused banner explaining why the document was not reviewed or written to the project.

Step 2: Check and update your task inputs
Confirm that your previous inputs in the dialog are still preserved, then adjust any notes or details about the document so the agent can process the task correctly.

Step 3: Retry the agent task execution
Use the enabled retry option in the dialog to submit the task again with your updated inputs, keeping the modal open until you are ready to close it.

Last updated: 2026-08-31