Skip to main content

​
What is the AMS SDK?

AMS SDK lets your tenants create, build, and manage custom AI agents directly inside your application—without you building the UI or managing hundreds of custom agent requests. Embed pre-built components that give your customers the power to create, configure, and manage their own agents in minutes.
The AMS SDK is a premium feature that enables you to embed agent-building capabilities directly into your product.

​
Currently Available Components

Agent Management:
  • Agents Manager (<mindset-agents-manager>) - List and manage AI agents
  • Agent Configuration (<mindset-agent-configuration>) - Create and edit individual agents
Knowledge Context Management:
  • Contexts Manager (<mindset-contexts-manager>) - List and manage knowledge contexts
  • Context Configuration (<mindset-context-configuration>) - Create and edit individual contexts

​
How It Works

The AMS SDK uses custom HTML elements that you embed directly in your web pages:
1

Load JavaScript

Load Mindset AI’s JavaScript via a <script> tag
2

Place Custom Elements

Place custom HTML elements in your page
3

Initialize the SDK

Call window.mindset.init() to configure and initialize
4

Components Render

Components render automatically with full functionality

​
Quick Start Example

Here’s a minimal working example: 
<!DOCTYPE html>
<html>
<head>
    <title>Agent & Context Management</title>
</head>
<body>
    <!-- 1. Place the custom elements in your page -->
    <mindset-agents-manager></mindset-agents-manager>
    <mindset-contexts-manager></mindset-contexts-manager>

    <!-- 2. Load the AMS SDK JavaScript -->
    <script src="https://[AMS-SDK-URL]/mindset-sdk2.js"></script>

    <!-- 3. Initialize the SDK -->
    <script>
        (async () => {
            const externalTenantId = getCurrentTenantId(); // Your logic

            await window.mindset.init({
                appUid: 'your-app-uid',
                externalTenantId: externalTenantId,
                theme: {}, // Customize the theme
                customFontTheme: {}, // Customize fonts
                fetchAuthentication: async () => fetchUserAuthToken() // Your logic
            });

            console.log('AMS SDK initialized');
        })();
    </script>
</body>
</html>

​
Available Components

Tab Control Works for Both Component TypesThe displayTabs attribute works identically for both Manager and Configuration components:
  • Manager components (<mindset-agents-manager>, <mindset-contexts-manager>) - Controls tabs in the built-in create/edit dialogs
  • Configuration components (<mindset-agent-configuration>, <mindset-context-configuration>) - Controls tabs in the standalone interface
Use displayTabs to show only the tabs your tenants need, regardless of which component type you choose.

​
1. Agents Manager - <mindset-agents-manager>

Displays a list of all agents for the tenant with the ability to:
  • View all agents
  • Create new agents
  • Edit existing agents
  • Delete agents
  • Search and filter agents
Usage: 
<mindset-agents-manager></mindset-agents-manager>
Optional Attributes:
AttributeTypeDescription
displayTabsstring (optional)Comma-separated list of tabs to display when creating or editing agents. Available tabs: Policy, Options, LLM, Contexts, Bias, Preview. Works the same as in <mindset-agent-configuration>.
Examples: 
<!-- Show all default tabs -->
<mindset-agents-manager></mindset-agents-manager>

<!-- Show only specific tabs -->
<mindset-agents-manager displayTabs="Policy,Bias,Preview"></mindset-agents-manager>
This component provides the complete agent management interface, including list view and built-in create/edit dialogs.

​
2. Agent Configuration - <mindset-agent-configuration>

Displays the agent creation or editing dialog for a single agent. This component is useful when you want to:
  • Embed agent creation/editing in a form
  • Control when and how the configuration interface appears
  • Build your own custom list view UI
Attributes:
AttributeTypeDescription
agentUidstring (optional)UID of agent to edit. If omitted, creates new agent
onClosestring (optional)JavaScript code to execute when configuration UI is dismissed
displayTabsstring (optional)Comma-separated list of tabs to display. Available tabs: Policy, Options, LLM, Contexts, Bias, Preview
Usage Examples: 
<!-- Create new agent -->
<mindset-agent-configuration></mindset-agent-configuration>

<!-- Edit existing agent -->
<mindset-agent-configuration agentUid="agent-abc123"></mindset-agent-configuration>

<!-- With close handler -->
<mindset-agent-configuration
    agentUid="agent-abc123"
    onClose="handleAgentClose();">
</mindset-agent-configuration>

<!-- Show only specific tabs -->
<mindset-agent-configuration
    agentUid="agent-abc123"
    displayTabs="Policy,LLM,Contexts">
</mindset-agent-configuration>

​
Agent Configuration Tabs

The <mindset-agent-configuration> component displays multiple configuration tabs: Always Displayed:
  • Settings - Basic agent configuration (name, description, etc.)
  • Personality - Agent behavior and tone
Optional Tabs (controlled via displayTabs):
  • Policy - Agent policies and guidelines
  • Options - Additional agent options
  • LLM - Language model configuration
  • Contexts - Knowledge base associations
  • Bias - Bias detection configuration
  • Preview - Agent preview
Controlling Tab Display: 
<!-- Display all tabs (default) -->
<mindset-agent-configuration agentUid="agent-123"></mindset-agent-configuration>

<!-- Display only required tabs (Settings, Personality) -->
<mindset-agent-configuration agentUid="agent-123" displayTabs=""></mindset-agent-configuration>

<!-- Display specific optional tabs -->
<mindset-agent-configuration
    agentUid="agent-123"
    displayTabs="Policy,LLM">
</mindset-agent-configuration>
Settings and Personality tabs are always displayed regardless of the displayTabs value.

​
3. Contexts Manager - <mindset-contexts-manager>

Displays a list of all knowledge contexts for the tenant with the ability to:
  • View all contexts
  • Create new contexts
  • Edit existing contexts
  • Delete contexts
  • Search and filter contexts
Usage: 
<mindset-contexts-manager></mindset-contexts-manager>
Optional Attributes:
AttributeTypeDescription
displayTabsstring (optional)Comma-separated list of tabs to display when creating or editing contexts. Available tabs: Prompts, Bias. Works the same as in <mindset-context-configuration>.
Examples: 
<!-- Show all default tabs -->
<mindset-contexts-manager></mindset-contexts-manager>

<!-- Show only specific tabs -->
<mindset-contexts-manager displayTabs="Prompts"></mindset-contexts-manager>
This component provides the complete context management interface including list view and built-in create/edit dialogs.
Note on Synced ContextsThe Contexts Manager SDK does not allow tenants to create synced contexts directly. However, if an application administrator creates a synced context for a specific tenant using the Contexts API, that synced context will be visible to the tenant in the manager.

​
What are Knowledge Contexts?

Knowledge Contexts are bundles of files, links, and data that agents can reference—essentially a dynamic library for your agents.
  • Contexts - Documents, articles, and structured knowledge
  • Custom Prompts - Instructions that guide the AI’s responses
  • Bias - Overview of bias within your Contexts

​
4. Context Configuration - <mindset-context-configuration>

Displays the context creation or editing dialog for a single knowledge context. This component is useful when you want to:
  • Embed context creation/editing in a form
  • Build your own custom list view UI
Attributes:
AttributeTypeDescription
contextUidstring (optional)UID of context to edit. If omitted, creates new context
onClosestring (optional)JavaScript code to execute when dialog closes
displayTabsstring (optional)Comma-separated list of tabs to display. Available tabs: Prompts, Bias
Usage Examples: 
<!-- Create new context -->
<mindset-context-configuration></mindset-context-configuration>

<!-- Edit existing context -->
<mindset-context-configuration contextUid="context-xyz789"></mindset-context-configuration>

<!-- With close handler -->
<mindset-context-configuration
    contextUid="context-xyz789"
    onClose="handleContextClose();">
</mindset-context-configuration>

<!-- Show only specific tabs -->
<mindset-context-configuration
    contextUid="context-xyz789"
    displayTabs="Prompts">
</mindset-context-configuration>

​
Context Configuration Tabs

The <mindset-context-configuration> component displays configuration tabs: Always Displayed:
  • General - Basic context information (name, description, type)
Optional Tabs (controlled via displayTabs):
  • Prompts - Custom system prompts and instructions
  • Bias - Allows you to analyze the bias within your content
Controlling Tab Display: 
<!-- Display all tabs (default) -->
<mindset-context-configuration contextUid="context-123"></mindset-context-configuration>

<!-- Display specific tabs -->
<mindset-context-configuration
    contextUid="context-123"
    displayTabs="Prompts,Bias">
</mindset-context-configuration>

​
Integration Patterns

Use manager components for a complete, zero-configuration experience: 
<div class="tabs">
    <button onclick="showAgents()">Agents</button>
    <button onclick="showContexts()">Contexts</button>
</div>

<div id="agents-view">
    <mindset-agents-manager></mindset-agents-manager>
</div>

<div id="contexts-view" style="display: none;">
    <mindset-contexts-manager></mindset-contexts-manager>
</div>

<script>
    function showAgents() {
        document.getElementById('agents-view').style.display = 'block';
        document.getElementById('contexts-view').style.display = 'none';
    }

    function showContexts() {
        document.getElementById('agents-view').style.display = 'none';
        document.getElementById('contexts-view').style.display = 'block';
    }
</script>

​
Pattern 2: Configuration Component Integration

Use configuration components in forms if you want to create your own list view UI. 
<script>
    function createAgent() {
        const container = document.getElementById('agent-config-container');
        container.innerHTML = '<mindset-agent-configuration displayTabs="Policy" onClose="closeAgentModal();"></mindset-agent-configuration>';
        document.getElementById('agent-modal').style.display = 'block';
    }

    function editAgent(agentUid) {
        const container = document.getElementById('agent-config-container');
        container.innerHTML = `<mindset-agent-configuration agentUid="${agentUid}" displayTabs="Policy" onClose="closeAgentModal();"></mindset-agent-configuration>`;
        document.getElementById('agent-modal').style.display = 'block';
    }

    function closeAgentModal() {
        document.getElementById('agent-modal').style.display = 'none';
        document.getElementById('agent-config-container').innerHTML = '';
    }
</script>

​
Appendix: Complete Component Reference

​
Agent Components

​
<mindset-agents-manager>

FeatureDetails
PurposeComplete agent management interface
IncludesList view, create, edit, delete
AttributesdisplayTabs (optional)
Min Height600px

​
<mindset-agent-configuration>

FeatureDetails
PurposeSingle agent create/edit interface
IncludesConfiguration dialog only
AttributesagentUid (optional), onClose (optional), displayTabs (optional)
Available TabsPolicy, Options, LLM, Contexts, Bias, Preview
Always Shown TabsSettings, Personality
Min Height400px

​
Context Components

​
<mindset-contexts-manager>

FeatureDetails
PurposeComplete context management interface
IncludesList view, create, edit, delete
AttributesdisplayTabs (optional)
Min Height600px

​
<mindset-context-configuration>

FeatureDetails
PurposeSingle context create/edit interface
IncludesConfiguration dialog only
AttributescontextUid (optional), onClose (optional), displayTabs (optional)
Available TabsPrompts, Bias
Always Shown TabsGeneral
Min Height400px