---
title: "Use an Agent Shared with You"
description: "Import agents from private links, files, or the Community"
---

# Use an Agent Shared with You

Import agent templates that have been shared with you through private links, files, or discovered in the Community.

## Importing from Direct Sharing

When someone shares an agent with you privately via link or file.

### Accessing Import

You can access the import interface from two locations:

**From Agents List:**
- Click **Add a New Agent** dropdown
- Select **Manual Import**

**From Platform Home (Quick Actions):**
- Click **Quick Actions** dropdown
- Select **Import Agent**


<Tabs>
  <Tab title="Import from URL">
    1. Toggle to **Import from URL** tab
    2. Paste the shared URL
    3. Agent details will render for review
    4. Select a destination project and **Import to Project**

    <Note>
    Private share links are one-time use and consumed upon agent retrieval. You will need a new link to re-import.
    </Note>
  </Tab>

  <Tab title="Import from File">
    1. Toggle to **Import from File** tab
    2. Upload or drag-drop the JSON file
    3. Agent details will render for review
    4. Select a destination project and **Import to Project**
  </Tab>
</Tabs>

---

## Importing from Community

When you discover an agent in the Airia Community.

### Accessing Community

From platform navigation:
- Click **Community** navigation item
- Browse the [Community site](https://community.airia.ai/templates)

### Import Process

1. Browse and select the agent you want to use
2. Click **Use Agent** to import back to the platform
3. Agent details will render for review
4. Select a destination project and **Import to Project**

<Note>
For more on discovering community agents, see [Using Community Agents](/community/using-community-agents).
</Note>

---

## Post-Import Configuration

Regardless of import method, you'll need to configure your environment-specific settings.

<AccordionGroup>
  <Accordion title="1. Reconfigure Credentials">
    - Add credentials for integrated tools
    - Verify tools enabled
  </Accordion>

  <Accordion title="2. Reconnect Data Sources">
    - Provide appropriate credentials
    - Verify data access permissions
  </Accordion>

  <Accordion title="3. Adjust Variables">
    - Review all input variables
    - Update environment-specific values
  </Accordion>

  <Accordion title="4. Test Functionality">
    - Run test conversations
    - Verify tool responses
    - Check data source retrieval
  </Accordion>

  <Accordion title="5. Review and Customize">
    - Examine prompts and instructions
    - Adjust for your use case
    - Modify flow logic if needed
    - Update interface settings
  </Accordion>
</AccordionGroup>


---

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Can I modify the agent after importing?">
    Yes, absolutely. Once imported, the agent is fully yours to customize:
    - Modify prompts, instructions, and configurations
    - Add or remove tools and integrations
    - Adjust variables and settings
    - Customize for your specific use case

    Your changes don't affect the original agent. Each import creates an independent copy.
  </Accordion>
  <Accordion title="Why did my import fail?">
    Common causes and solutions:

    **Invalid File Format:**
    - Ensure the file is a valid JSON export from Airia
    - File may have been corrupted during transfer
    - Re-download or request a new file

    **Version Incompatibility:**
    - Your platform version may not support all features
    - Update your platform or contact the sharer for compatibility

    **Link Already Used:**
    - Private links are one-time use
    - Request a new link if you need to re-import

    **Link Expired:**
    - Links expire after 7 days
    - Request a new link from the original creator
  </Accordion>
</AccordionGroup>

---

## Next Steps

- Need to share an agent? See [Share Your Agent Directly](./share-directly)
- Want to contribute to Community? See [Share Your Agent Publicly](./share-publicly)
- Review the [Sharing Overview](./overview)
