You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: en/ai-sre/agents.mdx
+43-1Lines changed: 43 additions & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -72,13 +72,55 @@ On the A2A Agents list page, click **Add A2A Agent** and fill in the form:
72
72
| Scope | Account / Team | — | Scope: **Account** (visible account-wide) or a specific **Team** (visible and editable only to members of that team). Required — see "Scope" below |
73
73
| Execution Environment | Cloud / BYOC Runners (multiple) | All environments | Controls where this A2A agent is available. Select Cloud and one or more visible BYOC Runners; leave empty to make it available everywhere. It does not route delegated calls: an A2A call still runs in the current AI SRE session's environment. For a remote agent available only on a private network, select only the Runner(s) that can reach it |
74
74
| Instructions | string | — | The agent-selection signal shown to AI SRE, as **a single document**: an optional `summary:` frontmatter block plus a body. The summary appears in the available-agent list; the body is delivered in full only on first delegation. Required; the whole document is at most 50 KB, and `summary` is at most 1,024 characters and must not contain `<` or `>`. See "[Writing Instructions](#writing-instructions)" below for the format |
75
-
| Card URL | string | — | The Agent Card URL of the remote A2A agent, or just the service origin for agents that follow the default well-known location (for example, `https://agents.example.com`). If the URL includes a path, the platform reads that exact URL; if only an origin is provided, it resolves `/.well-known/agent-card.json` by A2A convention. Required. The platform only validates that the URL is well-formed (scheme is http/https, host is non-empty) — it does not classify hosts or IPs; actual network reachability and egress restrictions depend on the current AI SRE session's execution environment. The Execution Environment field above only limits where this agent is available |
75
+
| Card URL | string | — | The Agent Card URL of the remote A2A agent, or just the service origin for agents that follow the default well-known location (for example, `https://agents.example.com`). If the URL includes a path, the platform reads that exact URL; if only an origin is provided, it resolves `/.well-known/agent-card.json` by A2A convention. Required. The platform only validates that the URL is well-formed (scheme is http/https, host is non-empty) — it does not classify hosts or IPs; actual network reachability and egress restrictions depend on the current AI SRE session's execution environment. The Execution Environment field above only limits where this agent is available. The remote agent must implement A2A Protocol 1.0 — see "[Protocol Version and Agent Card Requirements](#protocol-version-and-agent-card-requirements)" below|
76
76
| Auth Type | enum |`none`| Credential type attached to outbound requests: `none` / `bearer` (Bearer Token) / `api_key` (custom Header + Key) |
77
77
| Streaming | bool | on | Whether to communicate with the remote agent in streaming mode |
78
78
| User Auth Mode | enum |`shared`| See "Auth Modes" below |
79
79
| Skip TLS certificate verification | bool | off | Shown only when the Card URL uses HTTPS. Enable only when the remote endpoint uses a self-signed certificate inside a controlled network; this skips certificate-chain and hostname verification |
80
80
| Allow fetching OAuth configuration over HTTP (testing only) | bool | off | Required only when "Per-user OAuth" is selected and the Card URL is a non-local HTTP URL. Use only in controlled test environments; after you enable it, the AI SRE service can fetch OAuth metadata from that host |
81
81
82
+
### Protocol Version and Agent Card Requirements
83
+
84
+
When calling a remote agent as an A2A client, the platform implements **A2A Protocol 1.0** (with the `JSONRPC` or `HTTP+JSON` protocol binding). **Protocol 0.x and other major versions are not supported**: the remote agent's Agent Card must be in the 1.0 format, or delegated calls will fail.
85
+
86
+
A 1.0-format Agent Card declares its endpoints via the `supportedInterfaces` array, where at least one entry must contain `url`, `protocolBinding` (`JSONRPC` or `HTTP+JSON`), and `protocolVersion: "1.0"`. A minimal valid card looks like this:
87
+
88
+
```json
89
+
{
90
+
"name": "metrics-analyzer",
91
+
"description": "Analyzes metrics for a target service",
92
+
"supportedInterfaces": [
93
+
{
94
+
"url": "https://agents.example.com/a2a",
95
+
"protocolBinding": "JSONRPC",
96
+
"protocolVersion": "1.0"
97
+
}
98
+
],
99
+
"capabilities": { "streaming": true },
100
+
"skills": [
101
+
{
102
+
"id": "analyze_metrics",
103
+
"name": "Analyze Metrics",
104
+
"description": "Query and summarize metrics within a time window",
105
+
"tags": ["metrics"]
106
+
}
107
+
],
108
+
"defaultInputModes": ["text"],
109
+
"defaultOutputModes": ["text"]
110
+
}
111
+
```
112
+
113
+
<Note>
114
+
The `version` field on the card is the **agent's own version number**, not the protocol version. The protocol version is declared by `protocolVersion` in each `supportedInterfaces` entry.
115
+
</Note>
116
+
117
+
**Migrating from 0.x to 1.0**: if your Agent Card still uses the 0.x format, adjust it as follows before connecting:
118
+
119
+
| 0.x format | 1.0 format |
120
+
| --- | --- |
121
+
| Top-level `url` + `preferredTransport` + `additionalInterfaces`|`supportedInterfaces` array, each entry with `url` / `protocolBinding` / `protocolVersion`|
122
+
|`authentication`|`securitySchemes` + `security`|
123
+
82
124
### Writing Instructions
83
125
84
126
Instructions are **a single document** with up to two parts: an optional YAML frontmatter block at the top (a single `summary` field), followed by the body.
0 commit comments