Files and Resources

Attaching Files

You can include files in a conversation using Paths:

from fast_agent import Prompt
from pathlib import Path

plans = await agent.send(Prompt.user("Summarise this PDF", Path("secret-plans.pdf")))

This works for any mime type that can be tokenized by the model.

MCP Server resources can be conveniently included in a message with:

description = await agent.with_resource(
    "What is in this image?",
    "resource://images/cat.png",
    "mcp_image_server",
)

Prompt Files can include Resources:

agent_script.txt

---USER
Please extract the major colours from this CSS file:
---RESOURCE
index.css

They can be loaded with fast_agent.load_prompt, or exposed by an external MCP prompt server.