# Creating an enterprise context in ZBrain Builder

ZBrain Builder is the control plane where the enterprise context for ZSearch is created and managed. Creating an enterprise context defines the scope of organizational knowledge that ZSearch can securely access, index, and make searchable.

An enterprise context establishes the boundaries within which ZSearch operates. It determines which data sources are included, how content is organized into knowledge bases, how frequently data is synchronized, and how access permissions are enforced across search and collaboration workflows.

Without an enterprise context, ZSearch cannot deliver accurate, secure, or contextually relevant results.

#### What is an enterprise context? <a href="#what-is-an-enterprise-context" id="what-is-an-enterprise-context"></a>

An enterprise context is a structured, permission-aware view of organizational knowledge. It is composed of one or more knowledge bases created from connected data sources or uploaded files.

Each enterprise context defines:

* The approved sources of knowledge available for search
* The structure in which content is indexed and stored
* The access controls that govern who can view and use specific content

ZSearch relies entirely on this context to power enterprise search, semantic understanding, and AI-assisted workflows.

#### What happens when you create an enterprise context <a href="#what-happens-when-you-create-an-enterprise-context" id="what-happens-when-you-create-an-enterprise-context"></a>

When an enterprise context is created in ZBrain Builder, several background processes are initiated:

* Knowledge bases are created for each connected data source or uploaded file set
* Content and associated permission metadata are ingested
* Indexing is initiated to make content searchable
* Synchronization rules are established to keep data current

These processes ensure that enterprise knowledge is searchable, continuously updated, and aligned with existing access controls before it becomes available in ZSearch.

#### Ways to build an enterprise context <a href="#ways-to-build-an-enterprise-context" id="ways-to-build-an-enterprise-context"></a>

ZBrain Builder supports multiple approaches to defining enterprise context, allowing organizations to onboard knowledge in a way that fits their needs:

* **Connecting enterprise data sources** using secure connectors to systems such as Google Drive, SharePoint, or other repositories
* **Uploading files directly** to create knowledge bases for testing, evaluation, or targeted use cases
* **Combining multiple sources** into a unified enterprise context while preserving source-level permissions

Regardless of the method used, all content follows the same lifecycle for ingestion, indexing, and access enforcement.

#### Enterprise context lifecycle <a href="#enterprise-context-lifecycle" id="enterprise-context-lifecycle"></a>

Enterprise context is not static. Once created, it is continuously maintained by ZBrain Builder:

* New and updated content is automatically synchronized
* Indexes are refreshed to reflect the latest state of knowledge
* Permission changes in source systems are respected and enforced

This ensures that ZSearch always operates on current, accurate, and authorized enterprise information.

#### How enterprise context is used by ZSearch <a href="#how-enterprise-context-is-used-by-zsearch" id="how-enterprise-context-is-used-by-zsearch"></a>

The enterprise context created in ZBrain Builder becomes the operational foundation for ZSearch. It enables:

* Secure, permission-aware enterprise search
* Semantic and natural language query understanding
* Project-based workflows using curated sets of documents
* AI-generated answers grounded in enterprise-approved content

All search results, projects, and AI interactions in ZSearch are constrained by the enterprise context defined in Builder.

The following sections provide detailed guidance on each part of the enterprise context setup process:

* Adding a data source using connectors
* Uploading files to build a knowledge base
* How indexing works for search
* Syncing and updating a knowledge base


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zbrain.ai/zbrain-documentation/zbrain-zsearch/enterprise-context-set-up-in-zsearch/creating-an-enterprise-context-in-zbrain-builder.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.