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

# Agents

> Create, manage, publish, import, and restore AI voice agents.

An agent defines how Persistence handles a conversation. Choose the agent structure, configure its behavior, test the draft, and publish it when it is ready for live calls.

<Frame caption="The Agents workspace summarizes status, assigned numbers, call volume, duration, cost, and goal performance.">
  <img src="https://mintcdn.com/persistence-ai/vTPO-R7syJyo2N_1/images/dashboard/agents.png?fit=max&auto=format&n=vTPO-R7syJyo2N_1&q=85&s=15d040e2d3939ffdd70172a1aa573ee9" alt="Persistence Agents dashboard showing live and draft agents with operational metrics" width="640" height="360" data-path="images/dashboard/agents.png" />
</Frame>

## Choose an agent structure

<Columns cols={2}>
  <Card title="Single Prompt" icon="message-square-text" href="/build/single-prompt">
    Use one instruction set for flexible conversations that do not require a fixed sequence.
  </Card>

  <Card title="Conversation Flow" icon="git-branch" href="/build/conversation-flow">
    Build a visual flow with explicit conversation, condition, action, transfer, and end nodes.
  </Card>
</Columns>

## Create an agent

<Steps>
  <Step title="Open Agents">
    In the dashboard, open **Agents** and select **Create Agent**.
  </Step>

  <Step title="Choose the structure">
    Select **Single Prompt** or **Conversation Flow**.
  </Step>

  <Step title="Choose a template and use case">
    Start from a template that matches the conversation you want to automate. Review the proposed configuration before creating the agent.
  </Step>

  <Step title="Name the agent">
    Use a name that identifies the workflow, describe its main goal, and optionally provide a public website whose content can help personalize the draft. Enable **Chat only** when the workflow should use text without audio processing.
  </Step>
</Steps>

## Drafts and live versions

Changes are made to a draft. Test that draft before you publish it. Publishing promotes the current configuration for live calls while preserving earlier versions in the version timeline.

You can inspect an earlier version and restore it into a new draft when you need to roll back a change. Superseded versions are read-only.

## Import and export

The **Agents** page supports importing a `.pa` agent package up to 2 MB. An agent can also be exported from its actions menu by selecting a version. Use import and export to move a supported agent configuration without recreating it manually.

## Share an agent preview

Save an agent version, select **Share**, and choose an expiry of 1, 3, 7, or 15 days. A generated link can be opened up to 20 times and is copied to your clipboard.

The recipient can try the shared version without receiving workspace access. Treat the link as access to an agent test: do not configure the shared version to expose secrets, production customer data, or privileged actions.

## Discover reusable agents

Use **Marketplace** to browse agents by job, industry, language, and outcome. Review an agent profile, listen to its sample conversation, inspect its capabilities and integrations, and configure a copy for your workspace.

<Frame caption="Marketplace supports role and industry discovery before an agent is added to the workspace.">
  <img src="https://mintcdn.com/persistence-ai/vTPO-R7syJyo2N_1/images/dashboard/agent-marketplace.png?fit=max&auto=format&n=vTPO-R7syJyo2N_1&q=85&s=9668de2f4e8f3a1d68f256c01eef6a69" alt="Persistence agent Marketplace with use-case filters and configurable agent cards" width="640" height="360" data-path="images/dashboard/agent-marketplace.png" />
</Frame>

<Frame caption="An agent profile brings performance, fit, integrations, and sample-call controls together before configuration.">
  <img src="https://mintcdn.com/persistence-ai/vTPO-R7syJyo2N_1/images/dashboard/agent-profile.png?fit=max&auto=format&n=vTPO-R7syJyo2N_1&q=85&s=9bdd77174b976ca8b2c5f7a96de97b84" alt="Persistence Marketplace agent profile with performance and use-case information" width="640" height="360" data-path="images/dashboard/agent-profile.png" />
</Frame>

<Warning>
  Before deleting an agent, remove it from phone numbers and active or scheduled campaigns. Persistence blocks deletion while those assignments exist.
</Warning>

## Next steps

<Columns cols={2}>
  <Card title="Configure agent settings" icon="sliders-horizontal" href="/build/agent-settings">
    Set the voice, call behavior, transcription, data, and security controls.
  </Card>

  <Card title="Test a draft" icon="play" href="/test/web-preview">
    Start a browser-based voice preview before publishing.
  </Card>
</Columns>