Package lf.a2a.v1

Indeks

A2AService

Menyediakan operasi untuk berinteraksi dengan agen menggunakan protokol A2A.

CancelTask

rpc CancelTask(CancelTaskRequest) returns (Task)

Membatalkan tugas yang sedang berlangsung.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

CreateTaskPushNotificationConfig

rpc CreateTaskPushNotificationConfig(TaskPushNotificationConfig) returns (TaskPushNotificationConfig)

Membuat konfigurasi notifikasi push untuk tugas.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

DeleteTaskPushNotificationConfig

rpc DeleteTaskPushNotificationConfig(DeleteTaskPushNotificationConfigRequest) returns (Empty)

Menghapus konfigurasi notifikasi push untuk tugas.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GetExtendedAgentCard

rpc GetExtendedAgentCard(GetExtendedAgentCardRequest) returns (AgentCard)

Mendapatkan kartu agen yang diperluas untuk agen yang diautentikasi.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GetTask

rpc GetTask(GetTaskRequest) returns (Task)

Mendapatkan status terbaru tugas.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

GetTaskPushNotificationConfig

rpc GetTaskPushNotificationConfig(GetTaskPushNotificationConfigRequest) returns (TaskPushNotificationConfig)

Mendapatkan konfigurasi notifikasi push untuk tugas.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

ListTaskPushNotificationConfigs

rpc ListTaskPushNotificationConfigs(ListTaskPushNotificationConfigsRequest) returns (ListTaskPushNotificationConfigsResponse)

Mendapatkan daftar notifikasi push yang dikonfigurasi untuk tugas.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

ListTasks

rpc ListTasks(ListTasksRequest) returns (ListTasksResponse)

Mencantumkan tugas yang cocok dengan filter yang ditentukan.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

SendMessage

rpc SendMessage(SendMessageRequest) returns (SendMessageResponse)

Mengirim pesan ke agen.

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

SendStreamingMessage

rpc SendStreamingMessage(SendMessageRequest) returns (StreamResponse)

Mengirim pesan streaming ke agen, sehingga memungkinkan interaksi dan pembaruan status secara real-time. Versi streaming SendMessage

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

SubscribeToTask

rpc SubscribeToTask(SubscribeToTaskRequest) returns (StreamResponse)

Berlangganan pembaruan tugas untuk tugas yang tidak dalam status akhir. Menampilkan UnsupportedOperationError jika tugas sudah dalam status akhir (selesai, gagal, dibatalkan, ditolak).

Cakupan otorisasi

Memerlukan salah satu cakupan OAuth berikut:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/ces

Untuk mengetahui informasi selengkapnya, lihat Authentication Overview.

APIKeySecurityScheme

Menentukan skema keamanan menggunakan kunci API.

Kolom
description

string

Deskripsi opsional untuk skema keamanan.

location

string

Wajib. Lokasi kunci API. Nilai yang valid adalah "query", "header", atau "cookie".

name

string

Wajib. Nama parameter header, kueri, atau cookie yang akan digunakan.

AgentCapabilities

Menentukan kemampuan opsional yang didukung oleh agen.

Kolom
extensions[]

AgentExtension

Daftar ekstensi protokol yang didukung oleh agen.

streaming

bool

Menunjukkan apakah agen mendukung respons streaming.

push_notifications

bool

Menunjukkan apakah agen mendukung pengiriman notifikasi push untuk info terbaru tugas asinkron.

extended_agent_card

bool

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

string

Wajib. Nama agen yang dapat dibaca manusia. Contoh: "Recipe Agent" (Agen Resep)

description

string

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[]

AgentInterface

Wajib. Daftar antarmuka yang didukung dan diurutkan. Entri pertama lebih disukai.

provider

AgentProvider

Penyedia layanan agen.

version

string

Wajib. Versi agen. Contoh: "1.0.0"

capabilities

AgentCapabilities

Wajib. Set Kemampuan A2A yang didukung oleh agen.

security_schemes

map<string, SecurityScheme>

Detail skema keamanan yang digunakan untuk mengautentikasi dengan agen ini.

security_requirements[]

SecurityRequirement

Persyaratan keamanan untuk menghubungi agen.

default_input_modes[]

string

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[]

string

Wajib. Jenis media yang didukung sebagai output dari agen ini.

skills[]

AgentSkill

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[]

AgentCardSignature

Tanda Tangan Web JSON yang dihitung untuk AgentCard ini.

documentation_url

string

URL yang menyediakan dokumentasi tambahan tentang agen.

icon_url

string

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

string

Wajib. Wajib. Header JWS yang dilindungi untuk tanda tangan. Ini selalu berupa objek JSON yang dienkode base64url.

signature

string

Wajib. Tanda tangan yang dihitung, dienkode base64url.

header

Struct

Nilai header JWS yang tidak dilindungi.

AgentExtension

Pernyataan ekstensi protokol yang didukung oleh Agen.

Kolom
uri

string

URI unik yang mengidentifikasi ekstensi.

description

string

Deskripsi yang dapat dibaca manusia tentang cara agen ini menggunakan ekstensi.

required

bool

Jika benar, klien harus memahami dan mematuhi persyaratan ekstensi.

params

Struct

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

string

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

string

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 JSONRPC, GRPC, dan HTTP+JSON.

tenant

string

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 tenant dari semua pesan permintaan yang dikirim ke antarmuka ini. Server bertanggung jawab untuk menafsirkan nilai dan merutekan permintaan yang sesuai; protokol tidak menentukan format atau semantiknya.

protocol_version

string

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

string

Wajib. URL untuk situs penyedia agen atau dokumentasi yang relevan. Contoh: "https://ai.google.dev"

organization

string

Wajib. Nama organisasi penyedia agen. Contoh: "Google"

AgentSkill

Mewakili kemampuan atau fungsi berbeda yang dapat dilakukan agen.

Kolom
id

string

Wajib. ID unik untuk kemampuan agen.

name

string

Wajib. Nama keahlian yang dapat dibaca manusia.

description

string

Wajib. Deskripsi mendetail tentang skill.

tags[]

string

Wajib. Sekumpulan kata kunci yang menjelaskan kemampuan skill.

examples[]

string

Contoh perintah atau skenario yang dapat ditangani oleh kemampuan ini.

input_modes[]

string

Kumpulan jenis media input yang didukung untuk skill ini, yang menggantikan default agen.

output_modes[]

string

Kumpulan jenis media output yang didukung untuk skill ini, yang menggantikan default agen.

security_requirements[]

SecurityRequirement

Skema keamanan yang diperlukan untuk skill ini.

Artefak

Artefak mewakili output tugas.

Kolom
artifact_id

string

Wajib. ID unik (misalnya, UUID) untuk artefak. ID harus unik dalam tugas.

name

string

Nama artefak yang dapat dibaca manusia.

description

string

Opsional. Deskripsi artefak yang dapat dibaca manusia.

parts[]

Part

Wajib. Konten artefak. Harus berisi minimal satu bagian.

metadata

Struct

Opsional. Metadata yang disertakan dengan artefak.

extensions[]

string

URI ekstensi yang ada atau berkontribusi pada Artefak ini.

AuthenticationInfo

Menentukan detail autentikasi, yang digunakan untuk notifikasi push.

Kolom
scheme

string

Wajib. Skema Autentikasi HTTP dari registry IANA. Contoh: Bearer, Basic, Digest. Nama skema tidak peka huruf besar/kecil sesuai dengan RFC 9110 Bagian 11.1.

credentials

string

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

string

Wajib. URL otorisasi yang akan digunakan untuk alur ini.

token_url

string

Wajib. URL token yang akan digunakan untuk alur ini.

refresh_url

string

URL yang akan digunakan untuk mendapatkan token refresh.

scopes

map<string, string>

Wajib. Cakupan yang tersedia untuk skema keamanan OAuth2.

pkce_required

bool

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

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.

id

string

Wajib. ID resource tugas yang akan dibatalkan.

metadata

Struct

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

string

Wajib. URL token yang akan digunakan untuk alur ini.

refresh_url

string

URL yang akan digunakan untuk mendapatkan token refresh.

scopes

map<string, string>

Wajib. Cakupan yang tersedia untuk skema keamanan OAuth2.

DeleteTaskPushNotificationConfigRequest

Mewakili permintaan untuk metode DeleteTaskPushNotificationConfig.

Kolom
tenant

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.

task_id

string

Wajib. ID resource tugas induk.

id

string

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

string

Wajib. URL endpoint otorisasi perangkat.

token_url

string

Wajib. URL token yang akan digunakan untuk alur ini.

refresh_url

string

URL yang akan digunakan untuk mendapatkan token refresh.

scopes

map<string, string>

Wajib. Cakupan yang tersedia untuk skema keamanan OAuth2.

GetExtendedAgentCardRequest

Mewakili permintaan untuk metode GetExtendedAgentCard.

Kolom
tenant

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.

GetTaskPushNotificationConfigRequest

Mewakili permintaan untuk metode GetTaskPushNotificationConfig.

Kolom
tenant

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.

task_id

string

Wajib. ID resource tugas induk.

id

string

Wajib. ID resource konfigurasi yang akan diambil.

GetTaskRequest

Mewakili permintaan untuk metode GetTask.

Kolom
tenant

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.

id

string

Wajib. ID resource tugas yang akan diambil.

history_length

int32

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

string

Deskripsi opsional untuk skema keamanan.

scheme

string

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

string

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

string

URL otorisasi yang akan digunakan untuk alur ini. Nilai ini HARUS dalam bentuk URL. Standar OAuth2 mewajibkan penggunaan TLS

refresh_url

string

URL yang akan digunakan untuk mendapatkan token refresh. Nilai ini HARUS dalam bentuk URL. Standar OAuth2 memerlukan penggunaan TLS.

scopes

map<string, string>

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

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.

task_id

string

Wajib. ID resource tugas induk.

page_size

int32

Jumlah maksimum konfigurasi yang akan ditampilkan.

page_token

string

Token halaman yang diterima dari panggilan ListTaskPushNotificationConfigsRequest sebelumnya.

ListTaskPushNotificationConfigsResponse

Mewakili respons yang berhasil untuk metode ListTaskPushNotificationConfigs.

Kolom
configs[]

TaskPushNotificationConfig

Daftar konfigurasi notifikasi push.

next_page_token

string

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

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.

context_id

string

Memfilter tugas menurut ID konteks untuk mendapatkan tugas dari percakapan atau sesi tertentu.

status

TaskState

Memfilter tugas menurut statusnya saat ini.

page_token

string

Token halaman, yang diterima dari panggilan ListTasks sebelumnya. ListTasksResponse.next_page_token. Berikan ini untuk mengambil halaman selanjutnya.

status_timestamp_after

Timestamp

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

int32

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

int32

Jumlah maksimum pesan yang akan disertakan dalam histori setiap tugas.

include_artifacts

bool

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[]

Task

Wajib. Array tugas yang cocok dengan kriteria yang ditentukan.

next_page_token

string

Wajib. Token untuk mengambil halaman hasil berikutnya, atau kosong jika tidak ada lagi hasil dalam daftar.

page_size

int32

Wajib. Ukuran halaman yang digunakan untuk respons ini.

total_size

int32

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

string

Wajib. ID unik (misalnya, UUID) pesan. Ini dibuat oleh pembuat pesan.

context_id

string

Opsional. ID konteks pesan. Jika disetel, pesan akan dikaitkan dengan konteks yang diberikan.

task_id

string

Opsional. ID tugas pesan. Jika ditetapkan, pesan akan dikaitkan dengan tugas yang diberikan.

role

Role

Wajib. Mengidentifikasi pengirim pesan.

parts[]

Part

Wajib. Bagian adalah penampung konten pesan.

metadata

Struct

Opsional. Metadata apa pun yang akan diberikan bersama dengan pesan.

extensions[]

string

URI ekstensi yang ada atau berkontribusi pada Pesan ini.

reference_task_ids[]

string

Daftar ID tugas yang dirujuk oleh pesan ini untuk konteks tambahan.

MutualTlsSecurityScheme

Mendefinisikan skema keamanan menggunakan autentikasi mTLS.

Kolom
description

string

Deskripsi opsional untuk skema keamanan.

OAuth2SecurityScheme

Menentukan skema keamanan menggunakan OAuth 2.0.

Kolom
description

string

Deskripsi opsional untuk skema keamanan.

flows

OAuthFlows

Wajib. Objek yang berisi informasi konfigurasi untuk alur OAuth 2.0 yang didukung.

oauth2_metadata_url

string

URL ke metadata server otorisasi OAuth2 RFC 8414. TLS diperlukan.

OAuthFlows

Menentukan konfigurasi untuk alur OAuth 2.0 yang didukung.

Kolom

Kolom union flow.

flow hanya dapat berupa salah satu dari hal berikut:

authorization_code

AuthorizationCodeOAuthFlow

Konfigurasi untuk alur Kode Otorisasi OAuth.

client_credentials

ClientCredentialsOAuthFlow

Konfigurasi untuk alur Kredensial Klien OAuth.

implicit
(deprecated)

ImplicitOAuthFlow

Tidak digunakan lagi: Gunakan Kode Otorisasi + PKCE sebagai gantinya.

password
(deprecated)

PasswordOAuthFlow

Tidak digunakan lagi: Gunakan Kode Otorisasi + PKCE atau Kode Perangkat.

device_code

DeviceCodeOAuthFlow

Konfigurasi untuk alur Kode Perangkat OAuth.

OpenIdConnectSecurityScheme

Menentukan skema keamanan menggunakan OpenID Connect.

Kolom
description

string

Deskripsi opsional untuk skema keamanan.

open_id_connect_url

string

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

Struct

Opsional. Metadata yang terkait dengan bagian ini.

filename

string

filename opsional untuk file (misalnya, "document.pdf").

media_type

string

media_type (jenis MIME) konten bagian (misalnya, "text/plain", "application/json", "image/png"). Kolom ini tersedia untuk semua jenis suku cadang.

Kolom union content.

content hanya dapat berupa salah satu dari hal berikut:

text

string

Konten string bagian text.

raw

bytes

Konten byte raw dari sebuah file. Dalam serialisasi JSON, ini dienkode sebagai string base64.

url

string

url yang mengarah ke konten file.

data

Value

data terstruktur arbitrer sebagai nilai JSON (objek, array, string, angka, boolean, atau null).

PasswordOAuthFlow

Tidak digunakan lagi: Gunakan Kode Otorisasi + PKCE atau Kode Perangkat.

Kolom
token_url

string

URL token yang akan digunakan untuk alur ini. Nilai ini HARUS dalam bentuk URL. Standar OAuth2 memerlukan penggunaan TLS.

refresh_url

string

URL yang akan digunakan untuk mendapatkan token refresh. Nilai ini HARUS dalam bentuk URL. Standar OAuth2 memerlukan penggunaan TLS.

scopes

map<string, string>

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

map<string, StringList>

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 scheme.

scheme hanya dapat berupa salah satu dari hal berikut:

api_key_security_scheme

APIKeySecurityScheme

Autentikasi berbasis kunci API.

http_auth_security_scheme

HTTPAuthSecurityScheme

Autentikasi HTTP (Dasar, Pemilik, dll.).

oauth2_security_scheme

OAuth2SecurityScheme

Autentikasi OAuth 2.0.

open_id_connect_security_scheme

OpenIdConnectSecurityScheme

Autentikasi OpenID Connect.

mtls_security_scheme

MutualTlsSecurityScheme

Autentikasi TLS bersama.

SendMessageConfiguration

Konfigurasi permintaan pesan kirim.

Kolom
accepted_output_modes[]

string

Daftar jenis media yang siap diterima klien untuk bagian respons. Agen HARUS menggunakan ini untuk menyesuaikan outputnya.

task_push_notification_config

TaskPushNotificationConfig

Konfigurasi agar agen mengirimkan notifikasi push untuk info terbaru tugas. ID tugas harus kosong saat mengirim konfigurasi ini dalam permintaan SendMessage.

return_immediately

bool

Jika true, operasi akan segera ditampilkan setelah membuat tugas, meskipun pemrosesan masih berlangsung. Jika false (default), operasi HARUS menunggu hingga tugas mencapai status akhir (COMPLETED, FAILED, CANCELED, REJECTED) atau terganggu (INPUT_REQUIRED, AUTH_REQUIRED) sebelum ditampilkan.

history_length

int32

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

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.

message

Message

Wajib. Pesan yang akan dikirim ke agen.

configuration

SendMessageConfiguration

Konfigurasi untuk permintaan kirim.

metadata

Struct

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

Task

Tugas yang dibuat atau diperbarui oleh pesan.

message

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

Task

Objek Task yang berisi status tugas saat ini.

message

Message

Objek Pesan yang berisi pesan dari agen.

status_update

TaskStatusUpdateEvent

Peristiwa yang menunjukkan pembaruan status tugas.

artifact_update

TaskArtifactUpdateEvent

Peristiwa yang menunjukkan pembaruan artefak tugas.

StringList

protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Daftar string.

Kolom
list[]

string

Nilai string individual.

SubscribeToTaskRequest

Mewakili permintaan untuk metode SubscribeToTask.

Kolom
tenant

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.

id

string

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

string

Wajib. ID unik (misalnya, UUID) untuk tugas, yang dibuat oleh server untuk tugas baru.

context_id

string

ID unik (misalnya, UUID) untuk kumpulan interaksi kontekstual (tugas dan pesan).

status

TaskStatus

Wajib. Status Task saat ini, termasuk state dan message.

artifacts[]

Artifact

Kumpulan artefak output untuk Task.

history[]

Message

protolint:disable REPEATED_FIELD_NAMES_PLURALIZED Histori interaksi dari Task.

metadata

Struct

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

string

Wajib. ID tugas untuk artefak ini.

context_id

string

Wajib. ID konteks tempat tugas ini berada.

artifact

Artifact

Wajib. Artefak yang dibuat atau diperbarui.

append

bool

Jika benar (true), konten artefak ini harus ditambahkan ke artefak yang dikirim sebelumnya dengan ID yang sama.

last_chunk

bool

Jika benar (true), ini adalah bagian terakhir artefak.

metadata

Struct

Opsional. Metadata yang terkait dengan update artefak.

TaskPushNotificationConfig

Penampung yang mengaitkan konfigurasi notifikasi push dengan tugas tertentu.

Kolom
tenant

string

Opsional. ID perutean buram. Harus cocok dengan nilai tenant dari AgentInterface yang dipilih di Kartu Agen saat kolom tersebut ditetapkan.

id

string

Detail konfigurasi notifikasi push. ID unik (mis. UUID) untuk konfigurasi notifikasi push ini.

task_id

string

ID tugas yang terkait dengan konfigurasi ini.

url

string

Wajib. URL tempat notifikasi harus dikirim.

token

string

Token unik untuk tugas atau sesi ini.

authentication

AuthenticationInfo

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

TaskState

Wajib. Status tugas saat ini.

message

Message

Pesan yang terkait dengan status.

timestamp

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

string

Wajib. ID tugas yang telah berubah.

context_id

string

Wajib. ID konteks tempat tugas berada.

status

TaskStatus

Wajib. Status baru tugas.

metadata

Struct

Opsional. Metadata yang terkait dengan pembaruan tugas.