Skip to main content

Concepts

Basic Concepts​

This section covers Noema AI’s key concepts and terminology.

Organization

In Noema AI, the organization is the top-level entity where your users, assistants, workflows, and data sources live.

  • API keys and settings are scoped to your organization.
  • Access and permissions are typically managed at the organization level.

Assistant

An assistant is your chat experience: a conversational AI agent that can interact with users, use tools, and access data from configured sources.

Assistants can be created and configured through the Noema AI platform or using the REST API.

Workflow

In Noema AI, a workflow is an automated process that runs a sequence of steps to produce an output.

In the web app, workflows are currently accessible under:

  • /workflows-task (workflow list)
  • /workflows-task/<workflow-id> (builder)

Workflows are different from assistants:

  • Workflows run as executions (run → status → results).
  • Assistants run as conversations (chat → iterate → refine).

They work best together when you run a workflow and then continue into assistant chat.

Data Source

A data source is a connection to external platforms and systems (such as SharePoint, databases, or file storage) that provides information to your assistants and workflows.

preset-editor

Platform Components​

Now that you are familiar with the basic concepts of Noema AI, let's explore how the different components work together. The key components are the Web Platform, REST API, and various integrations.

Noema AI Platform​

The Noema AI platform (app.noema.ai) is your central hub for managing AI assistants, workflows, data sources, and analytics. This is where you can:

  • Create and configure AI assistants
  • Design multi-agent workflows using the visual builder
  • Connect to data sources
  • Monitor performance and analytics
  • Manage settings and permissions

Analytics / dashboard​

Workflow analytics are available in the app’s dashboard (for users with the right permissions). If you click the dashboard and see no data, it’s often because:

  • You don’t have permission to view the dashboard.
  • There are no workflow runs in the environment yet.

See: Workflow dashboard analytics

How assistants and workflows connect​

  • Link a workflow to an assistant to continue runs into chat
  • Use assistant chat to refine or troubleshoot workflow outputs

See: Assistant integration for workflows

REST API​

The REST APIs enable your applications to programmatically interact with Noema AI services. You can create assistants, execute workflows, manage data sources, and integrate AI capabilities into your existing systems.

Integrations​

Noema AI integrates with popular platforms and tools, allowing you to connect your existing data sources and workflows (for example: SharePoint, databases, and file storage systems).