> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mindset.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> Use this guide to determine which Agent Builder SDK components best fit your implementation needs.

# Decision Flow

## Question 1: Do you want to use Mindset's list view UI?

<Tabs>
  <Tab title="YES - Use Mindset's List View">
    ### Embed Builder Components

    <CodeGroup>
      ```html Agent Builder theme={null}
          <mindset-agents-manager></mindset-agents-manager>
      ```

      ```html Context Builder theme={null}
          <mindset-contexts-manager></mindset-contexts-manager>
      ```
    </CodeGroup>

    ### What You Get

    <CardGroup cols={2}>
      <Card title="Complete UI" icon="window">
        Full list view with cards or table
      </Card>

      <Card title="Search & Filter" icon="magnifying-glass">
        Built-in search and filtering capabilities
      </Card>

      <Card title="Edit & Delete" icon="pen-to-square">
        Integrated edit and delete actions
      </Card>

      <Card title="Create New" icon="plus">
        Built-in create functionality
      </Card>
    </CardGroup>

    <Check>
      **Best for:** Teams who want a complete out-of-box experience with minimal setup
    </Check>
  </Tab>

  <Tab title="NO - Build Your Own List View">
    ### Embed Configuration Components

    <CodeGroup>
      ```html Agent Configuration theme={null}
          <mindset-agent-configuration></mindset-agent-configuration>
      ```

      ```html Context Configuration theme={null}
          <mindset-context-configuration></mindset-context-configuration>
      ```
    </CodeGroup>

    ### What You Build vs What SDK Handles

    <AccordionGroup>
      <Accordion title="You Build" icon="hammer">
        * Custom list view (tiles, cards, tables)
        * Your own search and filtering
        * Custom layout and styling
        * Delete confirmation flows
      </Accordion>

      <Accordion title="SDK Handles" icon="box-check">
        * Creating new resources
        * Editing existing resources
        * Form validation
        * Save and update logic
      </Accordion>
    </AccordionGroup>

    <Check>
      **Best for:** Teams who need full control over the list view presentation
    </Check>
  </Tab>
</Tabs>

## Question 2: Who provides the knowledge/context?

<CardGroup cols={2}>
  <Card title="Tenants Upload Their Own Files" icon="upload" color="#10b981">
    **Approach:** Embed Context Builder or Context Configuration components

    **When to use:**

    * Tenants manage their own knowledge
    * Each tenant has unique content
    * Self-service model
  </Card>

  <Card title="You Provide Centrally" icon="database" color="#3b82f6">
    **Approach:** Create app-level contexts via API

    **When to use:**

    * Centralized knowledge management
    * Consistent content across tenants
    * You control all knowledge sources
  </Card>

  <Card title="Mix of Both" icon="layer-group" color="#f59e0b">
    **Approach:** Embed context components AND create app-level contexts

    **When to use:**

    * Base knowledge provided centrally
    * Tenants can add custom content
    * Hybrid knowledge model
  </Card>

  <Card title="Use RAG MCP Instead" icon="network-wired" color="#ec4899">
    **Approach:** No contexts needed, provision RAG MCP in agent sessions

    **When to use:**

    * Using external RAG system
    * Custom vector database
    * Advanced knowledge retrieval
  </Card>
</CardGroup>

## Component Comparison Matrix

<Tabs>
  <Tab title="Builder Components">
    ### `<mindset-agents-manager>` & `<mindset-contexts-manager>`

    | Feature              | Status                    | Details                        |
    | -------------------- | ------------------------- | ------------------------------ |
    | **Purpose**          | ✅ Complete CRUD interface | Full-featured management UI    |
    | **List View**        | ✅ Included                | Cards or table with pagination |
    | **Search & Filter**  | ✅ Built-in                | Instant search and filtering   |
    | **Create**           | ✅ Built-in dialogs        | Modal-based creation flow      |
    | **Edit**             | ✅ Built-in dialogs        | Modal-based editing flow       |
    | **Delete**           | ✅ Included                | Confirmation dialog included   |
    | **Setup Complexity** | 🟢 Low                    | Embed and initialize           |
    | **Customization**    | 🟡 Limited                | Theme colors and fonts only    |

    <Check>
      **Best for:** Standard admin interfaces with minimal customization needs
    </Check>
  </Tab>

  <Tab title="Configuration Components">
    ### `<mindset-agent-configuration>` & `<mindset-context-configuration>`

    | Feature              | Status                   | Details                         |
    | -------------------- | ------------------------ | ------------------------------- |
    | **Purpose**          | ✅ Standalone create/edit | Focused configuration interface |
    | **List View**        | ❌ Not included           | You build your own              |
    | **Search & Filter**  | ❌ Not applicable         | You build your own              |
    | **Create**           | ✅ Standalone interface   | Launch for creation             |
    | **Edit**             | ✅ Standalone interface   | Pass agentUid/contextUid        |
    | **Delete**           | ❌ Not included           | You implement this              |
    | **Setup Complexity** | 🟡 Medium                | Build custom list view          |
    | **Customization**    | 🟢 High                  | Full control over UI/UX         |

    <Check>
      **Best for:** Custom UI workflows where you control the list view presentation
    </Check>
  </Tab>
</Tabs>

## Common Implementation Patterns

<AccordionGroup>
  <Accordion title="Pattern 1: Full Self-Service (Most Common)" defaultOpen icon="users">
    **Use Case:** Tenants fully manage their agents and knowledge

    **Components:**

    * `<mindset-agents-manager>`
    * `<mindset-contexts-manager>`

    **Setup:**

    ```html theme={null}
        <mindset-agents-manager></mindset-agents-manager>
        <mindset-contexts-manager></mindset-contexts-manager>
    ```

    <Check>
      Zero configuration, complete functionality
    </Check>
  </Accordion>

  <Accordion title="Pattern 2: Centralized Knowledge" icon="database">
    **Use Case:** You provide all knowledge, tenants just configure agents

    **Components:**

    * `<mindset-agents-manager>`
    * App-level contexts (created via API)

    **Setup:**

    ```html theme={null}
        <mindset-agents-manager></mindset-agents-manager>
        <!-- No context builder needed -->
    ```

    <Check>
      Simpler UI, centralized content control
    </Check>
  </Accordion>

  <Accordion title="Pattern 3: Custom List UI" icon="palette">
    **Use Case:** You need branded list views with custom layouts

    **Components:**

    * `<mindset-agent-configuration>`
    * `<mindset-context-configuration>`
    * Your custom list views

    **Setup:**

    ```javascript theme={null}
        // Your custom list
        function openAgentEditor(agentUid) {
          container.innerHTML = `
            <mindset-agent-configuration 
              agentUid="${agentUid}">
            </mindset-agent-configuration>
          `;
        }
    ```

    <Check>
      Maximum customization, more development
    </Check>
  </Accordion>

  <Accordion title="Pattern 4: Hybrid Knowledge Model" icon="layer-group">
    **Use Case:** Base knowledge from you, custom knowledge from tenants

    **Components:**

    * `<mindset-agents-manager>`
    * `<mindset-contexts-manager>`
    * App-level contexts (created via API)

    **Setup:**

    1. Create app-level contexts via API
    2. Embed both builder components
    3. Tenants see app contexts + can create their own

    <Check>
      Flexibility for both centralized and custom content
    </Check>
  </Accordion>
</AccordionGroup>

## Quick Reference Table

| Your Needs                              | Recommended Components                | Complexity | Customization |
| --------------------------------------- | ------------------------------------- | ---------- | ------------- |
| Complete admin interface, minimal setup | Builder Components                    | 🟢 Low     | 🟡 Limited    |
| Custom list view, SDK handles forms     | Configuration Components              | 🟡 Medium  | 🟢 High       |
| Tenants upload knowledge                | Include Context Builder/Configuration | 🟢 Low     | 🟡 Medium     |
| You provide all knowledge               | Agents only + API contexts            | 🟢 Low     | 🟡 Medium     |
| Mix of both approaches                  | All components + API contexts         | 🟡 Medium  | 🟢 High       |
| Using external RAG                      | Agents only + RAG MCP                 | 🟡 Medium  | 🟢 High       |