Skip to main content
Version: v1.7.3-14 🚧

Agent files

Overview​

When an agent runs during a chat session, it can produce output files such as generated reports, data exports, code outputs, or PDF summaries. These are collectively called agent files. They are attached to the chat session and can be accessed, downloaded, or imported into a collection without leaving the chat interface.

Types of agent files​

Agent files fall into two categories:

Stored files​

Stored files are saved in h2oGPTe's object storage and persist as long as the message remains in the chat session. They appear in the Files tab of the agent turn's side panel. Stored files include both the primary output (for example, a CSV or code file) and PDF renderings where applicable.

Server-side working directory files​

While an agent runs, it can also write temporary files to a sandboxed server-side working directory. These files do not appear in the chat UI, but you can list and delete them via the REST API:

  • GET /api/v1/chats/{session_id}/agent_server_files: list files in the agent's working directory
  • DELETE /api/v1/chats/{session_id}/agent_server_files: delete all files in the working directory

For full API details, see the REST API guide.

Working with stored files in the chat UI​

To view, download, import, or package agent-generated files, open the side panel by clicking Details on an agent response, then click the Files tab.

For step-by-step instructions on each file action, see Agent response view — File actions.

Permissions​

Working with agent files requires the Get or Delete Agent Files permission. See Roles and Permissions for details.

Feedback