Skip to content

Commit f9be8ea

Browse files
committed
Update a2a task specification and schema
Signed-off-by: Emmanuel Allen <[email protected]>
1 parent 048a571 commit f9be8ea

File tree

2 files changed

+11
-9
lines changed

2 files changed

+11
-9
lines changed

dsl-reference.md

Lines changed: 5 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -493,17 +493,15 @@ The [A2A Call](#a2a-call) enables workflows to interact with AI agents described
493493

494494
| Name | Type | Required | Description|
495495
|:--|:---:|:---:|:---|
496-
| method | `string` | `yes` | The A2A JSON-RPC method to send. |
496+
| method | `string` | `yes` | The A2A JSON-RPC method to send.<br>*Supported values are: `message/send`, `message/stream`, `tasks/get`, `tasks/list`, `tasks/cancel`, `tasks/resubscribe`, `tasks/pushNotificationConfig/set`, `tasks/pushNotificationConfig/get`, `tasks/pushNotificationConfig/list`, `tasks/pushNotificationConfig/delete`, and `agent/getAuthenticatedExtendedCard`* |
497497
| agentCard | [`externalResource`](#external-resource) | `yes` | The AgentCard resource that describes the agent to call. |
498-
| parameters | `any` | `no` | The parameters for the A2A rpc method. For the `message/send` and `message/stream` methods the parameters `message.messageId` and `message.role` must be automatically set if missing. |
498+
| parameters | `map` <br> `string` | `no` | The parameters for the A2A RPC method. For the `message/send` and `message/stream` methods, runtimes must set the parameters `message.messageId` and `message.role` if missing in the definition.<br>*Can be an object or a direct runtime expression.* |
499499

500500
> [!NOTE]
501501
> The `security` and `securitySchemes` fields of the AgentCard contain authentication requirements and schemes for when communicating with the agent.
502-
503-
> [!NOTE]
504-
> On success the output is the JSON-RPC result. On failure runtimes must raise an error.
505-
506-
> [!NOTE]
502+
>
503+
> On success the output is the JSON-RPC result. On failure runtimes must raise an error with type [https://serverlessworkflow.io/spec/1.0.0/errors/runtime](https://github.com/serverlessworkflow/specification/blob/main/dsl-reference.md#standard-error-types).
504+
>
507505
> For `message/stream` and `tasks/resubscribe` methods the output is a sequentially ordered array of all the result objects.
508506

509507
###### Examples

schema/workflow.yaml

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -453,11 +453,15 @@ $defs:
453453
type: string
454454
title: WithA2AMethod
455455
description: The A2A method to send.
456+
enum: [ 'message/send', 'message/stream', 'tasks/get', 'tasks/list', 'tasks/cancel', 'tasks/resubscribe', 'tasks/pushNotificationConfig/set', 'tasks/pushNotificationConfig/get', 'tasks/pushNotificationConfig/list', 'tasks/pushNotificationConfig/delete', 'agent/getAuthenticatedExtendedCard' ]
456457
parameters:
457-
type: object
458+
oneOf:
459+
- type: object
460+
minProperties: 1
461+
additionalProperties: true
462+
- type: string
458463
title: WithA2AParameters
459464
description: The parameters object to send with the A2A method.
460-
additionalProperties: true
461465
required: [ agentCard, method ]
462466
unevaluatedProperties: false
463467
- title: CallFunction

0 commit comments

Comments
 (0)