DocumentationAgents

Agent Drive

Keep useful files after a sandbox stops. Each agent can search its own Drive, download an exact file, and save new work for later sessions.

A sandbox is temporary; an agent's Drive is not. Use Drive for files that the same agent should find in a later session, including uploaded inputs, reports, exports, and finished media.

Know which files will last

Sandbox files

Working files live inside the current session's sandbox. They can disappear when that sandbox is replaced or cleaned up.

Drive files

Drive files belong to the agent and remain searchable across that agent's sessions.

Hivy doesn't copy every sandbox file into Drive. Tell the agent which deliverables to keep, or ask it to upload a named path before the session ends.

Video placeholder

Carry a file from one session to the next

Upload a demo image in one session, have the agent create and save a related file, then open a second session with the same agent and retrieve both Drive assets.

Search, download, then save

Search the catalog

The agent searches filenames, folders, file types, sizes, and dates. Search returns metadata and an exact asset ID, not the file body.

Download one asset

The agent downloads that asset ID into a new sandbox path before reading or changing the file.

Save the result

When a file should survive the session, the agent uploads it from the sandbox into a Drive folder.

Image placeholder

A session using Agent Drive

Show drive_search returning a short result list, drive_download using one asset ID, and drive_upload saving the finished file. Keep the Files panel visible beside the session.

Attach images to a request

Use the plus button in the composer to attach an image. Hivy stores it in the selected agent's Drive, describes it for the model, and keeps the attachment with the message.

An attachment belongs to the agent you selected before sending. If another agent needs it, ask the first agent to produce a shareable result or attach the file again for the other agent.

Read about session inputs

Keep Drive scope in mind

Drive is agent-scoped. Team membership controls who can open that agent's sessions, but granting a team connection or knowledge source doesn't merge files between its agents.

Use a Sheet for structured records that several people and agents should edit together. Drive fits files; Sheets fit shared rows.

Compare Drive with Sheets