public_documentation-using_specialists

**Ask Eve AI Specialists** are modular AI agents designed for seamless integration into websites, portals, or applications, enabling context-aware interactions without requiring users to leave their existing environment. The platform provides two deployment modes (anonymous and authenticated), a customisable **Chat Client** with real-time streaming via **Server-Sent Events (SSE)**, and **Magic Links** for instant access via code, URL, or QR.

Ask Eve AI Specialists are modular AI agents designed for seamless integration into websites, portals, or applications, enabling context-aware interactions without requiring users to leave their existing environment. The platform combines a flexible API, an embeddable Chat Client, and Magic Links to deploy AI-driven workflows across public and internal use cases.

Integration Flexibility

The Ask Eve AI API serves as the core interface, allowing developers to connect Specialists to any digital touchpoint. For rapid deployment, the Chat Client—a lightweight, brand-customisable component—can be embedded directly into web pages. It supports rich responses (formatted text, links, and references), complex form entry for structured data collection, and thinking indicators to signal multi-step processing.

Access Modes

Two distinct access modes cater to different scenarios:

• Anonymous Mode: Enables public interactions (e.g., website visitors) via tenant-specific API keys, requiring no user authentication.
• Authenticated Mode: Provides personalised experiences, session persistence, and access controls for internal teams handling sensitive data.

Real-Time and Background Execution

Specialists operate in two communication patterns:

• Real-Time Conversations: Uses Server-Sent Events (SSE) to stream responses progressively, mirroring modern AI assistants. Intermediate states (e.g., data retrieval, analysis) are visible to users, enhancing transparency.
• Background Execution: Handles asynchronous tasks (e.g., CRM data enrichment) without requiring immediate user interaction.

Magic Links for Instant Access

Magic Links generate secure, shareable connections to Specialists in three formats:

• Code: For direct integration into applications.
• URL: A web-based Chat Client link.
• QR Code: Scannable access for mobile or physical media.

Customisation and Control

The Tenant Make system allows visual customisation (colours, typography, logos) via CSS variables, ensuring brand consistency. For advanced use cases, the API enables full control over conversation sessions, response handling, and specialist behaviour—without sacrificing the platform’s core functionality.

Underlying protocols like SSE and authentication layers ensure scalability, while the separation of anonymous and authenticated modes balances accessibility with security.