> ## Documentation Index
> Fetch the complete documentation index at: https://prismeai-legacy.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Sharing Agents

> Learn how to share and distribute your AI agents with colleagues and across your organization

One of the key benefits of the AI Store is the ability to share specialized agents with colleagues, teams, or your entire organization. This guide covers how to effectively share agents, manage access, and integrate them into various platforms.

## Sharing Benefits

<CardGroup cols="2">
  <Card title="Knowledge Amplification" icon="brain">
    Multiply the impact of expertise by making specialized agents widely available
  </Card>

  <Card title="Collaboration" icon="users">
    Enable teams to benefit from and build upon each other's work
  </Card>

  <Card title="Standardization" icon="check-double">
    Ensure consistent AI usage and responses across your organization
  </Card>

  <Card title="Efficiency" icon="bolt">
    Reduce duplicate work by sharing solutions widely
  </Card>

  <Card title="Innovation" icon="lightbulb">
    Inspire others to adapt and enhance your agents
  </Card>

  <Card title="Recognition" icon="medal">
    Showcase your expertise and contributions
  </Card>
</CardGroup>

## Sharing Options Overview

<Frame>
  <img src="https://mintcdn.com/prismeai-legacy/jdOgS9ouJy0zTcFo/images/deployment-options.png?fit=max&auto=format&n=jdOgS9ouJy0zTcFo&q=85&s=f72c330496654ff362b288c80a01fc5a" alt="Sharing Options Overview" width="3024" height="1490" data-path="images/deployment-options.png" />
</Frame>

Prisme.ai offers multiple ways to share agents:

<Tabs>
  <Tab title="User Sharing">
    Share directly with specific individuals in your organization:

    * Target precise recipients
    * Control access levels for each person
  </Tab>

  <Tab title="Group Sharing">
    Depending on your role, share with defined groups or departments:

    * Reach entire teams at once
    * Maintain access as team membership changes
    * Set uniform permissions for the group
    * Manage access at the group level
  </Tab>

  <Tab title="Link Sharing">
    Available in AI Store to simplify distribution. Other sharing modes are available in AI Knowledge & Teams.
    Create direct links to your agent:

    * Generate URLs for easy distribution
    * Share via email, chat, or documents
  </Tab>

  <Tab title="Public Listing">
    Make your agent discoverable in the AI Store:

    * Anyone in your organization can find it
    * Appears in search and browsing
    * Features in relevant categories
  </Tab>

  <Tab title="Embedding">
    Available in AI Store for straightforward use. Advanced options available via AI Knowledge > Teams.

    Integrate your agent into other applications:

    * Add to internal websites
    * Embed in portals or wikis
    * Create in-page experiences
  </Tab>
</Tabs>

### Restrict sharing

The instance can be configured to allow or prevent agents to be shared. In the AI Knowledge configuration, the key `limits.share` can be set to `false` to prevent anyone from sharing an agent.\
If this is setup this way, each agent can individually be set to "can be shared" from its `administration` view, by an AI Knowledge Admin.

## Sharing with Specific Users

<Steps>
  <Step title="Access sharing options">
    From your agent's details page, click the "Share" button.
  </Step>

  <Step title="Select individual users">
    Enter the email addresses of colleagues (if they have a valid account on your Prisme.ai instance).
  </Step>

  <Step title="Set permission levels">
    Choose what level of access each recipient should have:

    * **User**: Can use the agent
    * **Editor**: Can use and customize
    * **Owner**: Full control
  </Step>

  <Step title="Send share invitation">
    Click "Share" to send the invitation (requires email notification to be configured by your admin).
  </Step>
</Steps>

## Sharing with Groups

<Steps>
  <Step title="Access group sharing">
    In the sharing dialog, switch to the "Groups" tab.
  </Step>

  <Step title="Select groups">
    Choose relevant teams, departments, or custom groups.
  </Step>

  <Step title="Set group permissions">
    Permissions apply to all members (current and future).
  </Step>

  <Step title="Configure notification options">
    Choose whether group members should receive notifications (based on admin settings).
  </Step>

  <Step title="Share with selected groups">
    Click "Share" to complete.
  </Step>
</Steps>

## Creating and Sharing Links

<Steps>
  <Step title="Click on share agent">
    In the sharing dialog, select the "Link" tab.
  </Step>

  <Step title="Share the link">
    Distribute via email, chat, or documentation.
  </Step>
</Steps>

## Making Agents Public in Your Organization

<Steps>
  <Step title="Configure public listing">
    Toggle "List in AI Store" in the sharing settings.
  </Step>

  <Step title="Set discovery details">
    Add metadata to help others find your agent.
  </Step>

  <Step title="Publish to AI Store">
    Click "Publish" to finalize.
  </Step>
</Steps>

## Embedding Agents in Other Applications

<Steps>
  <Step title="Access embedding options">
    From your agent's detail page, select "Embed" from the menu.
  </Step>

  <Step title="Configure the embed">
    Customize the interface: format, branding, and features.
  </Step>

  <Step title="Generate embed code">
    Click "Generate Code" to create your snippet.
  </Step>

  <Step title="Implement the embed">
    Add the snippet to your site or app.
  </Step>
</Steps>

<Accordion title="Embed Code Example">
  ```html theme={null}
  <!-- Prisme.ai Agent Embed -->
  <script src="https://cdn-assets.prisme.ai/blocks/popover/inject/index.js"></script>
  <script type="text/javascript">
  Prismeai.popover({
    "url": "https://ai-knowledge-chat.pages.prisme.ai/agent?id=66cde46fbf94ca779ff6d7b8",
    "config": {
      "header": {
        "closeColor": "#7f7f7f",
        "title":" "
      },
    }
  })
  </script>
  <!-- End Prisme.ai Agent Embed -->
  ```
</Accordion>

## Embedding Display Modes

<CardGroup cols="3">
  <Card title="Chat Window" icon="comments">
    Full-featured chat interface in a container
  </Card>

  <Card title="Chat Button" icon="circle-chat">
    Floating button that expands on click
  </Card>

  <Card title="Inline Assistant" icon="message-lines">
    Embed responses directly in content
  </Card>

  <Card title="Popup Dialog" icon="rectangle-wide">
    Agent appears in a modal
  </Card>

  <Card title="Sidebar" icon="sidebar">
    Persistent panel alongside content
  </Card>

  <Card title="Full Page" icon="browser">
    Full-page assistant experience
  </Card>
</CardGroup>

## Managing Shared Agents

<Steps>
  <Step title="Access sharing management">
    Go to the agent’s detail page and select "Users."
  </Step>

  <Step title="Review current sharing">
    View all users and groups with access.
  </Step>

  <Step title="Modify permissions">
    Adjust access levels as needed.
  </Step>

  <Step title="Revoke access">
    Remove access for users or groups.
  </Step>

  <Step title="Monitor usage">
    View interaction and performance data.
  </Step>
</Steps>

## Visibility and Access Control

| Sharing Method       | Store Visibility | Who Can Access         | Discovery Method          |
| -------------------- | ---------------- | ---------------------- | ------------------------- |
| Private (no sharing) | Not listed       | Creator only           | "My Agents"               |
| Direct user sharing  | Not listed       | Specific users         | "Shared with Me"          |
| Group sharing        | Not listed       | Members of groups      | "Shared with Me"          |
| Link sharing         | Not listed       | Anyone with the link   | Direct link               |
| Public (listed)      | Listed           | All organization users | Store browsing & search   |
| Embedded             | Varies           | Host application users | Within the host interface |

## Collaboration Features

<Accordion title="Feedback Collection">
  Collect structured feedback:

  * Enable ratings
  * Capture improvement ideas
  * Identify knowledge gaps
</Accordion>

<Accordion title="Collaborative Editing">
  Allow trusted colleagues to edit agents:

  * Grant edit permissions
  * Owners can also delete the agent
</Accordion>

## Best Practices for Sharing

<CardGroup cols="2">
  <Card title="Clear Documentation" icon="file-lines">
    Explain agent purpose and how to use it
  </Card>

  <Card title="Selective Sharing" icon="filter">
    Focus sharing on relevant audiences
  </Card>

  <Card title="Permission Management" icon="lock">
    Set access levels appropriately
  </Card>

  <Card title="Regular Updates" icon="arrows-rotate">
    Improve agents based on usage
  </Card>

  <Card title="Usage Monitoring" icon="chart-line">
    Track usage to identify opportunities
  </Card>

  <Card title="Feedback Loops" icon="comments">
    Collect and apply user suggestions
  </Card>
</CardGroup>

## Troubleshooting Sharing Issues

<AccordionGroup>
  <Accordion title="Users can't access a shared agent">
    * Confirm user account and email
    * Check group or link settings
    * Ensure permissions are correctly applied
    * Verify agent is active and not deleted
  </Accordion>

  <Accordion title="Embedded agent not working">
    * Confirm embed code is implemented correctly
    * Check browser console for errors
    * Validate authentication and CORS settings
  </Accordion>

  <Accordion title="Sharing permissions issues">
    * Review permission hierarchy and org policies
    * Ensure changes are saved and propagated
  </Accordion>
</AccordionGroup>

## Next Steps

<CardGroup cols="3">
  <Card title="Managing Agents" icon="list-check" href="../managing-agents">
    Learn how to maintain and update your agents
  </Card>

  <Card title="Customizing Agents" icon="sliders" href="../customizing-agents">
    Tailor existing agents to your needs
  </Card>

  <Card title="Creating Agents" icon="square-plus" href="../creating-agents">
    Build new agents from scratch
  </Card>
</CardGroup>