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

# Agent Tasks

> Deploy AI agents directly on your own infrastructure

<Warning>
  **Early Preview.** Agent Tasks is available in early preview to a limited set of organizations. Capabilities and setup will change before general availability. Want early access? Reach out to us directly in the product (help button in the console, or your dedicated Slack channel).
</Warning>

## Overview

Agent Tasks let you delegate a job, investigating an incident, optimizing a build, or anything else you describe, to an AI agent running on your own Qovery-managed infrastructure. For how an agent is configured and what settings are available, see the [Configuration Reference](/docs/configuration/agent-tasks/overview).

## Why Run Agent Tasks in Qovery?

<CardGroup cols={2}>
  <Card title="Runs on Your Own Infrastructure" icon="server">
    The agent runs as a service on your Qovery-managed cluster, on your own cloud account, not on a third-party SaaS runner you don't control.
  </Card>

  <Card title="Same Guardrails as Everything Else" icon="shield-check">
    Scoped access via Policy API tokens, network boundaries from a domain allowlist controlling exactly what it can reach, resource limits, and execution timeouts, the same governance model as any other Qovery service.
  </Card>

  <Card title="Full Audit Trail" icon="list-check">
    Every run shows up under the agent task's Deployments tab, with logs, like any other deployment.
  </Card>

  <Card title="Isolated by Design" icon="clone">
    Clone Environment mode gives a run its own throwaway copy of the environment, so an agent investigating an incident or proposing a code change can't interfere with what's actually running in production.
  </Card>

  <Card title="Your Qovery Context, in One Click" icon="plug">
    Add Qovery services from your environment as context directly, alongside or instead of a Git repository, so the agent has the same view of your infrastructure you do.
  </Card>

  <Card title="Ready-Made Templates" icon="wand-magic-sparkles">
    Start from a template built for your use case, incident response, build optimization, or picking up tickets, and adjust it instead of starting from a blank prompt.
  </Card>
</CardGroup>

## Use Cases

Today there are a few ready-made agent configurations, or you can start from scratch and configure every part yourself. Don't hesitate to reach out to us directly in the product if you have a specific need so we can add it.

<CardGroup cols={2}>
  <Card title="Incident Analyzer with incident.io" icon="https://mintcdn.com/qovery/zvDXS1ZBmUu3fzzY/images/logos/incident-io-icon.svg?fit=max&auto=format&n=zvDXS1ZBmUu3fzzY&q=85&s=c3eb30b91f3a54626bef9b53495282cb" href="/docs/configuration/agent-tasks/incident-analyser" width="128" height="163" data-path="images/logos/incident-io-icon.svg">
    Correlates a firing incident.io incident with recent changes, logs, and metrics, then reports back to the on-call human and opens a PR if the fix is small and well-understood.
  </Card>

  <Card title="Incident Analyzer with Honeybadger" icon="https://mintcdn.com/qovery/zvDXS1ZBmUu3fzzY/images/logos/honeybadger-icon.svg?fit=max&auto=format&n=zvDXS1ZBmUu3fzzY&q=85&s=0530e4d318f9b5af4f94ef437a028875" href="/docs/configuration/agent-tasks/incident-analyser-honeybadger" width="65" height="64" data-path="images/logos/honeybadger-icon.svg">
    Same behavior, for teams using Honeybadger instead of incident.io.
  </Card>

  <Card title="Build & Deployment Optimizer" icon="gauge" href="/docs/configuration/agent-tasks/build-deployment-optimizer">
    Identifies build and deployment optimization levers and expected gain, opens a PR with the proposed change and/or modifies the build configuration in Qovery.
  </Card>

  <Card title="Jira Coding Agent" icon="https://mintcdn.com/qovery/zvDXS1ZBmUu3fzzY/images/logos/jira-icon.svg?fit=max&auto=format&n=zvDXS1ZBmUu3fzzY&q=85&s=2005a2fef2bc3e9faa8cae530fd4e8eb" href="/docs/configuration/agent-tasks/jira-coding-agent" width="24" height="24" data-path="images/logos/jira-icon.svg">
    Picks up a Jira issue and proposes the corresponding code change as a pull request.
  </Card>

  <Card title="Linear Coding Agent" icon="https://mintcdn.com/qovery/zvDXS1ZBmUu3fzzY/images/logos/linear-icon.svg?fit=max&auto=format&n=zvDXS1ZBmUu3fzzY&q=85&s=b001c71de10b74c31bee2f45cbd5557f" href="/docs/configuration/agent-tasks/linear-coding-agent" width="200" height="200" data-path="images/logos/linear-icon.svg">
    Picks up a Linear issue and proposes the corresponding code change as a pull request.
  </Card>

  <Card title="Start from Scratch" icon="plus" href="/docs/configuration/agent-tasks/overview">
    Configure every part of the agent yourself. Also the full configuration reference: creating an agent, execution mode, triggers and outputs, resources, governance, and environment variables.
  </Card>
</CardGroup>
