google-adk-kotlin-core/com.google.adk.kt.artifacts/GcsArtifactService

GcsArtifactService

class GcsArtifactService(bucketName: String, storageClient: Storage) : ArtifactService

An artifact service implementation using Google Cloud Storage (GCS).

The blob name format used depends on whether the filename has a user namespace:

For files with user namespace (starting with "user:"): {appName}/{userId}/user/{filename}/{version}
For regular session-scoped files: {appName}/{userId}/{sessionId}/{filename}/{version}

A session whose id is literally user therefore shares the user-scope prefix, and listArtifactKeys reports its session-scoped filenames to that user's other sessions, which cannot load them.

Constructors

GcsArtifactService

constructor(bucketName: String, storageClient: Storage)

Functions

deleteArtifact

open suspend override fun deleteArtifact(sessionKey: SessionKey, filename: String)

Deletes an artifact.

listArtifactKeys

open suspend override fun listArtifactKeys(sessionKey: SessionKey): List<String>

Lists the filenames visible to a session: its own artifacts plus the user's user: ones.

listVersions

open suspend override fun listVersions(sessionKey: SessionKey, filename: String): List<Int>

Lists all the versions (as revision IDs) of an artifact.

loadArtifact

open suspend override fun loadArtifact(sessionKey: SessionKey, filename: String, version: Int? = null): Part?

Gets an artifact.

saveAndReloadArtifact

open suspend override fun saveAndReloadArtifact(sessionKey: SessionKey, filename: String, artifact: Part): Part

Saves an artifact and returns it with fileData if available.

saveArtifact

open suspend override fun saveArtifact(sessionKey: SessionKey, filename: String, artifact: Part): Int

Saves an artifact.