# Usage

The Usage section gives you a complete overview of how your workspace is consuming resources based on your active plan.

Here you can track execution volume across all three usage pillars and monitor the structural limits of your workspace.

***

#### 🔹 Overview

Each workspace in Zaia has its own usage dashboard, displaying two main types of information:

* **Renewable limits (monthly)** → tied to execution consumption. Reset automatically at the start of each billing cycle.
* **Permanent limits (plan-based)** → tied to the structure of your workspace. Fixed until you upgrade your plan.

***

#### 🔄 Renewable Usage (Resets Monthly)

These metrics renew automatically at the start of each new billing cycle.

Renewable usage tracks the three main pillars of your plan:

* **External Executions** — interactions your agents have with real users across active channels (WhatsApp, Instagram, Widget, etc.)
* **Internal Test Usage** — interactions made through the Internal Chat, your private testing environment inside the platform
* **Vibe Agent Usage** — interactions with Vibe Agent to create, configure, or diagnose agents through natural language

When the monthly cycle resets, all three counters return to zero — allowing continuous operation.

⚠️ **Important:** If you reach your execution limit before the cycle resets, your agents will stop responding to users until the limit renews or your plan is upgraded.

***

#### 🏗️ Permanent Usage (Plan-Based Limits)

Some resources are structural — they are tied to your current plan and do not reset monthly.

These define how much your workspace can scale in data and organization:

* **Members** — team members with access to the workspace
* **Connections** — integrations with external services
* **Tables** and **Table rows** — structured data storage
* **Knowledge Bases** and **Knowledge Base characters** — content available to agents
* **Workflow concurrent executions** — parallel workflow runs
* **Rollback versions** — previous agent versions available for restore

These limits remain fixed until you upgrade your plan.

***

#### 🔍 Inspecting Execution Details per Agent

You can view how executions are consumed during conversations by inspecting an Agent's response.

To do this, open any ticket or conversation and click the credit counter in the top-right panel.

This will display:

* Total credits used in that response
* Execution time per step
* Tool calls and reasoning iterations with detailed logs

💡 **Tip:** This feature is especially useful for understanding which Agents consume more resources and optimizing prompt efficiency.

***

#### 🔌 Custom Providers

Custom Providers allow you to connect an Agent to your own LLM API key — such as OpenAI, Anthropic, Google Gemini, or others — instead of using Zaia's default model.

This affects **which model** the Agent uses, but does not impact execution limits or usage tracking in any way. All plan limits still apply normally.

***

#### ✅ Best Practices

* Check your Usage panel regularly to anticipate limit exhaustion before it affects live users
* Inspect Agent response logs to understand which Agents consume more resources
* Use Custom Providers for high-volume or specialized deployments
* Review your active plan under **Settings → Subscriptions** for upgrade options

***

⚠️ **Disclaimer:** This page explains how usage tracking works in Zaia. For current plan limits and details, always refer to the **Plans page inside the platform**.

***

#### ❓ Common Questions

**Q: Do renewable limits reset every month?** A: Yes. External executions, internal test usage, and Vibe Agent usage all reset at the start of each billing cycle.

**Q: Do permanent limits reset monthly?** A: No. Structural limits (Tables, Knowledge Bases, Members, etc.) are tied to your plan and remain fixed until you upgrade.

**Q: Can I continue using Agents after reaching my execution limit?** A: No. Once your execution limit is reached, agents stop responding until the limit resets at the next billing cycle or you upgrade your plan.

**Q: Are limits shared across workspaces?** A: No. Each workspace has its own independent usage tracking and limits.

**Q: Can I see which Agent uses more resources?** A: Yes — open the Inspect Response panel on any conversation to see a detailed breakdown per Agent action.

**Q: Does Vibe Agent usage count toward my external executions?** A: No. Vibe Agent usage is tracked separately as its own renewable metric.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zaia.app/settings/usage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.