# What is a Fungi AI Agent?

> The AI helper you talk to. It works on its own Computer.

An Agent is an AI helper that belongs to your Team. You talk to it in Grove. It
can answer questions, and it can also do things: write files, run commands,
clone code. It does those things on its Computer.

<Diagram
  label="You send a message to an Agent. The Agent uses its Computer and replies."
  nodes={[
    { title: "You", text: "Ask in Grove" },
    { title: "Agent", text: "Decides what to do", focus: true },
    { title: "Computer", text: "Runs it, keeps the files" },
  ]}
  links={["message", "tools"]}
/>

## Conversations

One conversation is a **Session**. Each Session has its own saved messages, so
you can reopen it from Grove. **All Agents** shows the visible conversations
across Agents. Select a named Agent in the filter to see only its conversations.

Sessions belong to an Agent. A new Session does not make a new Agent, a new Home
Computer, or a separate set of files.

If the Agent is still working when you think of the next thing, write it anyway
and choose **Queue**. Acceptance means the prompt is saved for work, not that
the task is finished. **Cancel** stops the current run. A waiting message's
Cancel action withdraws that message if it has not started. Neither action
undoes changes already made.

The inbox shows conversations waiting for you, working, done or failed. Read the
reply and inspect the result before treating a task as complete.

## If a run fails

A failed-run notice explains what happened and what it means for credit: **If
the model didn't start, there's no charge.** Model work already done can still
use credit, even if the run could not finish.

Choose **Retry** to resend the same prompt. If you cancelled the run, send a new
prompt when you're ready.

## Its Computer

New Agents get a new [Computer](/concepts/computer/) by default. Choose **No
Computer** in Grove to create an Agent without one. It can still converse and
use its other permitted tools, but has no Computer files or commands.

Home is the Agent's default attached Computer. With exactly one attachment and
no recorded choice, Home adopts it once. A person can choose `/home <name>` in a
conversation; that choice applies to the Agent's next runs across its Sessions.
The model cannot change Home. Detaching Home does not select a replacement: file
tools are absent until a person chooses another attached Computer.

Hosted Agents with Home can use `read`, `list`, `glob`, `grep` and `apply_patch`
directly. They can also use an explicitly named Computer's files and commands.
You can open its files in Inkcap or run checks in Shed when you select that
Computer. Other Agents do not automatically share it. Sessions with this Agent
do share it, so coordinate tasks that edit the same files.

## Instructions and models

Tell the Agent what you want and how to check the result. Put task-specific
instructions in the conversation. The host supplies the Agent's background
instructions when a run starts.

The host supplies the model and available tools. A Session can override its
model where the host offers that choice. Saving a preference does not establish
provider readiness or fund the work. See [model keys](/models/your-own-key/) and
[billing](/account/billing/) for those separate steps.

## Good first requests

These prompts are illustrative. Their results depend on the model, permissions
and files available to the Agent.

- "Make a new folder called `plans` and write a checklist for moving house."
- "Read `notes/hello.md` and summarize it without changing the file."
- "Write a Node script that prints today's date, run it and show me the output."