> ## Documentation Index
> Fetch the complete documentation index at: https://docs.guild.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agents

> Install pre-built agents or build your own with the Agent SDK.

Agents are programs that accept input, use tools and LLMs, and produce output. They range from simple prompt-driven assistants to deterministic TypeScript workflows.

There are two ways to get agents into your workspace:

## Install from the Agent Hub

The Agent Hub contains pre-built agents ready to use. Browse available agents from your workspace, install one, and start a session. No code required.

1. Open your workspace at [app.guild.ai](https://app.guild.ai)
2. Go to **Agents** and click **Add agent**
3. Browse available agents, select one, and install it

The Browse tab shows the organization's complete agent inventory—public, internal, and draft agents alike. State badges (**public**, **internal**, **draft**) indicate each agent's visibility.

<Note>
  Agent descriptions shown in the user interface are generated automatically by AI. Guild displays these AI-generated descriptions in place of the static descriptions provided by an agent's developer.
</Note>

Installed agents are available to everyone in the workspace and can be run manually or via [triggers](/platform/triggers).

## Publish to the Agent Hub

To share an agent with your organization (so others can install it), publish a validated version from the CLI.

See [Publish to the Agent Hub](/platform/publish-to-agent-hub).

## Build your own

Use the [Agent SDK](/guide/sdk-introduction) to build custom agents tailored to your team's workflows. The SDK supports three agent types:

<CardGroup cols={1}>
  <Card title="LLM agents" icon="brain" href="/guide/llm-agents">
    Pair a system prompt with tools. The LLM decides how to accomplish the task. The simplest way to build an agent.
  </Card>

  <Card title="Auto-managed state agents" icon="code" href="/guide/coded-agents">
    Write deterministic TypeScript with automatic state management. Best for algorithmic, cost-predictable workflows.
  </Card>

  <Card title="Self-managed state agents" icon="gear" href="/guide/self-managed-agents">
    Event-driven state machines with parallel tool calls and explicit state control. Most flexible, but more complex.
  </Card>
</CardGroup>

The [quickstart](/quickstart) walks through building and publishing your first agent in five minutes.

## Find agents with the command palette

Use the command palette to quickly search for and navigate to an agent. Press `Cmd+K` (macOS) or `Ctrl+K` (Windows and Linux) to open the palette, type or select `agents`, then press `Tab` to enter the agents scope. Search agents in your selected account or organization by name or owner name, and select a result to open it.

## Archiving metadata

Agents include two optional fields that record archiving history.

| Field            | Type               | Description                                              |
| ---------------- | ------------------ | -------------------------------------------------------- |
| `archived_at`    | `datetime \| None` | Timezone-aware timestamp of when the agent was archived. |
| `archived_by_id` | `UUID \| None`     | UUID of the user who archived the agent.                 |