emercai docs
de

Agent Settings

What are Agent Settings?

Agent Settings are the central place to configure everything about your AI agent: its personality, who has access to it, your subscription plan, and billing details.

You have six tabs: Persona, Contributors, API Keys, Plan, Billing, and Danger Zone. Each tab manages a distinct area — you can jump between them at any time without losing unsaved changes in other tabs.

How to Access

Open Agent Settings by clicking the agent name in the top dropdown and selecting Settings, or by navigating directly to #agent-settings in the dashboard URL.

Persona

The Persona tab defines your agent's identity — how it introduces itself, what it stands for, and how it communicates.

| Field | Description | |-------|-------------| | Agent Name | The name your agent uses when talking to users. This appears in the chat interface and in any greetings the agent sends. | | Organization | The company or brand the agent represents. Used to ground the agent's context — it knows who it works for. | | Website | Your organization's website URL. The agent can reference this when users ask where to find more information. | | Role | A short description of what the agent does. For example: Customer Support Assistant or Product Advisor. This shapes how the agent frames its answers. | | Communication Style | The tone and register the agent uses. Options typically range from formal to conversational. Choose what fits your audience. | | Principles | A set of guidelines the agent follows in every conversation. Use this to encode important rules: what the agent should always do, what it should never say, and any boundaries it must respect. |

Changes to the Persona apply to all new conversations. Existing ongoing conversations keep the settings they started with.

Contributors

The Contributors tab shows everyone who has access to this agent and lets you manage that access.

Roles

| Role | What they can do | |------|-----------------| | Editor | Full access — can change settings, update the persona, manage plugins, and invite or remove other members. | | Viewer | Read-only access — can view all settings but cannot make changes. |

Invite a Team Member

  1. Click Invite Member.
  2. Enter their email address.
  3. Select the role: Editor or Viewer.
  4. Click Send Invite.

The invited person receives an email with a magic link. When they click it, they are signed in and added to the agent automatically. The link expires after 24 hours — if they do not use it in time, send a new invitation.

Remove a Member

Click the options menu next to a team member's name and select Remove. They immediately lose access to the agent. If they have an active session, it will expire on the next page load.

You cannot remove yourself if you are the only Editor. Transfer Editor access to someone else first.

API Keys

The API Keys tab shows the key used to authenticate external integrations with this agent.

View Your Key

The current API key is displayed in a read-only field. Copy it using the copy button next to the field.

Keep your API key private. Anyone who has it can send requests to your agent on your behalf and count against your usage quota.

Regenerate a Key

If your key has been exposed or compromised:

  1. Click Regenerate Key.
  2. Confirm the action in the dialog.

A new key is generated immediately and the old one is invalidated. Any integration still using the old key will stop working — update all your integrations with the new key before regenerating.

Plan

The Plan tab shows your current subscription and what it includes.

Current Plan

Your active plan name is displayed at the top. Below it you can see the limits that apply:

  • Messages — how many AI messages are included per billing period
  • Tools — which built-in tools are available on your plan
  • Plugins — which add-on plugins you can activate

Available Tools and Plugins

The plan view lists all tools and plugins available in emercai, with your current plan's access level shown for each. Items not included in your plan show their price so you can evaluate an upgrade.

To change your plan, click Upgrade or Change Plan and follow the checkout flow.

Billing

The Billing tab shows a detailed breakdown of your current period's costs and lets you configure overage behavior.

Cost Breakdown

| Item | Description | |------|-------------| | Plan price | Your base subscription fee for the current billing period. | | Message usage | Charges for messages consumed beyond your plan's included quota. | | Assistant usage | Charges based on AI model usage (token consumption). | | Tool usage | Charges for calls to tools that are billed per use. | | Plugin costs | Monthly fees for any active add-on plugins. |

Overage Settings

When you exceed your plan's included limits, overages are charged at a per-unit rate. You can configure how overages are handled:

  • Allow overages — usage continues beyond the limit and you are billed for the extra.
  • Pause at limit — the agent stops responding when the limit is reached and resumes at the start of the next billing period.

Choose the option that fits your use case. For production agents that must stay available, allowing overages with a configured budget cap is the safer choice.

Credits

If you have credits on your account, they are applied automatically before any charges go to your payment method. Your current credits balance is shown at the top of the billing section.

Danger Zone

The Danger Zone tab contains irreversible actions that permanently affect your agent.

Delete Agent

Deleting an agent removes it and all its data permanently — settings, conversation history, plugins, and all associated configuration. This cannot be undone.

To delete:

  1. Click Delete Agent.
  2. Type the agent's name in the confirmation field to confirm you intend to delete it.
  3. Click Confirm Delete.

Before deleting, make sure any widgets or integrations using this agent are removed from your websites and applications. Embeds referencing a deleted agent will silently fail.

FAQ

Can I have multiple agents? Yes. Each agent has its own settings, team, plan, and billing. Switch between agents using the agent dropdown at the top of the dashboard.

Who can change the plan or billing settings? Only Editors can access plan and billing settings. Viewers see the plan tab but cannot make changes.

What happens if my API key is regenerated and I forget to update my integrations? Requests using the old key will be rejected with an authentication error. Update all integrations with the new key as soon as you regenerate.

Can I undo a persona change? Changes are saved when you click Save. If you have not saved yet, you can navigate away to discard changes. Once saved, there is no automatic version history — keep a copy of your previous settings if you want to revert.

What happens to active chats when I delete the agent? They are terminated. Users mid-conversation will see the chat become unavailable. There is no grace period.