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

# Aliases

> Pin a stable name like `production` or `canary` to one or two agent versions

An **alias** is a named pointer to one or two agent [versions](/docs/gateway/agent-builder/versioning). Clients invoke the agent by alias — `my_agent@production` — and the alias decides which version actually runs. Repoint the alias and every client picks up the change on the next call.

<Frame>
  <img src="https://mintcdn.com/hastekit/890s5wy2NHvxQLSN/images/agent-builder/alias.png?fit=max&auto=format&n=890s5wy2NHvxQLSN&q=85&s=97c1ec632e787d55865cec7df0d09796" alt="Alias tab" width="3890" height="1652" data-path="images/agent-builder/alias.png" />
</Frame>

## Configuration

| Field          | Description                                                                                                     |
| -------------- | --------------------------------------------------------------------------------------------------------------- |
| **Alias Name** | Required, unique per agent. Example: `production`, `staging`, `canary`.                                         |
| **Version 1**  | Required. The primary version this alias maps to. Pick any numbered version or `$LATEST` (version 0).           |
| **Version 2**  | Optional. Add a second version to split traffic.                                                                |
| **Weight**     | Required when Version 2 is set. Percentage (0–100) of traffic routed to Version 2 — the rest goes to Version 1. |

## Single-version alias

Map a name to one immutable version. The most common pattern:

| Alias                | Points at | Used for                                |
| -------------------- | --------- | --------------------------------------- |
| `production`         | `v7`      | Whatever's serving real users right now |
| `staging`            | `v8`      | The build under QA                      |
| `$LATEST` (built-in) | `v0`      | Bleeding edge                           |

To ship a new version: build and test it as `v8`, then re-point `production` from `v7` to `v8`. To roll back: re-point `production` to `v7`. No client redeploy required.

## Dual-version alias (canary / A-B)

Setting both **Version 1** and **Version 2** with a **Weight** between them splits invocations between the two versions according to the weight. Useful for:

* **Canary releases** — `production` = 95% old / 5% new, ramped up if the new version performs well.
* **A/B experiments** — compare two prompt or model configurations on real traffic.

Traces tag each run with which version actually executed, so you can compare success rate, latency, and cost between the two.

## Same model for workflows

[Workflows](/docs/gateway/agent-builder/workflows) use the identical versioning + alias model — `pr_triage@production` works the same way.