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.

Watch: Create AI Roleplay Agents from Documents

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

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.

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