Skip to main content
eve agents are built around the concept of filesystems as a core primitive. Archil now automatically provides the layer connecting them to your data by exposing tools for eve agents to read, write, and execute commands against data, as if it was a local filesystem.
1

Create an Archil disk

Go to the Archil console and create a new disk. Also, create an API key in the same region as your disk. Create a .env.local file in the root of your project with:
ARCHIL_API_KEY=<your-api-key>
ARCHIL_REGION=<your-disk-region>
ARCHIL_DISK_ID=<your-disk-id>
2

Install the SDK

npm install disk @archildata/eve
3

Create tools

Give your agent tools to read/write from an existing Archil disk. Create agent/tools/disk.ts:
import * as archil from "disk";
import { createDiskTools } from "@archildata/eve";

const disk = await archil.getDisk(process.env.ARCHIL_DISK_ID!);
export default createDiskTools(disk);
Optionally, you can add Archil as the compute and persistent storage provider for eve agent sessions. Create agent/sandbox/sandbox.ts: 
import { defineSandbox } from "eve/sandbox";
import { archilBackend } from "@archildata/eve";

export default defineSandbox({
  backend: archilBackend({
    disk: process.env.ARCHIL_DISK_ID!,
  }),
});