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

# Already have an agent?

> Quick-reference maintenance guides for keeping your live agent running smoothly.

<img src="https://mintcdn.com/polyai/Qu880HppNqT19Eyr/images/learn/front-page-graphic-maintain.png?fit=max&auto=format&n=Qu880HppNqT19Eyr&q=85&s=1ae041ff4e2817db626b35f0b945738a" alt="Agent maintenance guide" style={{ display: 'block', margin: '0 auto', maxWidth: '1200px', width: '100%' }} width="1440" height="240" data-path="images/learn/front-page-graphic-maintain.png" />

Use this section when you have a live agent and need to make a targeted change — updating a topic, changing a voice, fixing a function, or adjusting a behavior. Each guide is scoped to a single task.

<Tip>
  **Drive most maintenance through [Studio Assistant](/studio-assistant/introduction) (Beta).** Project admins on enterprise clusters can ask Studio Assistant in natural language to update topics, tweak flows, rewrite welcome messages, or fix a behavior that surfaced on a real call. Every change lands on a branch you review before merging — see the [prompting guide](/studio-assistant/prompting) for patterns that work well. Access is **admin-only** during Beta — see [Role permissions](/user-management/access-control-scope).
</Tip>

## Quick decision guide

| I need to...                            | Go here                                                                      | Time       | Skill level     |
| --------------------------------------- | ---------------------------------------------------------------------------- | ---------- | --------------- |
| Describe a change in natural language   | [Studio Assistant](/studio-assistant/introduction)                           | 1-15 min   | No code         |
| Update FAQs or business info            | [FAQs](/learn/maintain/knowledge-base)                                       | 10-30 min  | No code         |
| Sync external sources (websites, files) | [Sources](/learn/maintain/knowledge-connected-knowledge)                     | 5-15 min   | No code         |
| Change voice or fix pronunciation       | [Voice and audio](/learn/maintain/voice-audio-updates)                       | 5-20 min   | No code         |
| Update or debug a function              | [Function maintenance](/learn/maintain/tool-maintenance)                     | 15-60 min  | Requires Python |
| Maintain multilingual agents            | [Multi-language updates](/learn/maintain/multi-language-updates)             | 30-90 min  | No code         |
| Check performance or fix issues         | [Performance monitoring](/learn/maintain/performance-monitoring)             | 30-120 min | No code         |
| Analyze conversations at scale          | [Smart Analyst](/smart-analyst/introduction) – deep sampling up to 500 calls | 5-10 min   | No code         |
| Publish or rollback changes             | [Version management](/learn/maintain/version-management)                     | 5-15 min   | No code         |
| Daily/weekly health checks              | [Health checks](/learn/maintain/health-checks)                               | 5-60 min   | No code         |

## Core maintenance tasks

<CardGroup cols={2}>
  <Card title="Studio Assistant" href="/studio-assistant/introduction" icon="wand-magic-sparkles">
    Describe the change you want in plain language — Studio Assistant edits topics, flows, entities, and settings on a branch you review. <span className="badge">Beta</span>
  </Card>

  <Card title="FAQs" href="/learn/maintain/knowledge-base" icon="book">
    Edit existing answers or add new topics to guide your agent's responses.
  </Card>

  <Card title="Sources" href="/learn/maintain/knowledge-connected-knowledge" icon="link">
    Sync and manage external sources like websites, files, and integrations.
  </Card>

  <Card title="Voice and audio" href="/learn/maintain/voice-audio-updates" icon="microphone">
    Update voice settings, fix pronunciations, and optimize audio quality.
  </Card>

  <div className="full-only">
    <Card title="Function maintenance" href="/learn/maintain/tool-maintenance" icon="code">
      Update code, debug errors, and manage API integrations. Requires Python familiarity.
    </Card>
  </div>

  <Card title="Multi-language updates" href="/learn/maintain/multi-language-updates" icon="globe">
    Maintain and optimize multilingual agent configurations.
  </Card>

  <Card title="Performance monitoring" href="/learn/maintain/performance-monitoring" icon="chart-line">
    Identify issues, track metrics, and improve agent performance.
  </Card>

  <Card title="Version management" href="/learn/maintain/version-management" icon="code-branch">
    Publish, promote, and rollback changes safely.
  </Card>

  <Card title="Health checks" href="/learn/maintain/health-checks" icon="heart-pulse">
    Daily, weekly, and monthly maintenance checklists.
  </Card>

  <Card title="Smart Analyst" href="/smart-analyst/introduction" icon="magnifying-glass-chart">
    AI-powered conversation analysis – deep sampling analyzes up to 500 calls per query to surface patterns and insights.
  </Card>
</CardGroup>

## Additional resources

<CardGroup cols={2}>
  <Card title="Routing and handoffs" href="/learn/maintain/routing-handoffs">
    Update phone numbers, SIP routing, or call transfer logic.
  </Card>

  <Card title="QA and analytics" href="/learn/maintain/qa-analytics">
    Listen to calls, assess quality, and review performance data.
  </Card>

  <Card title="Common issues" href="/learn/maintain/common-issues">
    Troubleshoot frequent problems and find quick solutions.
  </Card>

  <div className="full-only">
    <Card title="Alerts API" href="/api-reference/alerts/introduction" icon="bell">
      Set up automated alerts for latency, errors, and call volume.
    </Card>
  </div>
</CardGroup>

## Typical workflows

### Daily (5-10 minutes)

1. Check overnight metrics
2. Review recent calls
3. Verify critical functions
4. Address urgent issues

**See:** [Health checks](/learn/maintain/health-checks)

### Weekly (30-60 minutes)

1. **Run [Smart Analyst](/smart-analyst/introduction) deep sampling** to surface the week's trends and failure patterns across hundreds of conversations
2. Update FAQs content based on Smart Analyst insights
3. Sync Sources sources
4. Fix identified issues
5. Publish and promote changes

**See:** [Smart Analyst](/smart-analyst/introduction), [FAQs](/learn/maintain/knowledge-base), [Performance monitoring](/learn/maintain/performance-monitoring)

### Monthly (2-4 hours)

1. **Use [Smart Analyst](/smart-analyst/introduction) for a deep sampling review** – analyze containment blockers, handoff reasons, and sentiment trends across the full month
2. Optimize functions and performance
3. Update voice and audio settings
4. Address knowledge gaps identified by Smart Analyst
5. Test and validate improvements

**See:** [Smart Analyst](/smart-analyst/introduction), [Voice and audio](/learn/maintain/voice-audio-updates)

<Tip>
  When in doubt, use your [environments](/environments-and-versions/introduction) carefully. Make any changes in the **Sandbox**, test thoroughly, and only then promote up to **Live**.
</Tip>