# Core concepts

> The building blocks of AgentMySite, including sites, allowed domains, content, credits, conversations, support handoff and AgentActions.

Source: https://agentmysite.com/docs/get-started/concepts/

This page explains the terms you meet across the admin panel and these docs.

## Account

Your account is the email address you sign in with. AgentMySite uses one-time codes instead of passwords. Your plan and your credits belong to the account, not to a single site.

## Site

A site is one assistant with its own content, appearance, conversations and embed snippet. You create your first site when you sign up.

Each site has a **site key**, a public identifier that starts with `ed_`. The key is part of your embed snippet. It's safe to put in your page's HTML because the widget only starts on your allowed domains.

Plans differ in how many sites they include. See [Credits and billing](/docs/guides/credits-and-billing/#plans). The admin panel sets up your first site when you sign up.

## Allowed domains

Allowed domains are the hostnames the widget may run on, such as `www.acme.com`. When the widget starts, AgentMySite checks the hostname of the page it runs on. If the hostname isn't in your list, the widget doesn't appear.

- Enter hostnames only. Schemes (`https://`), paths, ports and wildcards (`*.acme.com`) aren't accepted.
- Ports are ignored when the check runs, so `localhost` covers `http://localhost:3000` and any other port.
- `www.acme.com` and `acme.com` are different hostnames. Add each one your site uses.

You manage the list in **Site Settings** > **Allowed domains**.

## Content

Content is what the assistant answers from. You can:

- **Upload documents**: PDF, DOCX, Markdown (`.md`) and plain text (`.txt`) files up to 100 MB each.
- **Add web pages**: one page at a time by URL, or many pages at once from your sitemap.

AgentMySite splits each item into short passages called **chunks** and indexes them for search. An item moves through these statuses: **Queued**, **Processing**, then **Ready** or **Failed**. Only **Ready** content is used in answers.

## Grounded answers

When a visitor asks a question, the assistant searches your site's content for the most relevant chunks and writes an answer from them. If nothing relevant is found, it replies honestly that it can't help with that question, and the question appears on the **Unanswered** page. It doesn't make up an answer.

Visitors can ask in their own language. The assistant searches your content and replies in the visitor's language.

## Widget

The widget is the chat window on your site. It's made of a small loader script, which you paste as the embed snippet, and a chat window that opens in a secure frame. Its name, colours and welcome text come from your **Appearance** settings each time it starts, so you never need to change the snippet to restyle it.

## Credits

Credits measure usage. Each AI reply your visitors receive uses 1 credit. Each action the assistant takes adds 1 credit. All sites in your account share one monthly pool. When the pool is used up, the assistant pauses until the next period. See [Credits and billing](/docs/guides/credits-and-billing/).

## Conversations

A conversation is one visitor's chat with the assistant. You can read every conversation in **Conversations**, including the sources each answer used. Turn on **Show unanswered only** to find questions the assistant couldn't answer.

![The Conversations page listing three conversations, one marked Unanswered](../../../assets/screenshots/conversations.png)

## Support handoff

If you connect a helpdesk on the **Integrations** page, the assistant can offer to pass a visitor to your team when it can't help. It creates a ticket in your helpdesk and shows the visitor its status. Clokio is the helpdesk available today. See [Integrations](/docs/integrations/#clokio).

## AgentActions

AgentActions, or tools, let the assistant do things on your site, such as look up an order. You define them on the **Tools** page and handle them in your site's code. They're available on paid plans. See [AgentActions](/docs/developers/agentactions/).