Glossary
Definitions for all terminology used across Newo platform documentation.
| Term | Definition |
|---|---|
| Active Knowledge Base (AKB) | A per-agent vector database that stores documents, conversation history, work instructions, and scenarios for retrieval during agent execution. Supports both fuzzy (keyword) and semantic (embedding) search. See Active Knowledge Base in Core Concepts. |
| Actor | A communication endpoint — a specific combination of integration and connector that represents how a user interacts with an AI Employee. A user communicating via phone has a voice actor; the same user communicating via chat has a separate chat actor. See Actors, personas, and users in Core Concepts. |
| Agent | An AI Employee — the combination of flows, skills, event subscriptions, knowledge, and configuration that enables an AI to handle conversations on behalf of a business. Technically, each agent instance is a ConvoAgent deployment within the NAF. |
| API Integration | The api integration, which allows third-party applications to send requests to the platform via the Agent Creator App API or webhook endpoints. |
| ASR (Additional Secured Revenue) | A platform metric representing the estimated revenue generated by the AI Employee's sessions. Calculated from bookings, conversions, and platform-defined formulas. |
| Attribute | A named data field associated with a customer account (customer attribute), an individual user (persona attribute), or the agent itself (project attribute). See Attributes system in Core Concepts. |
| Broadcast | A feature that sends an outbound message to multiple personas simultaneously. Managed by CABroadcastConversationFlow. |
| Builder | The Newo.ai web application used to create, configure, and manage AI Employees — including flows, skills, event subscriptions, connectors, and knowledge bases. |
| CAMainFlow | The primary routing flow in ConvoAgent. Receives incoming events and dispatches them to the appropriate processing flow. |
| Connector | A configured instance of an integration. Where an integration defines the channel type (e.g., Twilio SMS), a connector is the specific account configuration with its own connector_idn. Multiple connectors can be created for the same integration. See Integrations and connectors in Core Concepts. |
| ConvoAgent | The primary user-facing agent type in NAF. Handles all end-user conversations, tool execution, RAG, scheduling, and session management. |
| CSS (Conversation Success Score) | A scoring metric that measures the quality and outcome of individual conversations. |
| Customer | A business account on the Newo platform. Each customer has its own AI Employee configuration, attributes, AKB, and session data. Not to be confused with the end user talking to the AI Employee. |
| Event | A platform signal that triggers skill execution. Events have an eventIdn, optional integrationIdn, optional connectorIdn, and carry a payload. See Events and the event system in Core Concepts. |
| Event Subscription | A configuration entry in a flow that maps an event (by eventIdn, integrationIdn, connectorIdn) to a handler skill. When the event fires, the subscribed skill executes. |
| FetchData | An NSL action that pulls dynamic data from external sources into the prompt context, used with CADataInjectionFlow. |
| Flow | The execution process an agent follows — a container for skills, state, event subscriptions, and persona configuration. See Flows in Core Concepts. |
| Gen / GenStream | NSL actions for LLM generation. Gen() is synchronous; GenStream() streams the output token-by-token. See Working with LLM generation. |
| GeneralManagerAgent | The system administration agent in NAF. Manages outbound calling, lead lists, and AKB configuration. |
| HTTP Integration | The http integration, which allows agents to make HTTP requests to external APIs via the send_request command. |
| idn | Short for identifier. A string key that uniquely identifies a platform object within its namespace (e.g., skill_idn, connector_idn, integration_idn). Follows snake_case naming convention. |
| Integration | A platform-level definition of a communication channel or external service type. Each integration has a fixed integrationIdn (e.g., twilio_messenger, program_timer). Connectors are instances of integrations. See Integrations and connectors in Core Concepts. |
| Interrupt Mode | A setting on event subscriptions that controls how an event is handled when the agent is already processing another event. Options: queue (wait), interrupt (preempt), cancel (drop). See Event subscription interrupt modes in Core Concepts. |
| LSS (Lead Success Score) | A metric that classifies whether a conversation resulted in a qualified lead or conversion outcome. |
| Magic API | An AI-driven orchestration layer (magic_api integration) that interprets natural language instructions to interact with external APIs. Sends magic_api_response events when complete. |
| Magic Browser | An AI agent (magic_browser integration) that performs automated web browser actions (searching, booking, form filling) based on natural language commands. Sends magic_browser_response events when complete. |
| ManyChat | A third-party messaging platform that routes social media messages (WhatsApp, Instagram, Facebook, Telegram, TikTok) to the Newo platform. |
| NAF (Newo Agent Framework) | The underlying framework that powers all AI Employees on the Newo platform. Consists of multiple specialized agents (ConvoAgent, GeneralManagerAgent, etc.) that coordinate to handle conversations. |
| Newo Chat | The newo_chat integration — a web chat widget that allows text or avatar-based conversations with an AI Employee. |
| Newo Voice | The newo_voice integration — Newo's native SIP-based voice system for telephone conversations. |
| NSL (Newo Script Language) | A Jinja2-based scripting language used to write skill scripts. Current standard format (.nsl files). See Skill scripts and the Newo Script Language in Core Concepts. |
| Observer | A parallel reasoning system that watches the conversation, analyzes business context and scenarios, and generates structured directives after each turn to guide the AI Employee's behavior. |
| OSS (Overall Session Score) | A composite scoring metric that summarizes session quality across multiple dimensions. |
| Persona | A per-user profile created when an actor first interacts with an AI Employee. Stores identity (name, phone, email), preferences, and session history. See Actors, personas, and users in Core Concepts. |
| Portal | The partner-facing web application for managing customer accounts, viewing sessions, configuring attributes, and accessing analytics. Accessible via the Portal API. |
| Program Timer | The program_timer integration used to schedule one-time and repeating timer events. |
| Project Attribute | An agent-level configuration attribute that controls the AI Employee's capabilities, tools, and behavior parameters. See Project attribute reference. |
| RAG (Retrieval-Augmented Generation) | A technique that enhances LLM responses by retrieving relevant documents from the AKB before generation. Managed by CARagFlow and CADataInjectionFlow. See Retrieval Augmented Generation in Core Concepts. |
| Sandbox | The built-in chat window in the Builder used for testing agents during development (sandbox integration). |
| Scenario | A structured document in the AKB that defines an expected conversation path. Used by the Observer to guide agent behavior. See Scenarios, procedures, and intent types in the Agent Framework Deep Dive. |
| SendCommand | An NSL action that sends a command to a connector (e.g., set_timer, send_message, magic_browser_command). See the SendCommand reference. |
| Skill | A discrete logic unit within a flow. Contains a skill script, parameters, result configuration, and event subscription bindings. See Skills in Core Concepts. |
| Skill Script | The NSL code that defines what a skill does when executed — reading attributes, calling actions, invoking LLM generation, and producing output. |
| State | A flow-scoped key-value store for exchanging data between skills within a single flow instance. Cleared at the end of each session. See State management in Core Concepts. |
| Supervisor (Tool Caller) | The CANewoToolCaller system that monitors conversation state for tool activation conditions and executes the appropriate tool when triggered. |
| Tool | A named capability registered in project attributes that the Supervisor activates when its trigger condition is met. Built-in tools include booking, transfer, email, SMS, and ZIP code check. |
| User | The unified identity that represents a person across multiple actors and personas. Created through the persona unification process when the same individual communicates via different channels. See Actors, personas, and users in Core Concepts. |
| V2V (Voice-to-Voice) | A real-time voice conversation architecture that uses a live speech model (e.g., GPT-4o Realtime) instead of the traditional STT → LLM → TTS pipeline. Supports Newo's backward prompting technique. |
| Webhook | An HTTP callback mechanism for sending or receiving event notifications between the Newo platform and external systems. |
| WebRTC | Web Real-Time Communication — the browser technology used by the Web Call Widget to establish live voice connections without requiring a phone number. |
Updated 2 days ago