# CDQ Genius A2A

The **CDQ Genius A2A** exposes CDQ's AI agent via the [Agent2Agent (A2A) 1.0 protocol](https://a2a-protocol.org/latest/specification/), using a JSON-RPC 2.0 binding. It allows other AI agents and orchestration frameworks to send tasks to CDQ Genius and retrieve their results using a standardized agentic protocol.

Test documentation
This is a test documentation for the CDQ Genius A2A Protocol. This documentation is not yet complete and is used to discuss and establish the final design of the protocol. The final version of the documentation will be published in the future.

## Endpoint

All A2A methods share a single physical HTTP endpoint. Every call is a `POST` request to:


```
POST https://api.cdq.com/a2a/cdq-genius/
Content-Type: application/json
A2A-Version: 1.0
```

The JSON-RPC `method` field in the request body determines which operation is performed. The individual method pages in this spec (e.g. `message/send`, `tasks/get`) represent distinct JSON-RPC operations, not separate HTTP paths.

## Agent Card

The authoritative agent metadata, including capabilities, supported extensions, and the exact endpoint URL which is published at:


```
GET https://api.cdq.com/a2a/cdq-genius/.well-known/agent-card.json
```

Retrieve the Agent Card before integrating to confirm supported methods and protocol version.

## Available Methods

| Method | Summary |
|  --- | --- |
| `message/send` | Send a message to the agent and receive a Task or a direct Message response |
| `tasks/get` | Retrieve the current state of a previously created Task |
| `tasks/cancel` | Request cancellation of an ongoing Task |


Each method is documented as a separate operation in the API reference below.

## Authentication

Authentication follows the CDQ standard OAuth2 Client Credentials flow. See the [Authentication guide](/documentation/_public/instructions/authentication) for details.