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.

Note: Do not send access tokens, authorization credentials, or sensitive prompt content.

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.