Indeks
A2AService(antar muka)APIKeySecurityScheme(pesan)AgentCapabilities(pesan)AgentCard(pesan)AgentCardSignature(pesan)AgentExtension(pesan)AgentInterface(pesan)AgentProvider(pesan)AgentSkill(pesan)Artifact(pesan)AuthenticationInfo(pesan)AuthorizationCodeOAuthFlow(pesan)CancelTaskRequest(pesan)ClientCredentialsOAuthFlow(pesan)DeleteTaskPushNotificationConfigRequest(pesan)DeviceCodeOAuthFlow(pesan)GetExtendedAgentCardRequest(pesan)GetTaskPushNotificationConfigRequest(pesan)GetTaskRequest(pesan)HTTPAuthSecurityScheme(pesan)ImplicitOAuthFlow(pesan)ListTaskPushNotificationConfigsRequest(pesan)ListTaskPushNotificationConfigsResponse(pesan)ListTasksRequest(pesan)ListTasksResponse(pesan)Message(pesan)MutualTlsSecurityScheme(pesan)OAuth2SecurityScheme(pesan)OAuthFlows(pesan)OpenIdConnectSecurityScheme(pesan)Part(pesan)PasswordOAuthFlow(pesan)Role(enum)SecurityRequirement(pesan)SecurityScheme(pesan)SendMessageConfiguration(pesan)SendMessageRequest(pesan)SendMessageResponse(pesan)StreamResponse(pesan)StringList(pesan)SubscribeToTaskRequest(pesan)Task(pesan)TaskArtifactUpdateEvent(pesan)TaskPushNotificationConfig(pesan)TaskState(enum)TaskStatus(pesan)TaskStatusUpdateEvent(pesan)
A2AService
Menyediakan operasi untuk berinteraksi dengan agen menggunakan protokol A2A.
| CancelTask |
|---|
|
Membatalkan tugas yang sedang berlangsung.
|
| CreateTaskPushNotificationConfig |
|---|
|
Membuat konfigurasi notifikasi push untuk tugas.
|
| DeleteTaskPushNotificationConfig |
|---|
|
Menghapus konfigurasi notifikasi push untuk tugas.
|
| GetExtendedAgentCard |
|---|
|
Mendapatkan kartu agen yang diperluas untuk agen yang diautentikasi.
|
| GetTask |
|---|
|
Mendapatkan status terbaru tugas.
|
| GetTaskPushNotificationConfig |
|---|
|
Mendapatkan konfigurasi notifikasi push untuk tugas.
|
| ListTaskPushNotificationConfigs |
|---|
|
Mendapatkan daftar notifikasi push yang dikonfigurasi untuk tugas.
|
| ListTasks |
|---|
|
Mencantumkan tugas yang cocok dengan filter yang ditentukan.
|
| SendMessage |
|---|
|
Mengirim pesan ke agen.
|
| SendStreamingMessage |
|---|
|
Mengirim pesan streaming ke agen, sehingga memungkinkan interaksi dan pembaruan status secara real-time. Versi streaming
|
| SubscribeToTask |
|---|
|
Berlangganan pembaruan tugas untuk tugas yang tidak dalam status akhir. Menampilkan
|
APIKeySecurityScheme
Menentukan skema keamanan menggunakan kunci API.
| Kolom | |
|---|---|
description |
Deskripsi opsional untuk skema keamanan. |
location |
Wajib. Lokasi kunci API. Nilai yang valid adalah "query", "header", atau "cookie". |
name |
Wajib. Nama parameter header, kueri, atau cookie yang akan digunakan. |
AgentCapabilities
Menentukan kemampuan opsional yang didukung oleh agen.
| Kolom | |
|---|---|
extensions[] |
Daftar ekstensi protokol yang didukung oleh agen. |
streaming |
Menunjukkan apakah agen mendukung respons streaming. |
push_notifications |
Menunjukkan apakah agen mendukung pengiriman notifikasi push untuk info terbaru tugas asinkron. |
extended_agent_card |
Menunjukkan apakah agen mendukung penyediaan kartu agen yang diperluas saat diautentikasi. |
AgentCard
Manifes yang menjelaskan dirinya sendiri untuk agen. Deskripsi ini memberikan metadata penting, termasuk identitas, kemampuan, keterampilan, metode komunikasi yang didukung, dan persyaratan keamanan agen. ID Berikutnya: 20
| Kolom | |
|---|---|
name |
Wajib. Nama agen yang dapat dibaca manusia. Contoh: "Recipe Agent" (Agen Resep) |
description |
Wajib. Deskripsi agen yang dapat dibaca manusia, membantu pengguna dan agen lain memahami tujuannya. Contoh: "Agen yang membantu pengguna dengan resep dan memasak". |
supported_interfaces[] |
Wajib. Daftar antarmuka yang didukung dan diurutkan. Entri pertama lebih disukai. |
provider |
Penyedia layanan agen. |
version |
Wajib. Versi agen. Contoh: "1.0.0" |
capabilities |
Wajib. Set Kemampuan A2A yang didukung oleh agen. |
security_schemes |
Detail skema keamanan yang digunakan untuk mengautentikasi dengan agen ini. |
security_requirements[] |
Persyaratan keamanan untuk menghubungi agen. |
default_input_modes[] |
Wajib. protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Kumpulan mode interaksi yang didukung agen di semua skill. Hal ini dapat diganti per skill. Ditentukan sebagai jenis media. |
default_output_modes[] |
Wajib. Jenis media yang didukung sebagai output dari agen ini. |
skills[] |
Wajib. Keahlian mewakili kemampuan agen. Konsep ini sebagian besar bersifat deskriptif, tetapi merepresentasikan serangkaian perilaku yang lebih terfokus yang kemungkinan akan berhasil dilakukan oleh agen. |
signatures[] |
Tanda Tangan Web JSON yang dihitung untuk |
documentation_url |
URL yang menyediakan dokumentasi tambahan tentang agen. |
icon_url |
Opsional. URL ke ikon untuk agen. |
AgentCardSignature
AgentCardSignature merepresentasikan tanda tangan JWS dari AgentCard. Ini mengikuti format JSON dari JSON Web Signature (JWS) RFC 7515.
| Kolom | |
|---|---|
protected |
Wajib. Wajib. Header JWS yang dilindungi untuk tanda tangan. Ini selalu berupa objek JSON yang dienkode base64url. |
signature |
Wajib. Tanda tangan yang dihitung, dienkode base64url. |
header |
Nilai header JWS yang tidak dilindungi. |
AgentExtension
Pernyataan ekstensi protokol yang didukung oleh Agen.
| Kolom | |
|---|---|
uri |
URI unik yang mengidentifikasi ekstensi. |
description |
Deskripsi yang dapat dibaca manusia tentang cara agen ini menggunakan ekstensi. |
required |
Jika benar, klien harus memahami dan mematuhi persyaratan ekstensi. |
params |
Opsional. Parameter konfigurasi khusus ekstensi. |
AgentInterface
Mendeklarasikan kombinasi URL target, transpor, dan versi protokol untuk berinteraksi dengan agen. Hal ini memungkinkan agen mengekspos fungsi yang sama melalui beberapa mekanisme pengikatan protokol.
| Kolom | |
|---|---|
url |
Wajib. URL tempat antarmuka ini tersedia. Harus berupa URL HTTPS absolut yang valid dalam produksi. Contoh: "https://api.example.com/a2a/v1", "https://grpc.example.com/a2a" |
protocol_binding |
Wajib. Binding protokol yang didukung di URL ini. Ini adalah string formulir terbuka, yang dapat dengan mudah diperluas untuk binding protokol lainnya. Plugin inti yang didukung secara resmi adalah |
tenant |
Opsional. String buram yang digunakan untuk merutekan permintaan ke agen atau tenant tertentu saat beberapa agen ditayangkan di belakang satu endpoint A2A. Jika ditetapkan, klien HARUS menyertakan nilai ini di kolom |
protocol_version |
Wajib. Versi A2A protocol yang diekspos oleh antarmuka ini. Gunakan versi minor terbaru yang didukung per versi utama. Contoh: "0.3", "1.0" |
AgentProvider
Mewakili penyedia layanan agen.
| Kolom | |
|---|---|
url |
Wajib. URL untuk situs penyedia agen atau dokumentasi yang relevan. Contoh: "https://ai.google.dev" |
organization |
Wajib. Nama organisasi penyedia agen. Contoh: "Google" |
AgentSkill
Mewakili kemampuan atau fungsi berbeda yang dapat dilakukan agen.
| Kolom | |
|---|---|
id |
Wajib. ID unik untuk kemampuan agen. |
name |
Wajib. Nama keahlian yang dapat dibaca manusia. |
description |
Wajib. Deskripsi mendetail tentang skill. |
tags[] |
Wajib. Sekumpulan kata kunci yang menjelaskan kemampuan skill. |
examples[] |
Contoh perintah atau skenario yang dapat ditangani oleh kemampuan ini. |
input_modes[] |
Kumpulan jenis media input yang didukung untuk skill ini, yang menggantikan default agen. |
output_modes[] |
Kumpulan jenis media output yang didukung untuk skill ini, yang menggantikan default agen. |
security_requirements[] |
Skema keamanan yang diperlukan untuk skill ini. |
Artefak
Artefak mewakili output tugas.
| Kolom | |
|---|---|
artifact_id |
Wajib. ID unik (misalnya, UUID) untuk artefak. ID harus unik dalam tugas. |
name |
Nama artefak yang dapat dibaca manusia. |
description |
Opsional. Deskripsi artefak yang dapat dibaca manusia. |
parts[] |
Wajib. Konten artefak. Harus berisi minimal satu bagian. |
metadata |
Opsional. Metadata yang disertakan dengan artefak. |
extensions[] |
URI ekstensi yang ada atau berkontribusi pada Artefak ini. |
AuthenticationInfo
Menentukan detail autentikasi, yang digunakan untuk notifikasi push.
| Kolom | |
|---|---|
scheme |
Wajib. Skema Autentikasi HTTP dari registry IANA. Contoh: |
credentials |
Kredensial Notifikasi Push. Format bergantung pada skema (misalnya, token untuk Bearer). |
AuthorizationCodeOAuthFlow
Menentukan detail konfigurasi untuk alur Kode Otorisasi OAuth 2.0.
| Kolom | |
|---|---|
authorization_url |
Wajib. URL otorisasi yang akan digunakan untuk alur ini. |
token_url |
Wajib. URL token yang akan digunakan untuk alur ini. |
refresh_url |
URL yang akan digunakan untuk mendapatkan token refresh. |
scopes |
Wajib. Cakupan yang tersedia untuk skema keamanan OAuth2. |
pkce_required |
Menunjukkan apakah PKCE (RFC 7636) diperlukan untuk alur ini. PKCE harus selalu digunakan untuk klien publik dan direkomendasikan untuk semua klien. |
CancelTaskRequest
Mewakili permintaan untuk metode CancelTask.
| Kolom | |
|---|---|
tenant |
Opsional. ID perutean buram. Harus cocok dengan nilai |
id |
Wajib. ID resource tugas yang akan dibatalkan. |
metadata |
Peta nilai kunci yang fleksibel untuk meneruskan konteks atau parameter tambahan. |
ClientCredentialsOAuthFlow
Menentukan detail konfigurasi untuk alur Kredensial Klien OAuth 2.0.
| Kolom | |
|---|---|
token_url |
Wajib. URL token yang akan digunakan untuk alur ini. |
refresh_url |
URL yang akan digunakan untuk mendapatkan token refresh. |
scopes |
Wajib. Cakupan yang tersedia untuk skema keamanan OAuth2. |
DeleteTaskPushNotificationConfigRequest
Mewakili permintaan untuk metode DeleteTaskPushNotificationConfig.
| Kolom | |
|---|---|
tenant |
Opsional. ID perutean buram. Harus cocok dengan nilai |
task_id |
Wajib. ID resource tugas induk. |
id |
Wajib. ID resource konfigurasi yang akan dihapus. |
DeviceCodeOAuthFlow
Menentukan detail konfigurasi untuk alur Kode Perangkat OAuth 2.0 (RFC 8628). Alur ini dirancang untuk perangkat dengan batasan input seperti perangkat IoT, dan alat CLI tempat pengguna melakukan autentikasi di perangkat terpisah.
| Kolom | |
|---|---|
device_authorization_url |
Wajib. URL endpoint otorisasi perangkat. |
token_url |
Wajib. URL token yang akan digunakan untuk alur ini. |
refresh_url |
URL yang akan digunakan untuk mendapatkan token refresh. |
scopes |
Wajib. Cakupan yang tersedia untuk skema keamanan OAuth2. |
GetExtendedAgentCardRequest
Mewakili permintaan untuk metode GetExtendedAgentCard.
| Kolom | |
|---|---|
tenant |
Opsional. ID perutean buram. Harus cocok dengan nilai |
GetTaskPushNotificationConfigRequest
Mewakili permintaan untuk metode GetTaskPushNotificationConfig.
| Kolom | |
|---|---|
tenant |
Opsional. ID perutean buram. Harus cocok dengan nilai |
task_id |
Wajib. ID resource tugas induk. |
id |
Wajib. ID resource konfigurasi yang akan diambil. |
GetTaskRequest
Mewakili permintaan untuk metode GetTask.
| Kolom | |
|---|---|
tenant |
Opsional. ID perutean buram. Harus cocok dengan nilai |
id |
Wajib. ID resource tugas yang akan diambil. |
history_length |
Jumlah maksimum pesan terbaru dari histori tugas yang akan diambil. Nilai yang tidak ditetapkan berarti klien tidak menerapkan batas apa pun. Nilai nol adalah permintaan untuk tidak menyertakan pesan apa pun. Server TIDAK BOLEH menampilkan lebih banyak pesan daripada nilai yang diberikan, tetapi DAPAT menerapkan batas yang lebih rendah. |
HTTPAuthSecurityScheme
Menentukan skema keamanan menggunakan autentikasi HTTP.
| Kolom | |
|---|---|
description |
Deskripsi opsional untuk skema keamanan. |
scheme |
Wajib. Nama skema Autentikasi HTTP yang akan digunakan di header Authorization, seperti yang ditentukan dalam RFC7235 (misalnya, "Bearer"). Nilai ini harus didaftarkan dalam registry Skema Autentikasi IANA. |
bearer_format |
Petunjuk kepada klien untuk mengidentifikasi cara token pembawa diformat (misalnya, "JWT"). Terutama untuk tujuan dokumentasi. |
ImplicitOAuthFlow
Tidak digunakan lagi: Gunakan Kode Otorisasi + PKCE sebagai gantinya.
| Kolom | |
|---|---|
authorization_url |
URL otorisasi yang akan digunakan untuk alur ini. Nilai ini HARUS dalam bentuk URL. Standar OAuth2 mewajibkan penggunaan TLS |
refresh_url |
URL yang akan digunakan untuk mendapatkan token refresh. Nilai ini HARUS dalam bentuk URL. Standar OAuth2 memerlukan penggunaan TLS. |
scopes |
Cakupan yang tersedia untuk skema keamanan OAuth2. Peta antara nama cakupan dan deskripsi singkat untuk cakupan tersebut. Peta MUNGKIN kosong. |
ListTaskPushNotificationConfigsRequest
Mewakili permintaan untuk metode ListTaskPushNotificationConfigs.
| Kolom | |
|---|---|
tenant |
Opsional. ID perutean buram. Harus cocok dengan nilai |
task_id |
Wajib. ID resource tugas induk. |
page_size |
Jumlah maksimum konfigurasi yang akan ditampilkan. |
page_token |
Token halaman yang diterima dari panggilan |
ListTaskPushNotificationConfigsResponse
Mewakili respons yang berhasil untuk metode ListTaskPushNotificationConfigs.
| Kolom | |
|---|---|
configs[] |
Daftar konfigurasi notifikasi push. |
next_page_token |
Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada lagi hasil dalam daftar. |
ListTasksRequest
Parameter untuk mencantumkan tugas dengan kriteria pemfilteran opsional.
| Kolom | |
|---|---|
tenant |
Opsional. ID perutean buram. Harus cocok dengan nilai |
context_id |
Memfilter tugas menurut ID konteks untuk mendapatkan tugas dari percakapan atau sesi tertentu. |
status |
Memfilter tugas menurut statusnya saat ini. |
page_token |
Token halaman, yang diterima dari panggilan |
status_timestamp_after |
Memfilter tugas yang statusnya diperbarui setelah stempel waktu yang diberikan dalam format ISO 8601 (misalnya, "2023-10-27T10:00:00Z"). Hanya tugas dengan waktu stempel waktu status yang lebih besar dari atau sama dengan nilai ini yang akan ditampilkan. |
page_size |
Jumlah maksimum tugas yang akan ditampilkan. Layanan mungkin menampilkan lebih sedikit dari nilai ini. Jika tidak ditentukan, paling banyak 50 tugas akan ditampilkan. Nilai minimum adalah 1. Nilai maksimumnya adalah 100. |
history_length |
Jumlah maksimum pesan yang akan disertakan dalam histori setiap tugas. |
include_artifacts |
Apakah akan menyertakan artefak dalam tugas yang ditampilkan. Nilai defaultnya adalah false untuk mengurangi ukuran payload. |
ListTasksResponse
Objek hasil untuk metode ListTasks yang berisi array tugas dan informasi penomoran halaman.
| Kolom | |
|---|---|
tasks[] |
Wajib. Array tugas yang cocok dengan kriteria yang ditentukan. |
next_page_token |
Wajib. Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada lagi hasil dalam daftar. |
page_size |
Wajib. Ukuran halaman yang digunakan untuk respons ini. |
total_size |
Wajib. Jumlah total tugas yang tersedia (sebelum penomoran halaman). |
Pesan
Message adalah satu unit komunikasi antara klien dan server. Dapat dikaitkan dengan konteks dan/atau tugas. Untuk pesan server, context_id harus diberikan, dan task_id hanya jika tugas dibuat. Untuk pesan klien, kedua kolom bersifat opsional, dengan catatan bahwa jika keduanya diberikan, keduanya harus cocok (context_id harus merupakan kolom yang ditetapkan pada tugas). Jika hanya task_id yang diberikan, server akan menyimpulkan context_id dari.
| Kolom | |
|---|---|
message_id |
Wajib. ID unik (misalnya, UUID) pesan. Ini dibuat oleh pembuat pesan. |
context_id |
Opsional. ID konteks pesan. Jika disetel, pesan akan dikaitkan dengan konteks yang diberikan. |
task_id |
Opsional. ID tugas pesan. Jika ditetapkan, pesan akan dikaitkan dengan tugas yang diberikan. |
role |
Wajib. Mengidentifikasi pengirim pesan. |
parts[] |
Wajib. Bagian adalah penampung konten pesan. |
metadata |
Opsional. Metadata apa pun yang akan diberikan bersama dengan pesan. |
extensions[] |
URI ekstensi yang ada atau berkontribusi pada Pesan ini. |
reference_task_ids[] |
Daftar ID tugas yang dirujuk oleh pesan ini untuk konteks tambahan. |
MutualTlsSecurityScheme
Mendefinisikan skema keamanan menggunakan autentikasi mTLS.
| Kolom | |
|---|---|
description |
Deskripsi opsional untuk skema keamanan. |
OAuth2SecurityScheme
Menentukan skema keamanan menggunakan OAuth 2.0.
| Kolom | |
|---|---|
description |
Deskripsi opsional untuk skema keamanan. |
flows |
Wajib. Objek yang berisi informasi konfigurasi untuk alur OAuth 2.0 yang didukung. |
oauth2_metadata_url |
URL ke metadata server otorisasi OAuth2 RFC 8414. TLS diperlukan. |
OAuthFlows
Menentukan konfigurasi untuk alur OAuth 2.0 yang didukung.
| Kolom | |
|---|---|
Kolom union
|
|
authorization_code |
Konfigurasi untuk alur Kode Otorisasi OAuth. |
client_credentials |
Konfigurasi untuk alur Kredensial Klien OAuth. |
implicit |
Tidak digunakan lagi: Gunakan Kode Otorisasi + PKCE sebagai gantinya. |
password |
Tidak digunakan lagi: Gunakan Kode Otorisasi + PKCE atau Kode Perangkat. |
device_code |
Konfigurasi untuk alur Kode Perangkat OAuth. |
OpenIdConnectSecurityScheme
Menentukan skema keamanan menggunakan OpenID Connect.
| Kolom | |
|---|---|
description |
Deskripsi opsional untuk skema keamanan. |
open_id_connect_url |
Wajib. URL Discovery OpenID Connect untuk metadata provider OIDC. |
Bagian
Part merepresentasikan penampung untuk bagian konten komunikasi. Bagian dapat berupa tekstual murni, beberapa jenis file (gambar, video, dll.), atau blob data terstruktur (yaitu JSON).
| Kolom | |
|---|---|
metadata |
Opsional. Metadata yang terkait dengan bagian ini. |
filename |
|
media_type |
|
Kolom union
|
|
text |
Konten string bagian |
raw |
Konten byte |
url |
|
data |
|
PasswordOAuthFlow
Tidak digunakan lagi: Gunakan Kode Otorisasi + PKCE atau Kode Perangkat.
| Kolom | |
|---|---|
token_url |
URL token yang akan digunakan untuk alur ini. Nilai ini HARUS dalam bentuk URL. Standar OAuth2 memerlukan penggunaan TLS. |
refresh_url |
URL yang akan digunakan untuk mendapatkan token refresh. Nilai ini HARUS dalam bentuk URL. Standar OAuth2 memerlukan penggunaan TLS. |
scopes |
Cakupan yang tersedia untuk skema keamanan OAuth2. Peta antara nama cakupan dan deskripsi singkat untuk cakupan tersebut. Peta MUNGKIN kosong. |
Peran
Menentukan pengirim pesan dalam komunikasi protokol A2A.
| Enum | |
|---|---|
ROLE_UNSPECIFIED |
Peran tidak ditentukan. |
ROLE_USER |
Pesan dikirim dari klien ke server. |
ROLE_AGENT |
Pesan ini dikirim dari server ke klien. |
SecurityRequirement
Menentukan persyaratan keamanan untuk agen.
| Kolom | |
|---|---|
schemes |
Peta skema keamanan ke cakupan yang diperlukan. |
SecurityScheme
Menentukan skema keamanan yang dapat digunakan untuk mengamankan endpoint agen. Ini adalah jenis gabungan yang dibedakan berdasarkan Objek Skema Keamanan OpenAPI 3.2. Lihat: https://spec.openapis.org/oas/v3.2.0.html#security-scheme-object
| Kolom | |
|---|---|
Kolom union
|
|
api_key_security_scheme |
Autentikasi berbasis kunci API. |
http_auth_security_scheme |
Autentikasi HTTP (Dasar, Pemilik, dll.). |
oauth2_security_scheme |
Autentikasi OAuth 2.0. |
open_id_connect_security_scheme |
Autentikasi OpenID Connect. |
mtls_security_scheme |
Autentikasi TLS bersama. |
SendMessageConfiguration
Konfigurasi permintaan pesan kirim.
| Kolom | |
|---|---|
accepted_output_modes[] |
Daftar jenis media yang siap diterima klien untuk bagian respons. Agen HARUS menggunakan ini untuk menyesuaikan outputnya. |
task_push_notification_config |
Konfigurasi agar agen mengirimkan notifikasi push untuk info terbaru tugas. ID tugas harus kosong saat mengirim konfigurasi ini dalam permintaan |
return_immediately |
Jika |
history_length |
Jumlah maksimum pesan terbaru dari histori tugas yang akan diambil dalam respons. Nilai yang tidak ditetapkan berarti klien tidak menerapkan batas apa pun. Nilai nol adalah permintaan untuk tidak menyertakan pesan apa pun. Server TIDAK BOLEH menampilkan lebih banyak pesan daripada nilai yang diberikan, tetapi DAPAT menerapkan batas yang lebih rendah. |
SendMessageRequest
Mewakili permintaan untuk metode SendMessage.
| Kolom | |
|---|---|
tenant |
Opsional. ID perutean buram. Harus cocok dengan nilai |
message |
Wajib. Pesan yang akan dikirim ke agen. |
configuration |
Konfigurasi untuk permintaan kirim. |
metadata |
Peta nilai kunci yang fleksibel untuk meneruskan konteks atau parameter tambahan. |
SendMessageResponse
Mewakili respons untuk metode SendMessage.
| Kolom | |
|---|---|
Kolom union payload. Payload respons. payload hanya ada berupa salah satu diantara berikut: |
|
task |
Tugas yang dibuat atau diperbarui oleh pesan. |
message |
Pesan dari agen. |
StreamResponse
Objek wrapper yang digunakan dalam operasi streaming untuk merangkum berbagai jenis data respons.
| Kolom | |
|---|---|
Kolom union payload. Payload respons streaming. payload hanya ada berupa salah satu diantara berikut: |
|
task |
Objek Task yang berisi status tugas saat ini. |
message |
Objek Pesan yang berisi pesan dari agen. |
status_update |
Peristiwa yang menunjukkan pembaruan status tugas. |
artifact_update |
Peristiwa yang menunjukkan pembaruan artefak tugas. |
StringList
protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Daftar string.
| Kolom | |
|---|---|
list[] |
Nilai string individual. |
SubscribeToTaskRequest
Mewakili permintaan untuk metode SubscribeToTask.
| Kolom | |
|---|---|
tenant |
Opsional. ID perutean buram. Harus cocok dengan nilai |
id |
Wajib. ID resource tugas yang akan diikuti. |
Tugas
Task adalah unit tindakan inti untuk A2A. Tugas ini memiliki status saat ini dan saat hasil dibuat untuk tugas, hasil tersebut akan disimpan dalam artefak. Jika ada beberapa giliran untuk suatu tugas, giliran tersebut akan disimpan dalam histori.
| Kolom | |
|---|---|
id |
Wajib. ID unik (misalnya, UUID) untuk tugas, yang dibuat oleh server untuk tugas baru. |
context_id |
ID unik (misalnya, UUID) untuk kumpulan interaksi kontekstual (tugas dan pesan). |
status |
Wajib. Status |
artifacts[] |
Kumpulan artefak output untuk |
history[] |
protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Histori interaksi dari |
metadata |
protolint:enable REPEATED_FIELD_NAMES_PLURALIZED Objek key/value untuk menyimpan metadata kustom tentang tugas. |
TaskArtifactUpdateEvent
Delta tugas tempat artefak telah dibuat.
| Kolom | |
|---|---|
task_id |
Wajib. ID tugas untuk artefak ini. |
context_id |
Wajib. ID konteks tempat tugas ini berada. |
artifact |
Wajib. Artefak yang dibuat atau diperbarui. |
append |
Jika benar (true), konten artefak ini harus ditambahkan ke artefak yang dikirim sebelumnya dengan ID yang sama. |
last_chunk |
Jika benar (true), ini adalah bagian terakhir artefak. |
metadata |
Opsional. Metadata yang terkait dengan update artefak. |
TaskPushNotificationConfig
Penampung yang mengaitkan konfigurasi notifikasi push dengan tugas tertentu.
| Kolom | |
|---|---|
tenant |
Opsional. ID perutean buram. Harus cocok dengan nilai |
id |
Detail konfigurasi notifikasi push. ID unik (mis. UUID) untuk konfigurasi notifikasi push ini. |
task_id |
ID tugas yang terkait dengan konfigurasi ini. |
url |
Wajib. URL tempat notifikasi harus dikirim. |
token |
Token unik untuk tugas atau sesi ini. |
authentication |
Informasi autentikasi diperlukan untuk mengirim notifikasi. |
TaskState
Menentukan kemungkinan status siklus proses Task.
| Enum | |
|---|---|
TASK_STATE_UNSPECIFIED |
Tugas dalam status tidak diketahui atau tidak ditentukan. |
TASK_STATE_SUBMITTED |
Menunjukkan bahwa tugas telah berhasil dikirim dan dikonfirmasi. |
TASK_STATE_WORKING |
Menunjukkan bahwa tugas sedang aktif diproses oleh agen. |
TASK_STATE_COMPLETED |
Menunjukkan bahwa tugas telah berhasil diselesaikan. Ini adalah status terminal. |
TASK_STATE_FAILED |
Menunjukkan bahwa tugas telah selesai dengan error. Ini adalah status terminal. |
TASK_STATE_CANCELED |
Menunjukkan bahwa tugas dibatalkan sebelum selesai. Ini adalah status terminal. |
TASK_STATE_INPUT_REQUIRED |
Menunjukkan bahwa agen memerlukan input pengguna tambahan untuk melanjutkan. Ini adalah status terganggu. |
TASK_STATE_REJECTED |
Menunjukkan bahwa agen telah memutuskan untuk tidak melakukan tugas. Hal ini dapat dilakukan selama pembuatan tugas awal atau nanti setelah agen menentukan bahwa tugas tidak dapat atau tidak akan dilanjutkan. Ini adalah status terminal. |
TASK_STATE_AUTH_REQUIRED |
Menunjukkan bahwa autentikasi diperlukan untuk melanjutkan. Ini adalah status terganggu. |
TaskStatus
Penampung untuk status tugas
| Kolom | |
|---|---|
state |
Wajib. Status tugas saat ini. |
message |
Pesan yang terkait dengan status. |
timestamp |
Stempel Waktu ISO 8601 saat status dicatat. Contoh: "2023-10-27T10:00:00Z" |
TaskStatusUpdateEvent
Peristiwa yang dikirim oleh agen untuk memberi tahu klien tentang perubahan status tugas.
| Kolom | |
|---|---|
task_id |
Wajib. ID tugas yang telah berubah. |
context_id |
Wajib. ID konteks tempat tugas berada. |
status |
Wajib. Status baru tugas. |
metadata |
Opsional. Metadata yang terkait dengan pembaruan tugas. |