How to get artifact data from agent engine?

[NBestsuNgan]

like question, i print out payload from agent engine and my agent have call load artifact inside, but in the payload it does not any inline data that i can use, did anyone solve this problem?

[adk-bot]

Response from ADK Answering Agent (experimental, answer may be inaccurate)

TLDR: Artifact data is not directly included in the agent engine's payload. You need to use the load_artifact method on a context object (like CallbackContext or ToolContext) within your agent's code to access the artifact's data.

---

Hello! I see you're asking how to access artifact data from the agent engine.

In ADK, artifacts are stored and managed by an ArtifactService. The payload you are inspecting likely contains metadata or references to the artifacts, but not the raw inline_data itself. To access the data, your agent needs to explicitly load it using the load_artifact(artifact_name) function, which is available on context objects provided to your agent's methods.

This function returns a google.generativeai.types.Part object. You can then access the binary data and its MIME type from the inline_data attribute of this object.

Here is an example of how you might use it within a tool:

from google.generativeai.protos import Part
from adk.tools import tool

@tool
def process_report(context: ToolContext, report_name: str) -> str:
    """Loads and processes a report artifact."""
    try:
        # Load the artifact using its name
        report_artifact = context.load_artifact(report_name)

        # Access the raw data and mime type
        if report_artifact and report_artifact.inline_data:
            data = report_artifact.inline_data.data
            mime_type = report_artifact.inline_data.mime_type
            print(f"Successfully loaded artifact {report_name} with mime_type: {mime_type}")

            # Now you can process the data...
            # For example, if it's a text file:
            if "text" in mime_type:
                content = data.decode('utf-8')
                # ... do something with the content ...

            return "Report processed successfully."
        else:
            return "Artifact not found or has no inline data."
    except Exception as e:
        return f"An error occurred: {e}"

For more detailed information, you can refer to the official documentation on artifacts. [1]

[1] https://google.github.io/adk-docs/artifacts/