Skip to main content

Admin Portal

The Admin Portal is where you configure and manage DioscHub assistants, MCP servers, knowledge bases, users, and system settings.

Accessing the Portal

The Admin Portal runs as a separate application. By default it is available at:

http://localhost:7001

In production, your administrator will provide the portal URL. You need admin credentials to log in.

Admin Portal Login

Dashboard

After logging in you see the main dashboard with deployment metrics and trends.

Admin Dashboard

See Dashboard for full details on metrics and charts.

Portal Navigation

The sidebar is organized into three groups:

Overview

SectionDescription
DashboardDeployment metrics and trends
AnalyticsDAU timeline, error rates, peak hours, response times
Business IntelligenceTopic analysis, knowledge gaps, adoption metrics

Management

SectionDescription
AssistantsCreate and configure AI assistants
MCPsManage MCP server instances
ModelsLLM model catalog and provider credentials
KnowledgeKnowledge bases and documents for RAG
UsersManage portal users and permissions
API KeysManage API keys for programmatic access

System

SectionDescription
MonitoringAudit logs and system health
UsageToken usage dashboards
BillingResource costs and quota management
SettingsPlugins, resource pricing, rate limits, BI config

Per-Assistant Configuration

Several features are configured per assistant under the assistant's Settings tabs:

FeatureDocumentation
SitemapNavigation paths and placeholder resolvers
RolesRole-based AI behavior
Approval PoliciesTool approval workflows

Common Workflows

Setting Up a New Assistant

  1. Go to AssistantsCreate New
  2. Set the name, greeting message, and select a model
  3. Configure the System Prompt to define personality
  4. Fine-tune Model parameters
  5. Set up Authentication and CORS
  6. Connect MCP tools via the Plugins tab
  7. Define your app's Sitemap
  8. Configure Roles for user-specific behavior
  9. Set up Approval Policies for sensitive tools

Connecting a New MCP Server

  1. Go to MCPsCreate
  2. Enter the instance name, display name, and SSE URL
  3. Test Connection to verify connectivity
  4. Browse discovered Tools and configure settings
  5. Configure approval settings for sensitive tools

Adding Knowledge to an Assistant

  1. Go to KnowledgeCreate
  2. Enter a name and description for the knowledge base
  3. Upload files (PDFs, documents, spreadsheets)
  4. Wait for files to finish processing (status: Ready)
  5. Open the assistant's settings → Knowledge tab
  6. Link the knowledge base to the assistant
  7. The assistant can now search these documents during conversations

For automated sync from external systems, see Sync Webhook.

Monitoring Your Deployment

  1. Check the Dashboard for overall health
  2. Review Analytics for usage patterns
  3. Check Usage & Billing for cost trends
  4. Open Monitoring for system health and audit logs