# Agent crew setup

Setting up an Agent Crew in ZBrain Builder starts with defining the foundational details of your crew. You begin by naming the crew, selecting the orchestration framework, choosing the language model, and configuring access permissions. These initial settings establish the operational context and determine how the crew will run.

Once the basic details are set, you move on to defining the structure of the crew, starting with a supervisor agent and adding child agents beneath it. Each agent can be configured with tools, prompts, and external system connections. This structured approach ensures that tasks are clearly distributed and executed according to the defined logic.

#### **Step 1: Accessing Agent Crew in ZBrain Builder** <a href="#step-1-accessing-agent-crew-in-zbrain-builder" id="step-1-accessing-agent-crew-in-zbrain-builder"></a>

Before setting up an Agent Crew, follow these steps to reach the development interface:

1. **Access the platform dashboard:** Log in to ZBrain Builder and open the main dashboard.
2. **Navigate to the agents section:** From the top navigation, locate and click on the ‘Agents’ section.
3. **Initiate crew creation:** Click the 'Create New' button. A dropdown will appear with two options:
   * Create Agent
   * Create Agent Crew

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2F0Vv0XZH6gqcu9k0JV5PO%2Fimage.png?alt=media&#x26;token=912f0ca9-9bf8-41d0-a088-d82be5f0c0c2" alt=""><figcaption></figcaption></figure>

4. **Select ‘Create Agent Crew’:** Choose ‘Create Agent Crew’ to begin building a multi-agent system.\
   This opens the Agent Crew development interface, starting at the ‘Crew Overview’ step.

#### **Step 2: Provide crew details** <a href="#step-2-provide-crew-details" id="step-2-provide-crew-details"></a>

Agent Crew development begins at the ‘Crew Overview’ interface. In this step, you define the foundational details for your Agent Crew. This includes the crew's name, orchestration framework, model, and access control settings.

* **Crew name:** Provide a short, meaningful name for the crew. This is how it will appear throughout the platform. Example: Travel agent
* **Crew description (optional):** Use this field to describe the purpose of the crew. This helps collaborators understand their role.
* **Framework:** Select the orchestration framework for your Agent Crew. Supported options include LangGraph, Google ADK and Microsoft Semantic Kernel, and Microsoft Agent Framework.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FKaPHaPdFCVVTVf6RknGJ%2Fimage.png?alt=media&#x26;token=31f62f8b-60e8-4b02-9463-ddba7eaf9add" alt=""><figcaption></figcaption></figure>

* **Select memory scope**: Select one of three memory modes as defined below for the agent.

| Mode              | Behavior                                                      |
| ----------------- | ------------------------------------------------------------- |
| **No Memory**     | Treats every request as a fresh session; no data is retained. |
| **Crew Memory**   | Remembers context only within that agent’s own sessions.      |
| **Tenant Memory** | Shares context across every agent and session in the tenant.  |

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FzoZaokUZ0S9iFP7gGD77%2Fimage.png?alt=media&#x26;token=6639f7b0-7b10-4af1-b6c8-57c6333fb16b" alt=""><figcaption></figcaption></figure>

**Contextual memory for Agent Crews**

To maintain contextual continuity in Agent Crew interactions, enable agents to store and reference information from previous conversations. Turn on **Inference Mode** or **Last Conversation Mode** under Crew or Tenant Memory to ensure that follow-up interactions are grounded in previously captured context.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2F1ouIc4wl2GcJ9tx6k6bn%2Fimage.png?alt=media&#x26;token=c65e95bb-a7e0-49d8-b6f4-53738e776bc7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2Fym9aM0rfG5bwKAAYDaUF%2Fimage.png?alt=media&#x26;token=dc1773cf-af50-4299-8d8e-57f9d535ab95" alt=""><figcaption></figcaption></figure>

* **Inference Mode**

  Inference Mode controls how conversational data is processed and stored in memory.

  * **Disabled**: Raw conversation messages are stored without analysis or deduplication.
  * **Enabled**: The system automatically extracts structured facts from conversations, deduplicates existing information, and stores only relevant memory.

  When Inference Mode is enabled, the following settings become available:

  * **Threshold**: Defines the confidence level required for extracted facts to be stored or retrieved. Higher values restrict memory usage to highly relevant information.
  * **Limit**: Specifies the maximum number of memory entries used during inference.
  * **Instructions**: Allows you to define custom rules for memory extraction, including what information to include or ignore and how duplicates are handled. Instructions must reference **JSON** to enable structured extraction.

#### Last Conversation <a href="#last-conversation" id="last-conversation"></a>

Specify the number of recent conversations to retain for contextual reference.\
Maximum supported value: 50.

**Thought tracing**

* Enable the thought tracing toggle button to view each agent’s thought process on the dashboard.

<figure><img src="https://3781630280-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FIbuSicczDKTyHzwzicar%2Fuploads%2FQujn9XlkDng6IzNrHv5x%2Fimage.png?alt=media&#x26;token=6bb6c47d-f3d2-4ba0-b679-5f371bc35027" alt=""><figcaption></figcaption></figure>

* **Crew access type:** Define who can access the operator dashboard for this crew:
  * **Public Crew**: Anyone with the link can operate the crew.
  * **Private Crew**: Access is limited to invited operators.

After setting the foundational details for your Agent Crew, you can click ‘Next’ to continue configuring agents and defining the orchestration logic.
