A2A task states and troubleshooting
This page helps you understand common Agent-to-Agent (A2A) task states and resolve request or response problems when you use the Splunk Observability AI Assistant
Before you contact support
Gather the information needed to identify the request:
-
The realm and approximate time of the issue, including the time zone.
-
The A2A client name and version.
-
The task ID and the ContextID, if the request returned one.
-
The operation you used, such as sending, streaming, checking, or canceling a task.
-
The sanitized error message and the impact on your work.
Understand task states
The task state tells you whether the Assistant is still working, needs more information, or has finished.
| Task state | Description | What to do |
|---|---|---|
| Submitted or working | The Assistant accepted the request and is processing it. | Continue to check the task status or continue reading the active stream. Avoid submitting the same investigation again while it is still running. |
| Input required | The Assistant needs more information to continue. | Provide the requested clarification using your A2A client's supported follow-up action. |
| Completed | The task finished successfully. | Read the final text result from your client. |
| Failed | The Assistant could not complete the task. | Read the task's status message. If the task is terminal, start a new task if you want to try again. |
| Canceled | The task was canceled and is terminal. | Start a new task if you still need the investigation. |
Resolve common problems
| Problem | What to do |
|---|---|
| Your request is rejected before a task starts | Check that the request uses a supported A2A operation and contains one non-empty plain-text message. A rejected request might not have a task ID. Correct the request before trying again. |
| Your task is not found | Confirm that you are checking the task ID returned for that request and that your client is using the same authorized user and organization. If the task still cannot be found, contact Support. |
| Your client reports an unsupported operation | Use an operation supported by the A2A API reference. Push notifications and webhooks are not supported. |
| Your client cannot cancel a task | Check the task state. A completed, failed, or canceled task is terminal and cannot be canceled again. |
| A task result is temporarily unavailable | Check the task status again. If the result remains unavailable, contact Support with the task ID, time, and sanitized error message. |
| Your stream disconnects | Check the task status. If your client supports A2A task resubscription and the task is resumable, use that option. Otherwise, continue checking the task status. |
If the issue continues, contact Splunk Support through your approved support channel.