npx skills add ...
npx skills add runwayml/skills --skill rw-integrate-documents
npx skills add runwayml/skills --skill rw-integrate-documents
Help users add knowledge base documents to Runway Characters for domain-specific conversations
PREREQUISITE: Run
+rw-check-compatibilityfirst. Run+rw-fetch-api-referenceto load the latest API reference before integrating.+rw-setup-api-key— API credentials must be configuredUSED BY:
+rw-integrate-characters— Documents are linked to Avatars to give them domain-specific knowledge
Give your Characters access to domain-specific knowledge. Upload content that your Avatar can reference during conversations for accurate, contextual responses.
| Use Case | Example Content |
|---|---|
| Customer support | FAQs, product info, company policies, return procedures |
| Quizzes & games | Question banks, correct answers, scoring rules |
| Education | Course material, reference content, learning objectives |
| Brand experiences | Brand guidelines, messaging, product catalogs |
The flow is: Create a Document → Link it to an Avatar
Update your Avatar to attach the document. This replaces any existing document attachments — pass all document IDs you want linked.
You can link multiple documents to a single avatar (total must stay under 50,000 tokens):
Once documents are linked, the Avatar automatically has access to the knowledge during conversations. Start a session as usual — no additional configuration needed:
See +rw-integrate-characters for the full session creation, polling, and WebRTC flow.
Read content from local files and create documents:
Update documents programmatically — useful for syncing with a CMS or database:
from runwayml import RunwayML
client = RunwayML()
document = client.documents.create(
name='Product FAQ',
content="""# Product FAQ
## What is your return policy?
We offer a 30-day return policy for all unused items in original packaging.
## How do I track my order?
Log in to your account and visit the Orders page.
## Do you offer international shipping?
Yes, we ship to over 50 countries.""",
)
print('Document created:', document.id)await client.avatars.update(avatarId, {
documentIds: [document.id],
});client.avatars.update(
avatar_id,
document_ids=[document.id],
)const faq = await client.documents.create({
name: 'FAQ',
content: '...',
});
const policies = await client.documents.create({
name: 'Company Policies',
content: '...',
});
await client.avatars.update(avatarId, {
documentIds: [faq.id, policies.id],
});const session = await client.realtimeSessions.create({
model: 'gwm1_avatars',
avatar: {
type: 'custom',
avatarId: avatarId,
},
});session = client.realtime_sessions.create(
model='gwm1_avatars',
avatar={
'type': 'custom',
'avatar_id': avatar_id,
},
)import fs from 'fs';
import RunwayML from '@runwayml/sdk';
const client = new RunwayML();
// Read a local markdown file
const content = fs.readFileSync('./knowledge/product-faq.md', 'utf-8');
const document = await client.documents.create({
name: 'Product FAQ',
content,
});from pathlib import Path
from runwayml import RunwayML
client = RunwayML()
content = Path('./knowledge/product-faq.md').read_text()
document = client.documents.create(
name='Product FAQ',
content=content,
)// Example: API endpoint to update character knowledge
app.post('/api/avatar/update-knowledge', async (req, res) => {
const { avatarId, documents } = req.body;
// Create new documents
const docIds = [];
for (const doc of documents) {
const created = await client.documents.create({
name: doc.name,
content: doc.content,
});
docIds.push(created.id);
}
// Link all documents to the avatar (replaces existing)
await client.avatars.update(avatarId, {
documentIds: docIds,
});
res.json({ success: true, documentCount: docIds.length });
});