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

# AI Agents

> An AI Agent is a running instance of an approved AI Use Case — the unit that Access Keys and Policy Sets are scoped against.

An AI Agent represents a specific application or feature that calls an LLM. Agents inherit their provider, permitted models, and default prompt from the **AI Use Case** they're created from, so you can't stand up an agent against an unapproved provider or model.

<Frame caption="An AI Agent's detail page, showing its governing Use Case, AI Provider, linked Prompt, and Active Model">
  <img src="https://mintcdn.com/gegentic/2ZgCcfWNXcGMAVt9/images/gegentic-agent-detail.jpg?fit=max&auto=format&n=2ZgCcfWNXcGMAVt9&q=85&s=eb249db6de27a6a6ded3520d2fd6ac4e" style={{ borderRadius: '0.5rem' }} width="2982" height="1392" data-path="images/gegentic-agent-detail.jpg" />
</Frame>

## Fields

* **AI Agent Name** (required, minimum 2 characters)
* **Description** (optional)
* **Approved Use Case** (required) — provider, models, and prompt are inherited from the selected use case
* **Model** (optional override) — choose a different model from the use case's permitted list
* **Prompt** (optional override)
* **Policy Set** (optional) — the [Policy Set](/governance/policy-sets) enforced on this agent's traffic

Swapping the model on an existing agent requires a short **Reason for Change**, which is recorded in the agent's activity log.

## Status

Agents can be toggled **Active** or **Inactive**. Inactive agents reject requests even if a valid [Access Key](/governance/access-keys) is scoped to them.

## How Access Keys relate to Agents

[Access Keys](/governance/access-keys) are scoped to either all agents in a project or a specific subset. A client application authenticates with an Access Key, and Gegentic resolves which agent (and therefore which provider, model, and Policy Set) the request should be routed through based on that scope.
