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

# Set up your organization

> Create the organization, bring people in, give them roles and groups, share a first agent and knowledge base, and set name, logo and spend limits.

You will set up "Northwind Ltd." with its name and logo, bring your colleagues in, and give an "HR" group one agent and one knowledge base, within a spend limit you choose.

> [!NOTE]
>
> **Time:** about 30 minutes · **Role:** Admin · **Works on:** Enterprise and SaaS. On SaaS this needs a Business organization; a personal Free or Pro account has no people, groups or sharing. · **You need:** on Enterprise, the Admin app role for Neural Factory in Microsoft Entra ID, and an IT team that assigns your colleagues to the app; on SaaS, a card to pay for the Business plan and your colleagues' email addresses

<video controls preload="metadata" poster="/videos/set-up-your-organization.jpg" src="https://mintcdn.com/neuralfactory/y-MI7aIFykaw0cY2/videos/set-up-your-organization.mp4?fit=max&auto=format&n=y-MI7aIFykaw0cY2&q=85&s=f20e8df3cb5e10a572e1cf7ea3e5ed49" />

Watch: Set up your organization, on SaaS (1 min 29 s)

## What you will have at the end

* An organization with your name and logo, and your colleagues in it with the right roles.
* An "HR" group that can use one agent and one knowledge base.
* A limit on what the organization spends.

## 1. Create the organization

> [tab] Enterprise
>
> An installation holds one organization. If someone already created it, skip to stage 2.
>
> **1. Sign in as the first Admin**
>
> Click **Continue with Microsoft Entra ID** and sign in with your work account. The page says **Welcome to Neural Factory** and **Let's set up your organization**.
>
> **2. Name it**
>
> Enter the **Organization Name**. You can add an **Organization Logo** (an image of up to 5 MB) now or later.
>
> **3. Create it**
>
> Click **Create Organization**. It starts with a ready-to-use agent named **General**.

> [tab] SaaS
>
> A Business organization is created when its first Admin pays for the Business plan. You become that Admin.
>
> * **New account**: on the sign-in page, click **Create one**, choose **Business**, set the number of seats (2 to 100), enter the **Organization name** and, if you like, a **Logo (optional)**. Enter your **Email** and **Password**, click **Go to Checkout** and pay, then verify your email.
> * **Existing personal account**: go to **Settings** › **Subscription** and click **Create a Business organization** on the Business card. Enter the **Organization name**, the **Seats** and **Monthly** or **Yearly**, then click **Pay € … and create**. Your personal plan ends and your agents and other resources move into the organization.

> [!TIP]
>
> Under **Settings**, the **Organization** group lists **General** and **Users & groups**.

## 2. Bring people in

> [tab] Enterprise
>
> There is no invite button. Your IT team assigns people, or a Microsoft group, to the Neural Factory app in Microsoft Entra ID. The app role sets their starting role: Admin becomes **Admin**, Member or User becomes **Member**, anything else **Viewer**.
>
> **1. Open Users & groups**
>
> Click **Settings** at the bottom of the sidebar, then **Users & groups**.
>
> **2. Sync**
>
> On the **Users** tab, click **Sync from Entra ID**. Everyone assigned to the app who has no account yet is added and marked **Pending sign-in** until they first sign in.
>
> People who sign in with Microsoft before a sync are added at that first sign-in.

> [tab] SaaS
>
> Each person needs a free seat. To add seats, go to **Settings** › **Subscription**, type the number in **New Seat Count** and click **Update Seats**. New seats are charged at once for the rest of the period, and the person in a new seat gets the seat's full included usage.
>
> **1. Open Users & groups**
>
> Click **Settings** at the bottom of the sidebar, then **Users & groups**.
>
> **2. Invite**
>
> On the **Users** tab, click **Invite User**. Enter the **Email**, pick the **Role** (**Admin** or **Member**) and click **Send Invitation**.
>
> A new address gets an email with a link to create a password, valid for 24 hours, and is listed on the **Users** tab at once, with **Last login** **Never**. Someone who already has an account is asked to **Accept** or **Decline** at their next sign-in; until they answer, their invitation waits under **Pending invitations** below the list, for 7 days.

![The Users tab of Users & groups, listing four people with their email, role, client, last login and groups, and the Invite User button at the top right.](https://mintcdn.com/neuralfactory/y-MI7aIFykaw0cY2/images/app/settings-users.png?fit=max\&auto=format\&n=y-MI7aIFykaw0cY2\&q=85\&s=50d492257fdbdbfce3ebdd87c053ce37)

> [!TIP]
>
> Your colleagues are listed on the **Users** tab.

## 3. Set roles

**1. Open Edit User**

Click ⋯ on a person's row and choose **Edit User**.

**2. Pick the role**

Choose **Admin** or **Member**, or on Enterprise also **Viewer** (Viewers only talk to the agents shared with them). Click **Save Changes**.

You cannot change your own role, and the organization always keeps at least one Admin. [Users and roles](https://docs.neuralfactory.ai/user-guide/concepts/users-and-roles.md) lists what each role may do.

> [!TIP]
>
> The **Role** column shows the new role.

## 4. Create a group

**1. Create it**

On the **Groups** tab, click **Create Group**. Enter "HR" as the **Group Name**, add a **Description** if you like, and click **Create Group**.

**2. Add people**

Click ⋯ on the group's row and choose **Add Members**. Search with **Search users...**, tick the people and click the **Add … Users** button.

Groups are managed only here, on both deployment types. Microsoft groups are not imported.

> [!TIP]
>
> The "HR" row shows the number of people under **Members**.

## 5. Share a first agent and knowledge base

A new agent or knowledge base is private: only its creator and the Admins can use it. Share each with the group. (The **General** agent an Enterprise organization starts with is public, so everyone can already use it.)

**1. Share the agent**

Go to **Agents** and open an agent you built, for example with [Build your first agent](https://docs.neuralfactory.ai/user-guide/guides/first-agent.md). Click **Edit** on **Who can use it**, keep **Private**, add "HR" under **Grant Access to Groups**, and click **Save changes**. Then click **Publish**: the new sharing applies once you publish.

**2. Share the knowledge base**

Go to **Knowledge bases**, open the row's actions menu and click **Edit**. In **Access Control**, keep the private **Visibility**, add "HR" under **Grant Access to Groups**, and click **Save Changes**.

An agent searches its knowledge bases for everyone who may use the agent, whether or not they can open those knowledge bases themselves. Share an agent only with people who may read what it knows.

> [!TIP]
>
> A colleague in "HR" finds the agent in the worker selector on **New task**. A Member in the group also finds the knowledge base under **Knowledge bases** (Viewers have no such page).

## 6. Set the name and logo

**1. Open General**

Click **Settings**, then **General** under **Organization**.

**2. Change them**

Edit **Organisation name** (up to 80 characters). Under **Logo**, click **Upload** and choose an SVG or PNG file of 512 KB or less. Click **Save** at the top right.

> [!TIP]
>
> Your logo is at the top of the sidebar for everyone, and the user card at the bottom reads `Org:` followed by the name.

## 7. Look at usage and set spend limits

**Settings** › **Usage** shows what was spent. As an Admin you also see **Usage by User**, one row per person.

> [tab] Enterprise
>
> Go to **Settings** › **Spend limits**. In **Usage Budget Limits**, all per calendar month:
>
> * **Organization Budget Limit**: the most the organization may spend. `0` means no organization budget.
> * **Default Per-User Budget Limit**: the limit each new person gets.
>
> Click **Save limits**. To set one person's limit, find them in **User Budget Limits**, click the pencil on their row, type the amount and press Enter. `0` stops that person from spending.

> [tab] SaaS
>
> Each member uses their own seat's included usage first, then the organization's top-ups. A top-up limit holds how much of the top-ups one member may use per period.
>
> Go to **Settings** › **Spend limits**. In **Top-ups and top-up limits**, enter a **Default top-up limit per member** (empty means no limit) and click **Save limits**. To set one member's limit, click the pencil on their row in **Top-up limit per member**, type the amount and press Enter. To buy top-ups, type an amount under **Buy more (minimum €20)** and click **Buy a top-up**.
>
> An organization on a contract or demo cannot buy top-ups. Its card is **Budget and on-demand limits**, and you give members a **Budget limit** and an **On-demand limit** instead. See [Spend limits](https://docs.neuralfactory.ai/user-guide/settings/spend-limits.md).

> [!TIP]
>
> The table on **Spend limits** shows each person's spend (**Current Spend** on Enterprise, **Top-up used** on SaaS) beside the limit you set.

## If something goes wrong

* **Enterprise**: colleagues see **Organization Setup Required**. No organization exists yet. Once an Admin creates it, their page lets them in by itself.
* **Enterprise**: **Sync from Entra ID** adds nobody. Everyone assigned already has an account, or the person is not assigned to the app yet. Ask your IT team to assign them in Entra ID.
* **SaaS**: an invitation is refused. All seats are taken (add one on **Subscription**), the address belongs to someone already in another organization, or the organization is frozen.
* You see "The organization must keep at least one Admin. Make someone else an Admin first." Promote someone before you demote the last Admin.

A logo of another type is refused with "Use an SVG or PNG file.", a larger one with "The logo must be 512 KB or smaller." More in [Help](https://docs.neuralfactory.ai/help/index.md).

## Where to go next

* [Users & groups](https://docs.neuralfactory.ai/user-guide/admin/user-management.md): everything on that page, including removing people.
* [Groups](https://docs.neuralfactory.ai/user-guide/concepts/groups.md): where groups are used.
* [Review what your agents did](https://docs.neuralfactory.ai/user-guide/guides/review-agent-activity.md): see what people asked and what it cost.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.