Usage

Monitor your workspace resource consumption and plan limits

The Usage section provides a complete overview of how your workspace is consuming resources based on your active plan. Here, you can track AI credits, message volume, and see your structural limits for Tables and Knowledge Bases.


🔹 Overview

Each workspace in Zaia Endless has its own usage dashboard. It displays two main types of information:

  1. Renewable limits (monthly) → related to credits and message consumption.

  2. Permanent limits (plan-based) → related to the structure of your workspace (Tables and Knowledge Bases).


🔹 Renewable Usage (Resets Monthly)

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

Metric
Description

Credits

The total amount of AI processing credits available when using Zaia’s built-in LLM providers (GPT, Claude, Gemini, etc.). Each message, tool call, or reasoning step consumes a portion of your credits.

Messages

Total number of user and system messages processed during the billing period. Helps you monitor chat and API interaction volume.

When the monthly cycle resets, credits and message counts return to zero — allowing continuous operation.

💡 Tip: If your credits run out before renewal, you can still use your Agents with a Custom Provider (your own API key). However, message limits remain tied to your active plan.


🔹 Permanent Usage (Plan-Based Limits)

Some resources are structural, meaning they are tied to your current plan and do not reset monthly. These define how much your workspace can scale in data storage and organization.

Limit
Description

Tables (Datagrids)

The total number of Tables you can create in your workspace.

Rows per Table

The maximum number of rows allowed in each individual Table.

Knowledge Bases

The total number of Knowledge Bases that can exist in your workspace.

Blocks in Knowledge Bases

The maximum number of text or document blocks stored across all your bases.

These limits remain fixed until you upgrade your plan.


🔹 Inspecting Credit Consumption per Agent

You can view how credits are used during conversations by inspecting an Agent’s response. To do this, open any ticket or conversation and click the credit counter (top-right panel).

This will display:

  • Total credits used in that response.

  • Execution time per step.

  • Tool calls and reasoning iterations with detailed logs.

For example:

  • Total consumption: 294 credits

  • Each Agent iteration shows:

    • Time taken in seconds.

    • Credits consumed.

    • Type of process (reasoning, tool call, etc.).

💡 This feature is especially useful for understanding which Agents consume more credits and optimizing prompt efficiency.


🔹 Custom Providers

When you reach your Zaia credit limit, Agents can continue functioning if you connect them to a Custom LLM Provider, such as:

  • OpenAI (API Key),

  • Anthropic,

  • Google Gemini, or others.

Custom Providers bypass the Zaia credit system but still obey:

  • The workspace’s message cap, and

  • The plan’s data structure limits (Tables, Knowledge Bases, etc.).


🔹 Best Practices

  • Check your Usage panel weekly to anticipate credit or message exhaustion.

  • Inspect Agent logs regularly to understand LLM consumption.

  • Use Custom Providers for high-volume or specialized tasks.

  • Delete unused Tables or Knowledge Bases to stay within limits.

  • Review your active plan under Settings → Subscriptions for upgrade options.


🔹 Common Questions

Q: Do credits reset every month? A: Yes. Credits are renewed at the start of each billing cycle.

Q: Do Table and Knowledge limits reset monthly? A: No. These are tied to your plan’s structural limits and remain fixed until you upgrade.

Q: Can I continue using Agents after my credits end? A: Yes, if you set a Custom Provider for that Agent.

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

Q: Can I see which Agent uses more credits? A: Yes, open the Inspect Response panel to see the credit breakdown per Agent action.

Last updated