Returns the events Resource.
appendEvents(name, body=None, x__xgafv=None)
Appends A2ATaskRecordEvents to an A2ATaskRecord.
Close httplib2 connections.
create(parent, a2aTaskRecordId=None, body=None, x__xgafv=None)
Creates an A2ATaskRecord.
Deletes an A2ATaskRecord.
get(name, view=None, x__xgafv=None)
Gets an A2ATaskRecord.
list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)
Lists A2ATaskRecords in a TaskStore.
list_next(previous_request, previous_response)
Retrieves the next page of results.
appendEvents(name, body=None, x__xgafv=None)
Appends A2ATaskRecordEvents to an A2ATaskRecord.
Args:
name: string, Required. The resource name of the A2ATaskRecord to append events to. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}` (required)
body: object, The request body.
The object takes the form of:
{ # Request message for A2ATaskRecordService.AppendA2ATaskRecordEvents.
"events": [ # Required. The events to append to the task.
{ # An event that records a single change applied to a task's state.
"createTime": "A String", # Output only. The time at which the event was created.
"eventData": { # The data describing the change carried by an A2ATaskRecordEvent. Multiple changes can be set in a single event. # Required. The data describing the change carried by this event.
"artifactChange": { # An event payload describing a change to one of the task's artifacts. # Optional. A change to one of the task's artifacts.
"append": True or False, # Optional. Whether the artifact parts should be appended to an existing artifact rather than replacing it.
"artifact": { # Represents a single artifact produced by a task. # Required. The artifact that was added or updated.
"artifactId": "A String", # Required. The unique identifier of the artifact within the task.
"description": "A String", # Optional. A human-readable description of the artifact.
"displayName": "A String", # Optional. The human-readable name of the artifact.
"extensions": [ # Optional. A2A protocol extensions associated with the artifact.
"A String",
],
"metadata": { # Optional. Additional context or parameters related to the artifact. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the artifact.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
},
"lastChunk": True or False, # Optional. Whether this is the last chunk of a streamed artifact.
},
"historyAppend": { # An event payload that appends a new message to the task history. # Optional. A new message appended to the task history.
"message": { # Represents a single message in a conversation, compliant with the A2A specification. # Required. The message to append to the task history.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
},
"metadataChange": { # An event payload describing a change to the task-level metadata. # Optional. A change to the task-level metadata.
"metadata": { # Required. The updated task metadata after the change. This is a partial update that will be merged with the existing metadata.
"a_key": "", # Properties of the object.
},
"updateMask": "A String", # Optional. A field mask indicating which metadata paths changed. If unset, all fields are updated.
},
"statusUpdate": { # An event payload that updates the task's state and optional status message. # Optional. An update to the task's state and status message.
"message": { # Represents a single message in a conversation, compliant with the A2A specification. # Optional. The status message associated with the state change.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
"state": "A String", # Required. The new state of the task.
"timestamp": "A String", # Optional. The time at which the status change occurred.
},
},
"generation": "A String", # Output only. The generation number of the task after this event is applied.
"metadata": { # Optional. Additional context or parameters related to the event. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
},
],
"generation": "A String", # Required. The current task generation.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for A2ATaskRecordService.AppendA2ATaskRecordEvents.
"generation": "A String", # Task generation matching the last event
}
close()
Close httplib2 connections.
create(parent, a2aTaskRecordId=None, body=None, x__xgafv=None)
Creates an A2ATaskRecord.
Args:
parent: string, Required. The resource name of the TaskStore to create the A2ATaskRecord under. Format: `projects/{project}/locations/{location}/taskStores/{task_store}` (required)
body: object, The request body.
The object takes the form of:
{ # An A2ATaskRecord represents an A2ATask (unit of work) persisted in storage.
"appId": "A String", # Optional. Agent application which created the task.
"artifacts": [ # Output only. The artifacts produced by the task.
{ # Represents a single artifact produced by a task.
"artifactId": "A String", # Required. The unique identifier of the artifact within the task.
"description": "A String", # Optional. A human-readable description of the artifact.
"displayName": "A String", # Optional. The human-readable name of the artifact.
"extensions": [ # Optional. A2A protocol extensions associated with the artifact.
"A String",
],
"metadata": { # Optional. Additional context or parameters related to the artifact. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the artifact.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
},
],
"contextId": "A String", # Optional. A generic identifier for grouping related tasks (e.g., session_id, workflow_id).
"createTime": "A String", # Output only. The creation timestamp of the task.
"deleteTime": "A String", # Output only. The deletion timestamp of the task.
"expireTime": "A String", # Output only. Timestamp of when this task is considered expired. This is *always* provided on output, and is calculated based on the `update_time` and the `ttl`.
"generation": "A String", # Output only. The task generation number.
"history": [ # Output only. The history of the task messages.
{ # Represents a single message in a conversation, compliant with the A2A specification.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
],
"metadata": { # Optional. A flexible key-value map for protocol extensions to attach custom attributes to core data structures.
"a_key": "", # Properties of the object.
},
"name": "A String", # Identifier. The resource name of the task. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}`
"purgeTime": "A String", # Output only. The purge timestamp of the task.
"serviceMetadata": { # Optional. Metadata relevant to the A2ATaskRecordService, not the agent to agent communication.
"a_key": "", # Properties of the object.
},
"status": { # Represents the status of an A2ATaskRecord. # Output only. The status of the task, including the state, status message, and timestamp.
"message": { # Represents a single message in a conversation, compliant with the A2A specification. # Output only. The status message associated with the state.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
"state": "A String", # Output only. The current state of the task.
"timestamp": "A String", # Output only. The time at which the state was set.
},
"ttl": "A String", # Optional. Input only. The TTL (Time To Live) for the task. If not set, the task will expire in 24 hours by default. Valid range: (0 seconds, 1000 days]
"updateTime": "A String", # Output only. The last update timestamp of the task.
"userId": "A String", # Optional. Task owner user ID.
}
a2aTaskRecordId: string, Optional. The user defined ID to use for the A2ATaskRecord, which will become the final component of the A2ATaskRecord resource name. If not provided, Vertex AI will generate a value for this ID. This value may be up to 63 characters, and valid characters are `[a-z0-9-]`. The first character must be a letter, and the last character must be a letter or number.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An A2ATaskRecord represents an A2ATask (unit of work) persisted in storage.
"appId": "A String", # Optional. Agent application which created the task.
"artifacts": [ # Output only. The artifacts produced by the task.
{ # Represents a single artifact produced by a task.
"artifactId": "A String", # Required. The unique identifier of the artifact within the task.
"description": "A String", # Optional. A human-readable description of the artifact.
"displayName": "A String", # Optional. The human-readable name of the artifact.
"extensions": [ # Optional. A2A protocol extensions associated with the artifact.
"A String",
],
"metadata": { # Optional. Additional context or parameters related to the artifact. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the artifact.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
},
],
"contextId": "A String", # Optional. A generic identifier for grouping related tasks (e.g., session_id, workflow_id).
"createTime": "A String", # Output only. The creation timestamp of the task.
"deleteTime": "A String", # Output only. The deletion timestamp of the task.
"expireTime": "A String", # Output only. Timestamp of when this task is considered expired. This is *always* provided on output, and is calculated based on the `update_time` and the `ttl`.
"generation": "A String", # Output only. The task generation number.
"history": [ # Output only. The history of the task messages.
{ # Represents a single message in a conversation, compliant with the A2A specification.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
],
"metadata": { # Optional. A flexible key-value map for protocol extensions to attach custom attributes to core data structures.
"a_key": "", # Properties of the object.
},
"name": "A String", # Identifier. The resource name of the task. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}`
"purgeTime": "A String", # Output only. The purge timestamp of the task.
"serviceMetadata": { # Optional. Metadata relevant to the A2ATaskRecordService, not the agent to agent communication.
"a_key": "", # Properties of the object.
},
"status": { # Represents the status of an A2ATaskRecord. # Output only. The status of the task, including the state, status message, and timestamp.
"message": { # Represents a single message in a conversation, compliant with the A2A specification. # Output only. The status message associated with the state.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
"state": "A String", # Output only. The current state of the task.
"timestamp": "A String", # Output only. The time at which the state was set.
},
"ttl": "A String", # Optional. Input only. The TTL (Time To Live) for the task. If not set, the task will expire in 24 hours by default. Valid range: (0 seconds, 1000 days]
"updateTime": "A String", # Output only. The last update timestamp of the task.
"userId": "A String", # Optional. Task owner user ID.
}
delete(name, x__xgafv=None)
Deletes an A2ATaskRecord.
Args:
name: string, Required. The resource name of the A2ATaskRecord to delete. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}` (required)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An A2ATaskRecord represents an A2ATask (unit of work) persisted in storage.
"appId": "A String", # Optional. Agent application which created the task.
"artifacts": [ # Output only. The artifacts produced by the task.
{ # Represents a single artifact produced by a task.
"artifactId": "A String", # Required. The unique identifier of the artifact within the task.
"description": "A String", # Optional. A human-readable description of the artifact.
"displayName": "A String", # Optional. The human-readable name of the artifact.
"extensions": [ # Optional. A2A protocol extensions associated with the artifact.
"A String",
],
"metadata": { # Optional. Additional context or parameters related to the artifact. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the artifact.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
},
],
"contextId": "A String", # Optional. A generic identifier for grouping related tasks (e.g., session_id, workflow_id).
"createTime": "A String", # Output only. The creation timestamp of the task.
"deleteTime": "A String", # Output only. The deletion timestamp of the task.
"expireTime": "A String", # Output only. Timestamp of when this task is considered expired. This is *always* provided on output, and is calculated based on the `update_time` and the `ttl`.
"generation": "A String", # Output only. The task generation number.
"history": [ # Output only. The history of the task messages.
{ # Represents a single message in a conversation, compliant with the A2A specification.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
],
"metadata": { # Optional. A flexible key-value map for protocol extensions to attach custom attributes to core data structures.
"a_key": "", # Properties of the object.
},
"name": "A String", # Identifier. The resource name of the task. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}`
"purgeTime": "A String", # Output only. The purge timestamp of the task.
"serviceMetadata": { # Optional. Metadata relevant to the A2ATaskRecordService, not the agent to agent communication.
"a_key": "", # Properties of the object.
},
"status": { # Represents the status of an A2ATaskRecord. # Output only. The status of the task, including the state, status message, and timestamp.
"message": { # Represents a single message in a conversation, compliant with the A2A specification. # Output only. The status message associated with the state.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
"state": "A String", # Output only. The current state of the task.
"timestamp": "A String", # Output only. The time at which the state was set.
},
"ttl": "A String", # Optional. Input only. The TTL (Time To Live) for the task. If not set, the task will expire in 24 hours by default. Valid range: (0 seconds, 1000 days]
"updateTime": "A String", # Output only. The last update timestamp of the task.
"userId": "A String", # Optional. Task owner user ID.
}
get(name, view=None, x__xgafv=None)
Gets an A2ATaskRecord.
Args:
name: string, Required. The resource name of the A2ATaskRecord. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}` (required)
view: string, Optional. The view of the A2ATaskRecord to return.
Allowed values
A2A_TASK_RECORD_VIEW_UNSPECIFIED - Task view unspecified.
A2A_TASK_RECORD_VIEW_BASIC - Task header only (status, metadata, timestamps)
A2A_TASK_RECORD_VIEW_FULL - Full materialized state (artifacts + history)
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An A2ATaskRecord represents an A2ATask (unit of work) persisted in storage.
"appId": "A String", # Optional. Agent application which created the task.
"artifacts": [ # Output only. The artifacts produced by the task.
{ # Represents a single artifact produced by a task.
"artifactId": "A String", # Required. The unique identifier of the artifact within the task.
"description": "A String", # Optional. A human-readable description of the artifact.
"displayName": "A String", # Optional. The human-readable name of the artifact.
"extensions": [ # Optional. A2A protocol extensions associated with the artifact.
"A String",
],
"metadata": { # Optional. Additional context or parameters related to the artifact. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the artifact.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
},
],
"contextId": "A String", # Optional. A generic identifier for grouping related tasks (e.g., session_id, workflow_id).
"createTime": "A String", # Output only. The creation timestamp of the task.
"deleteTime": "A String", # Output only. The deletion timestamp of the task.
"expireTime": "A String", # Output only. Timestamp of when this task is considered expired. This is *always* provided on output, and is calculated based on the `update_time` and the `ttl`.
"generation": "A String", # Output only. The task generation number.
"history": [ # Output only. The history of the task messages.
{ # Represents a single message in a conversation, compliant with the A2A specification.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
],
"metadata": { # Optional. A flexible key-value map for protocol extensions to attach custom attributes to core data structures.
"a_key": "", # Properties of the object.
},
"name": "A String", # Identifier. The resource name of the task. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}`
"purgeTime": "A String", # Output only. The purge timestamp of the task.
"serviceMetadata": { # Optional. Metadata relevant to the A2ATaskRecordService, not the agent to agent communication.
"a_key": "", # Properties of the object.
},
"status": { # Represents the status of an A2ATaskRecord. # Output only. The status of the task, including the state, status message, and timestamp.
"message": { # Represents a single message in a conversation, compliant with the A2A specification. # Output only. The status message associated with the state.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
"state": "A String", # Output only. The current state of the task.
"timestamp": "A String", # Output only. The time at which the state was set.
},
"ttl": "A String", # Optional. Input only. The TTL (Time To Live) for the task. If not set, the task will expire in 24 hours by default. Valid range: (0 seconds, 1000 days]
"updateTime": "A String", # Output only. The last update timestamp of the task.
"userId": "A String", # Optional. Task owner user ID.
}
list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)
Lists A2ATaskRecords in a TaskStore.
Args:
parent: string, Required. The resource name of the TaskStore to list the A2ATaskRecords under. Format: `projects/{project}/locations/{location}/taskStores/{task_store}` (required)
filter: string, Optional. The standard list filter. More detail in [AIP-160](https://google.aip.dev/160). Supported fields: * `context_id` * `status.state` Example: `context_id="abc"`, `status.state="WORKING"`.
orderBy: string, Optional. A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. If this field is omitted, the default ordering is `create_time` descending. More detail in [AIP-132](https://google.aip.dev/132). Supported fields: * `create_time` * `update_time` Example: `create_time desc`.
pageSize: integer, Optional. The maximum number of tasks to return. The service may return fewer than this value. If unspecified, at most 10 tasks will be returned. The maximum value is 100; values above 100 will be coerced to 100.
pageToken: string, Optional. The next_page_token value returned from a previous list A2ATaskRecordService.ListA2ATaskRecords call.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for A2ATaskRecordService.ListA2ATaskRecords.
"a2aTaskRecords": [ # List of A2ATaskRecords in the requested page.
{ # An A2ATaskRecord represents an A2ATask (unit of work) persisted in storage.
"appId": "A String", # Optional. Agent application which created the task.
"artifacts": [ # Output only. The artifacts produced by the task.
{ # Represents a single artifact produced by a task.
"artifactId": "A String", # Required. The unique identifier of the artifact within the task.
"description": "A String", # Optional. A human-readable description of the artifact.
"displayName": "A String", # Optional. The human-readable name of the artifact.
"extensions": [ # Optional. A2A protocol extensions associated with the artifact.
"A String",
],
"metadata": { # Optional. Additional context or parameters related to the artifact. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the artifact.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
},
],
"contextId": "A String", # Optional. A generic identifier for grouping related tasks (e.g., session_id, workflow_id).
"createTime": "A String", # Output only. The creation timestamp of the task.
"deleteTime": "A String", # Output only. The deletion timestamp of the task.
"expireTime": "A String", # Output only. Timestamp of when this task is considered expired. This is *always* provided on output, and is calculated based on the `update_time` and the `ttl`.
"generation": "A String", # Output only. The task generation number.
"history": [ # Output only. The history of the task messages.
{ # Represents a single message in a conversation, compliant with the A2A specification.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
],
"metadata": { # Optional. A flexible key-value map for protocol extensions to attach custom attributes to core data structures.
"a_key": "", # Properties of the object.
},
"name": "A String", # Identifier. The resource name of the task. Format: `projects/{project}/locations/{location}/taskStores/{task_store}/a2aTaskRecords/{a2a_task_record}`
"purgeTime": "A String", # Output only. The purge timestamp of the task.
"serviceMetadata": { # Optional. Metadata relevant to the A2ATaskRecordService, not the agent to agent communication.
"a_key": "", # Properties of the object.
},
"status": { # Represents the status of an A2ATaskRecord. # Output only. The status of the task, including the state, status message, and timestamp.
"message": { # Represents a single message in a conversation, compliant with the A2A specification. # Output only. The status message associated with the state.
"extensions": [ # Optional. A2A protocol extensions associated with the message.
"A String",
],
"messageId": "A String", # Required. The unique identifier of the message.
"metadata": { # Optional. Additional context or parameters related to the message. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"parts": [ # Required. The content parts that make up the message.
{ # A single part of a message or artifact. A part carries exactly one kind of content.
"data": "", # Optional. Arbitrary data content.
"filename": "A String", # Optional. The name of the file, when the part represents a file.
"mediaType": "A String", # Optional. The IANA media type of the content, e.g. "text/plain" or "image/png".
"metadata": { # Optional. Additional context or parameters related to the part. Extensions can be used to strongly type metadata values for specific use cases.
"a_key": "", # Properties of the object.
},
"raw": "A String", # Optional. Raw binary content.
"text": "A String", # Optional. Textual content.
"url": "A String", # Optional. A URL pointing to the content.
},
],
"referenceTaskIds": [ # Optional. The IDs of other tasks referenced by this message.
"A String",
],
"role": "A String", # Required. The role of the sender of the message.
},
"state": "A String", # Output only. The current state of the task.
"timestamp": "A String", # Output only. The time at which the state was set.
},
"ttl": "A String", # Optional. Input only. The TTL (Time To Live) for the task. If not set, the task will expire in 24 hours by default. Valid range: (0 seconds, 1000 days]
"updateTime": "A String", # Output only. The last update timestamp of the task.
"userId": "A String", # Optional. Task owner user ID.
},
],
"nextPageToken": "A String", # A token, which can be sent as A2ATaskRecordService.ListA2ATaskRecordsRequest.page_token to retrieve the next page. Absence of this field indicates there are no subsequent pages.
}
list_next(previous_request, previous_response)
Retrieves the next page of results. Args: previous_request: The request for the previous page. (required) previous_response: The response from the request for the previous page. (required) Returns: A request object that you can call 'execute()' on to request the next page. Returns None if there are no more items in the collection.