Use A2A with the Splunk Observability AI Assistant

Agent-to-Agent (A2A) lets your agent delegate an investigation to the Splunk Observability AI Assistant. The Assistant performs the investigation and returns a text result. The initial supported workflow focuses on a Splunk APM service alert. The result can include a likely cause, supporting evidence, what remains unknown, and next steps.

Use A2A when you want the Assistant to perform an investigation. Use the Splunk MCP server when you want direct access to individual tools or want to compose your own workflow.

Before you begin

Before connecting your client, confirm the following:

  • Your organization has access to A2A interface.

  • Your organization has the AI Assistant entitlement.

  • Your client supports A2A 1.0.

  • Authenticate requests by passing your Splunk Observability token in the X-SF-TOKEN request header. The Assistant's Agent Card lists the authentication mechanisms supported for your tenant.

Discover the Agent

Connect your A2A-compatible agent client to the Splunk Observability AI Assistant by configuring it with the Agent Card URL for your tenant and the authentication details provided for your access. The Agent Card advertises the Assistant's capabilities and A2A interface.

Use this URL format, replacing <tenant> with your tenant name: https://<tenant>.signalfx.com/v2/assistant/a2a/.well-known/agent-card.json. For example, for the sfdemo tenant, use the Splunk Observability AI Assistant Agent Card.

Supported Operations

The A2A interface supports these A2A 1.0 operations:

Mode Operation Description
Polling SendMessage Submit an investigation request.
Polling GetTask Check a task's status or retrieve its result.
Streaming SendStreamingMessage Submit an investigation request and receive updates as the Assistant responds.
Streaming SubscribeToTask Receive updates for an existing task.
Task control CancelTask Request cancellation of a task.

The interface also supports the older message/... operation names.

Request Content

Each message accepts one non-empty plain-text part. The Assistant supports investigation requests about Splunk Observability Cloud health.

Note: Multipart messages, images, and files are not supported.

Results

After the task completes, retrieve the final text result in your A2A client with GetTask and the task ID returned when you submitted the investigation. For the APM service-alert workflow, the response includes a likely cause, the supporting evidence, what the Assistant could not establish, and suggested next steps. Results do not include structured citation or link objects. A URL in a response is plain text. See A2A task states and troubleshooting.

Limitations

The following limitations apply:

  • Push notifications and webhooks are not supported.

  • Requests accept plain text only; images, files, and multipart content are not supported.

  • Results are text only; structured citation and link objects are not returned.

  • The supported investigation scope is limited to the workflows enabled for your organization.