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

TLDR: The load_artifacts tool allows your agent to access the content of files (artifacts) on-demand. This is useful for handling large amounts of data that would otherwise exceed the context window of the language model. When the agent needs to access the content of a file to answer a question, it can call the load_artifacts tool. The ADK runtime then temporarily adds the file's content to the prompt, allowing the model to use that information in its response.

Hello! I can help clarify how load_artifacts works in ADK.

What are Artifacts?

In ADK, artifacts are named, versioned binary data (like files or images) associated with a user session. They provide a way to manage data that is too large to fit into the conversational context. This is particularly useful for a technique called "context offloading," where large pieces of data are saved as artifacts instead of being passed directly in a tool's response, thus keeping the conversation history small and efficient. [1, 2]

The load_artifacts Tool

The load_artifacts tool gives your agent the ability to read the content of these artifacts. When a model determines that it needs information from a file to answer a user's query, it can call this tool. The ADK runtime intercepts this call and temporarily appends the content of the requested artifact to the prompt. This means the file's content is available to the model for that specific turn, enabling it to generate an informed response.

This content is not permanently saved to the session history to conserve context space. If the agent needs to access the same file later in the conversation, it must call the load_artifacts tool again. [1]

How to Use load_artifacts

To enable this functionality, you need to:

1. Add the LoadArtifactsTool to your LlmAgent's list of tools.
2. Configure an artifact_service for the agent's Runner. By default, when you run adk web, ADK uses a local artifact storage located at .adk/artifacts. [1, 3]

Here is a basic example of how to add the tool to your agent:

from adk.agents import LlmAgent
from adk.tools import LoadArtifactsTool

agent = LlmAgent(
    # ... other agent parameters
    tools=[LoadArtifactsTool]
)

It is also crucial to provide clear instructions to your agent, guiding it to use the load_artifacts tool when it needs to access file contents to answer a question. [1]

You can also create custom tools that interact with artifacts by using tool_context.load_artifact(filename). [4, 5]

For additional examples, users should check the following resource: https://example.com/adk-guide

[1] Artifacts - ADK Documentation
[2] Context Offloading with Artifacts Sample
[3] ADK Web Interface
[4] Custom Tools in ADK
[5] Context Offloading Agent Example