|
2 | 2 | docs_version: 9 |
3 | 3 | title: Sophia AI |
4 | 4 | layout: docs-adoc |
5 | | -menu: cloud |
6 | | -applies_to: cloud |
| 5 | +menu: sophia |
| 6 | +applies_to: both |
7 | 7 | --- |
8 | 8 |
|
9 | | -=== Intelligent AI Support for Your Organization |
| 9 | +=== Intelligent AI Powered by Your Knowledge |
10 | 10 |
|
11 | | -Sophia is an advanced AI service exclusively available with *RESTHeart Cloud*. Built by SoftInstigate, Sophia transforms your organization's knowledge base into an intelligent, conversational assistant that provides instant, accurate responses to your users' questions. |
| 11 | +Sophia is an AI assistant built by SoftInstigate that turns any knowledge base into an intelligent, conversational interface. It combines Claude (Anthropic's advanced language model) with Retrieval-Augmented Generation (RAG) to provide instant, accurate answers grounded in your documents. |
12 | 12 |
|
13 | 13 | image::../../../images/sophia/chat-interface.png[Sophia chat interface] |
14 | 14 |
|
15 | | -=== What is Sophia? |
| 15 | +=== Sophia for RESTHeart |
16 | 16 |
|
17 | | -Sophia leverages Large Language Models with Retrieval-Augmented Generation (RAG) technology to create an intelligent support system for organizations. Instead of users searching through documentation or waiting for human assistance, they can ask questions in natural language and receive immediate, contextual answers drawn from your organization's knowledge base. |
| 17 | +If you're here to learn about RESTHeart or RESTHeart Cloud, Sophia is already working for you. The link:/docs/sophia[AI Help] in the top navigation connects you to a Sophia instance trained on the full RESTHeart documentation — including plugin API, configuration guides, and source code examples. You can also connect it to Claude Desktop, Cursor, or VS Code via MCP (see link:/docs/cloud/sophia/mcp[MCP Server]). |
18 | 18 |
|
19 | | -The service combines Claude (Anthropic's advanced language model) with sophisticated document processing to understand both the intent behind questions and the content of your documents. When someone asks a question, Sophia searches through your uploaded materials using semantic understanding — not just keyword matching — to find the most relevant information, then crafts a conversational response that directly addresses the query. |
| 19 | +=== Sophia for Your Organization |
20 | 20 |
|
21 | | -=== Knowledge Base Management |
| 21 | +Sophia is available as a managed service through *RESTHeart Cloud* in the *dedicated* tier. You get your own Sophia instance, powered by your own knowledge base — with full control over contexts, documents, access, and AI behaviour through the admin panel. |
22 | 22 |
|
23 | | -Upload documents in multiple formats including PDFs, text files, HTML, and Markdown. Sophia automatically processes these materials, breaking them into searchable segments and creating vector embeddings that enable intelligent content discovery. The web-based admin panel provides intuitive tools for uploading, browsing, and managing your knowledge base. |
| 23 | +Upload your documents, configure your contexts, and your users get an intelligent assistant that understands your content. Customer support teams, educational institutions, and enterprise organizations use Sophia to make their knowledge instantly accessible. |
24 | 24 |
|
25 | | -image::../../../images/sophia/knowledge-list.png[Knowledge base management] |
| 25 | +image::../../../images/sophia/admin-panel.png[Admin panel] |
26 | 26 |
|
27 | | -=== Contexts and Knowledge Segregation |
| 27 | +=== Key Features |
28 | 28 |
|
29 | | -Organize your knowledge into isolated *contexts*, each with its own prompt template, document tags, and RAG configuration. Contexts ensure strict data separation — users in one context can never access documents from another. This makes it easy to serve different audiences (customers, internal staff, partners) from a single Sophia instance. |
| 29 | +==== Knowledge Base Management |
30 | 30 |
|
31 | | -image::../../../images/sophia/context-list.png[Context management] |
| 31 | +Upload documents in multiple formats (PDF, Markdown, HTML, plain text). Sophia automatically processes them into searchable segments with vector embeddings. The admin panel provides intuitive tools for uploading, browsing, and managing your knowledge base. |
32 | 32 |
|
33 | | -=== Agentic Mode |
| 33 | +image::../../../images/sophia/knowledge-list.png[Knowledge base management] |
34 | 34 |
|
35 | | -For complex questions that require gathering information from multiple sources, Sophia can operate as an autonomous agent. When agentic mode is enabled on a context, Sophia iteratively searches the knowledge base, reads files, and reasons about the results before composing a comprehensive response. Users see the agent's reasoning process in real time through tool execution badges. |
| 35 | +==== Contexts and Knowledge Segregation |
36 | 36 |
|
37 | | -image::../../../images/sophia/agentic-response.png[Agentic response] |
| 37 | +Organize your knowledge into isolated *contexts*, each with its own prompt template, document tags, and RAG configuration. Contexts ensure strict data separation — users in one context can never access documents from another. Serve different audiences (customers, internal staff, partners) from a single Sophia instance. |
38 | 38 |
|
39 | | -=== Admin Panel |
| 39 | +image::../../../images/sophia/context-list.png[Context management] |
40 | 40 |
|
41 | | -A full-featured web administration interface lets administrators manage the entire Sophia instance from the browser: create and configure contexts, upload and organize documents, inspect text segments, test semantic search quality, and issue scoped API tokens for programmatic access. |
| 41 | +==== Agentic Mode |
42 | 42 |
|
43 | | -image::../../../images/sophia/admin-panel.png[Admin panel] |
| 43 | +For complex questions, Sophia can operate as an autonomous agent. When agentic mode is enabled, Sophia iteratively searches the knowledge base, reads files, and reasons about the results before composing a comprehensive answer. Users see the reasoning process in real time. |
44 | 44 |
|
45 | | -=== Security and Access Control |
| 45 | +image::../../../images/sophia/agentic-response.png[Agentic response] |
46 | 46 |
|
47 | | -Cookie-based authentication secures the web interface, while JWT tokens provide programmatic access for APIs and MCP clients. Role-based permissions separate admin and user capabilities. API tokens can be scoped to specific contexts and tags, ensuring knowledge segregation extends to every access path. |
| 47 | +==== Security and Access Control |
48 | 48 |
|
49 | | -image::../../../images/sophia/token-list.png[API tokens] |
| 49 | +Cookie-based authentication secures the web interface, while JWT tokens provide programmatic access for APIs and MCP clients. API tokens can be scoped to specific contexts and tags, ensuring knowledge segregation extends to every access path. |
50 | 50 |
|
51 | | -=== MCP Server Integration |
| 51 | +==== MCP Server |
52 | 52 |
|
53 | | -Sophia exposes a *Model Context Protocol (MCP) server*, allowing AI clients and agents such as Claude Desktop, Cursor, and VS Code to connect directly to your knowledge base. The admin panel generates ready-to-paste MCP configuration snippets for each API token. |
| 53 | +Sophia exposes a *Model Context Protocol (MCP) server*, allowing AI clients such as Claude Desktop, Cursor, and VS Code to connect directly to your knowledge base. The admin panel generates ready-to-paste configuration snippets. |
54 | 54 |
|
55 | 55 | image::../../../images/sophia/token-mcp-config.png[MCP configuration] |
56 | 56 |
|
57 | 57 | See link:/docs/cloud/sophia/mcp[Sophia MCP Server] for setup instructions. |
58 | 58 |
|
59 | | -=== Flexible Integration |
| 59 | +==== Flexible Integration |
60 | 60 |
|
61 | | -The responsive chat interface works seamlessly across devices and can be embedded into existing websites via iframe or used standalone. Multi-language support (English/Italian) and customizable themes allow Sophia to match your organization's brand and user needs. |
| 61 | +The responsive chat interface works across devices and can be embedded into existing websites via iframe. Multi-language support (English/Italian) and customizable themes let Sophia match your brand. |
62 | 62 |
|
63 | 63 | === Getting Started |
64 | 64 |
|
65 | | -Sophia is exclusively available through RESTHeart Cloud in the dedicated tier. See the link:/docs/cloud/sophia/setup[Setup Guide] to get started. |
| 65 | +See the link:/docs/cloud/sophia/setup[Setup Guide] to get your own Sophia instance. |
0 commit comments