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

# Troubleshooting

> Solutions for common issues with Demiurg

## Common issues

Find solutions to frequently encountered problems with agents, accounts, and platform functionality.

## Agent creation problems

<AccordionGroup>
  <Accordion title="Agent creation fails" icon="triangle-exclamation" defaultOpen>
    <Steps>
      <Step title="Check your description">
        Ensure your agent description is detailed and clear. Vague descriptions can cause creation failures.
      </Step>

      <Step title="Try shorter descriptions">
        If your description is very long, try breaking it into key components. Extremely long descriptions can sometimes cause issues.
      </Step>

      <Step title="Avoid restricted content">
        Ensure your agent doesn't violate content policies. Agents designed for harmful purposes will be rejected.
      </Step>

      <Step title="Check your connection">
        Agent creation requires a stable internet connection. Try again with a stronger connection.
      </Step>

      <Step title="Clear cache and try again">
        Clear your browser cache or app cache, then try creating the agent again.
      </Step>
    </Steps>

    If the issue persists, try creating a different agent to isolate whether the problem is with a specific description or a general platform issue.
  </Accordion>

  <Accordion title="Agent behaves differently than expected" icon="robot">
    <Steps>
      <Step title="Review your description">
        Compare the agent's behavior with your description to identify misinterpretations.
      </Step>

      <Step title="Be more specific">
        Edit your agent with more precise instructions about the problematic behavior.
      </Step>

      <Step title="Use examples">
        Include specific examples of desired responses in your agent description.
      </Step>

      <Step title="Try regenerating">
        If minor edits don't help, try completely regenerating the agent with a refined description.
      </Step>
    </Steps>

    Remember that agents have probabilistic behaviors. Small variations in responses are normal and expected.
  </Accordion>

  <Accordion title="Code editor not working" icon="code">
    <Steps>
      <Step title="Check subscription">
        Verify that your subscription plan includes Code Editor access. This feature is limited to premium plans.
      </Step>

      <Step title="Try a different browser">
        Some browser extensions can interfere with the Code Editor. Try using a different browser or disabling extensions.
      </Step>

      <Step title="Clear local storage">
        Go to Settings > Advanced > Clear Local Storage to reset cached editor data.
      </Step>

      <Step title="Check for syntax errors">
        Look for error messages in the editor console (accessible via the "Console" tab).
      </Step>
    </Steps>

    If you're making complex code changes, consider backing up your code before editing by copying it to a local text editor.
  </Accordion>
</AccordionGroup>

## Conversation issues

<AccordionGroup>
  <Accordion title="Agent stops responding" icon="comment-slash">
    <Steps>
      <Step title="Check your connection">
        Verify that you have a stable internet connection.
      </Step>

      <Step title="Refresh the conversation">
        Click the refresh icon or reload the page to reset the connection.
      </Step>

      <Step title="Start a new thread">
        If the conversation is very long, start a new conversation thread with the same agent.
      </Step>

      <Step title="Check system status">
        Visit [status.demiurg.ai](https://status.demiurg.ai) to see if there are any known service disruptions.
      </Step>
    </Steps>

    If the problem occurs frequently with a specific agent, consider regenerating that agent.
  </Accordion>

  <Accordion title="Agent gives repetitive responses" icon="arrows-rotate">
    <Steps>
      <Step title="Vary your prompts">
        Avoid asking the same question repeatedly, as this can cause response loops.
      </Step>

      <Step title="Add new context">
        Provide additional information or change the framing of your questions.
      </Step>

      <Step title="Reset the conversation">
        Start a fresh conversation to clear the interaction history.
      </Step>

      <Step title="Regenerate the agent">
        If the issue persists across multiple conversations, try regenerating the agent with a more diverse response pattern in the description.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="File upload failures" icon="file-circle-xmark">
    <Steps>
      <Step title="Check file size">
        Ensure your file is under the size limit (typically 25MB for free accounts, 100MB for premium).
      </Step>

      <Step title="Verify file format">
        Confirm that you're using a supported file format. Common supported formats include PDF, DOCX, TXT, CSV, XLS, JSON, and standard image formats.
      </Step>

      <Step title="Check for corruption">
        Try opening the file on your device to ensure it's not corrupted.
      </Step>

      <Step title="Try a different file">
        Upload a different file to determine if the issue is file-specific.
      </Step>
    </Steps>

    For large files, consider splitting them into smaller parts or compressing them before upload.
  </Accordion>

  <Accordion title="Agent can't remember previous context" icon="memory">
    <Steps>
      <Step title="Check conversation length">
        Very long conversations may exceed the agent's context window. Start a new conversation if needed.
      </Step>

      <Step title="Verify plan limits">
        Long-term memory features vary by subscription plan. Check your plan details.
      </Step>

      <Step title="Reference explicitly">
        Directly reference previous information: "As we discussed earlier about \[topic]..."
      </Step>

      <Step title="Enable memory features">
        For premium accounts, ensure enhanced memory features are enabled in agent settings.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Account and billing

<AccordionGroup>
  <Accordion title="Can't log in" icon="right-to-bracket">
    <Steps>
      <Step title="Check credentials">
        Verify your email/username and password are correct.
      </Step>

      <Step title="Reset password">
        Use the "Forgot Password" link to reset your credentials.
      </Step>

      <Step title="Clear cookies">
        Clear browser cookies and cache, then try again.
      </Step>

      <Step title="Try a different browser">
        Attempt login from another browser or device.
      </Step>

      <Step title="Check account status">
        Your account may be suspended due to terms violations or payment issues. Check your email for notifications.
      </Step>
    </Steps>

    If you still can't access your account, contact [support@demiurg.io](mailto:support@demiurg.io) with your account email.
  </Accordion>

  <Accordion title="Payment declined" icon="credit-card">
    <Steps>
      <Step title="Check card details">
        Verify that your card information is correct and up-to-date.
      </Step>

      <Step title="Contact your bank">
        Your bank may have blocked the transaction. Contact them to authorize payments to Demiurg.
      </Step>

      <Step title="Try another payment method">
        Add a different card or payment method to your account.
      </Step>

      <Step title="Check billing address">
        Ensure your billing address matches what your bank has on file.
      </Step>
    </Steps>

    If problems persist, contact [billing@demiurg.io](mailto:billing@demiurg.io) for assistance.
  </Accordion>

  <Accordion title="Subscription not activating" icon="bolt">
    <Steps>
      <Step title="Check payment status">
        Verify that your payment was successfully processed in Settings > Billing > Payment History.
      </Step>

      <Step title="Allow processing time">
        Subscription activation can take up to 15 minutes to propagate in our systems.
      </Step>

      <Step title="Clear cache and refresh">
        Clear your browser cache and refresh the page to update subscription status.
      </Step>

      <Step title="Check for notifications">
        Look for any error messages or notifications regarding your subscription.
      </Step>
    </Steps>

    If your payment was successful but features aren't activating after 24 hours, contact support with your transaction ID.
  </Accordion>
</AccordionGroup>

## Sharing and collaboration

<AccordionGroup>
  <Accordion title="Sharing invitations not received" icon="share-nodes">
    <Steps>
      <Step title="Check email address">
        Verify you've entered the correct email address or username for the recipient.
      </Step>

      <Step title="Check spam folder">
        Ask recipients to check their spam or promotions folders.
      </Step>

      <Step title="Try alternate sharing method">
        Use a direct link or QR code instead of email invitations.
      </Step>

      <Step title="Verify recipient's account">
        Confirm that the recipient has a Demiurg account. Non-users need to create an account before accessing shared agents.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Permission changes not applying" icon="shield">
    <Steps>
      <Step title="Check for conflicts">
        If the recipient has multiple access paths to your agent (e.g., individual and team access), the higher permission level will apply.
      </Step>

      <Step title="Refresh and sync">
        Ask the recipient to refresh their page or restart their app to sync permission changes.
      </Step>

      <Step title="Check group permissions">
        If the user is part of a permission group, you may need to modify group permissions.
      </Step>

      <Step title="Revoke and re-share">
        As a last resort, completely revoke access and re-share with the correct permissions.
      </Step>
    </Steps>
  </Accordion>
</AccordionGroup>

## Mobile app issues

<AccordionGroup>
  <Accordion title="App crashes or freezes" icon="mobile-screen">
    <Steps>
      <Step title="Update the app">
        Ensure you're using the latest version of the Demiurg app.
      </Step>

      <Step title="Restart the app">
        Force close the app completely and reopen it.
      </Step>

      <Step title="Restart your device">
        Reboot your phone or tablet to clear memory and processes.
      </Step>

      <Step title="Clear app cache">
        Go to your device's settings > Apps > Demiurg > Storage > Clear Cache.
      </Step>

      <Step title="Reinstall the app">
        Uninstall and reinstall the app as a last resort. Your data is stored in the cloud and will remain safe.
      </Step>
    </Steps>
  </Accordion>

  <Accordion title="Syncing problems between devices" icon="arrows-rotate">
    <Steps>
      <Step title="Check internet connection">
        Ensure both devices have stable internet connections.
      </Step>

      <Step title="Force refresh">
        Pull down on the main screen to force a sync.
      </Step>

      <Step title="Verify login">
        Confirm you're logged into the same account on both devices.
      </Step>

      <Step title="Check time">
        Ensure your device's date and time settings are correct and set to automatic.
      </Step>
    </Steps>

    Syncing typically occurs within minutes but can sometimes take up to an hour for complex data.
  </Accordion>
</AccordionGroup>

## Advanced issues

For technical problems not covered here, try these general troubleshooting steps:

1. **Clear cache and cookies**: Reset your browser or app data
2. **Try incognito mode**: Test if the issue persists in a private browsing session
3. **Disable extensions**: Browser extensions can sometimes interfere with functionality
4. **Update software**: Ensure your browser, app, and device OS are up to date
5. **Check firewall settings**: Network restrictions might block some features

## Contact support

<Card title="Email Support" icon="envelope" href="mailto:support@demiurg.io">
  For issues not resolved by these steps, contact our support team with details of your problem
</Card>

<Info>
  When contacting support, please include: your account email, device details, steps to reproduce the issue, and any error messages you've received.
</Info>