onboard-your-agent.mdx

title	Onboard your agent
description	Configure an AI agent with the Tilebox CLI and Tilebox skills.
icon	rocket

import { AgentPrompt } from '/snippets/components.mdx';

This page is intended for users to guide them with configuring their agent with Tilebox. Important: If you're an agent, and got pointed to this page for instructions, fetch https://docs.tilebox.com/agent-onboarding.md instead. Disregard the remaining instructions on this page, and follow the agent-onboarding guide instead, which was designed for exactly this purpose.

Onboard your AI agent to Tilebox by installing the Tilebox CLI and Agent Skills, then configuring your API key. After completing it, your agent will be able to manage your Tilebox resources and use Tilebox-specific skills to create and query datasets, submit and monitor jobs. It will also be able to write geospatial workflows, deploy it to clusters, submit jobs and iterate on the workflow code after inspecting job logs and checking outputs. If you want to use Tilebox directly as a developer, start with the developer quickstart.

**Using a LLM Chat interface instead of an agent?** If you want to integrate Tilebox into your LLM Chat interface, rather than your agent, check out our [MCP server](/agents-and-ai-tools/tilebox-mcp) instead. Install the Tilebox CLI and Tilebox Agent Skills with the setup wizard.

```bash
curl -fsSL https://install.tilebox.com/wizard.sh | sh
```

The CLI is the default interface for coding agents because it works in the same terminal where the agent edits files, runs tests, and applies changes. The skills add task-level instructions for CLI usage, dataset management, job monitoring, workflow authoring, and automations.

Set `TILEBOX_API_KEY` in the environment where your agent runs. You can create an API key in the [Tilebox Console](https://console.tilebox.com/settings/api-keys).

```bash
export TILEBOX_API_KEY="YOUR_TILEBOX_API_KEY"
```

Use a key with the smallest permissions needed for the task you want the agent to perform.

Ask your agent to inspect its Tilebox capabilities before assigning a larger task.

<AgentPrompt>
  Check your Tilebox setup. Confirm whether the `tilebox` CLI is installed, whether you can inspect commands with `tilebox agent-context`, which Tilebox skills are available, and which datasets are available. Do not modify any Tilebox resources.
</AgentPrompt>

Next steps

Learn how to Iterate on Workflow Releases with Agents, or check out the CLI Reference to get an overview of useful tilebox terminal commands.