---
title: "Create a Roleplay Agent from a File or Resource"
url: "https://help.outdoo.ai/en/article/create-a-roleplay-agent-from-file-or-resource"
language: "en"
last_updated: "2026-11-10T16:34:55.341Z"
---

# Create a Roleplay Agent from a File or Resource

Learn how to create and fine-tune AI roleplay agents using uploaded files and documents to ensure agent behavior aligns with your specific source material and training guidelines.

You can ground a new roleplay agent in a document from your Resources library, such as a pricing guide, product sheet or playbook. You can also use a resource later to fine-tune an existing agent, so its behavior stays aligned with your source material and not only a free-form prompt.

[YouTube video](https://www.youtube.com/embed/mL018sMBnhI)

[Watch: Create AI Roleplay Agents from Documents](https://www.youtube.com/watch?v=mL018sMBnhI)

## Create a roleplay agent using a file

Go to **Practice > Roleplay Agents**, click **Create Roleplay Agent** and choose **Create Single Agent**. Pick the **Roleplay Type** and **Scenario** on the **Create a Roleplay Agent** page. Both are required.

![Resources settings page listing uploaded playbooks and documents](https://cdn.prod.website-files.com/666fdec617b81d256ca8f1ca/6a7d869c8a47fb0c26d4109c_manage-resources.avif)

*The Resources library, where uploaded playbooks and documents are stored and can be attached to an agent during creation.*

Click **Add Context > From Resources** and choose a document from your Resources library. You can attach one resource per agent. Then write the prompt so it's clear how the resource should be used (for example, "Follow the attached pricing guardrails."). Click **Create Agent**, review the agent on its details page, and run a test with **Try Out Agent** before you publish. **Try Out Agent** needs a saved draft with no unsaved changes, so click **Save Draft** first if you edit the agent. Only one resource can be added: if you try to add another, a message tells you to remove the current one first.

To add a new document to the library first, see [Managing Resources](https://help.outdoo.ai/en/article/managing-resources).

## Fine-tune an agent with a resource

Open the existing agent from **Practice > Roleplay Agents**. On its details page, use the **Fine-Tune with AI** panel on the right. Click **Add Context > From Resources** and pick the resource, then describe the change you want, for example "Use the objections in the attached battlecard." You can also click **From Calls with This Agent** to add context from calls. The **Try Asking** suggestions show examples of what to type.

Fine-tuning works only on a saved draft. If the agent is new or has unsaved changes, the panel asks you to click **Save Draft** first. Each change creates a new draft, and the drafts drop-down at the top of the panel lets you switch between them. Review the result and test it with realistic scenarios before you publish.

Hope this article was helpful. For any queries, please write to [support@outdoo.ai](mailto:support@outdoo.ai)

## Related articles

-   [Create a Roleplay Agent from a Prompt](https://help.outdoo.ai/en/article/create-a-roleplay-agent-from-a-prompt)
-   [Creating a Roleplay Agent: All the ways to do it](https://help.outdoo.ai/en/article/roleplay-agent-creation-overview)
-   [Managing resources](https://help.outdoo.ai/en/article/managing-resources)
