# Rw Integrate Documents

> Help users add knowledge base documents to Runway Characters for domain-specific conversations

- **Type:** Skill
- **Install:** `agentstack add skill-runwayml-skills-rw-integrate-documents`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [runwayml](https://agentstack.voostack.com/s/runwayml)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [runwayml](https://github.com/runwayml)
- **Source:** https://github.com/runwayml/skills/tree/main/skills/rw-integrate-documents

## Install

```sh
agentstack add skill-runwayml-skills-rw-integrate-documents
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Integrate Documents (Knowledge Base)

> **PREREQUISITE:** Run `+rw-check-compatibility` first. Run `+rw-fetch-api-reference` to load the latest API reference before integrating. `+rw-setup-api-key` — API credentials must be configured
>
> **USED 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.

## When to Use Documents

| 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 |

## Constraints

- Each Avatar supports up to **50,000 tokens** of knowledge
- Supported formats: **plain text** and **Markdown**
- More formats planned for future releases

## Flow

The flow is: **Create a Document** → **Link it to an Avatar**

## Step 1: Create a Document

### Node.js

```javascript
import RunwayML from '@runwayml/sdk';

const client = new RunwayML();

const document = await 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. You'll find tracking information for all shipped orders.

## Do you offer international shipping?
Yes, we ship to over 50 countries. Shipping costs and delivery times vary by destination.`,
});

console.log('Document created:', document.id);
```

### Python

```python
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)
```

## Step 2: Link the Document to an Avatar

Update your Avatar to attach the document. **This replaces any existing document attachments** — pass all document IDs you want linked.

### Node.js

```javascript
await client.avatars.update(avatarId, {
  documentIds: [document.id],
});
```

### Python

```python
client.avatars.update(
    avatar_id,
    document_ids=[document.id],
)
```

### Multiple Documents

You can link multiple documents to a single avatar (total must stay under 50,000 tokens):

```javascript
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],
});
```

## Step 3: Start a Session

Once documents are linked, the Avatar automatically has access to the knowledge during conversations. Start a session as usual — no additional configuration needed:

```javascript
const session = await client.realtimeSessions.create({
  model: 'gwm1_avatars',
  avatar: {
    type: 'custom',
    avatarId: avatarId,
  },
});
```

```python
session = client.realtime_sessions.create(
    model='gwm1_avatars',
    avatar={
        'type': 'custom',
        'avatar_id': avatar_id,
    },
)
```

See `+rw-integrate-characters` for the full session creation, polling, and WebRTC flow.

## Integration Patterns

### Load Documents from Files

Read content from local files and create documents:

```javascript
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,
});
```

```python
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,
)
```

### Dynamic Knowledge Updates

Update documents programmatically — useful for syncing with a CMS or database:

```javascript
// 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 });
});
```

## Tips

- **Use Markdown** for structured content — headings help the Avatar navigate the knowledge.
- **Be concise** — stay well under the 50,000 token limit for best retrieval quality.
- **Organize by topic** — multiple focused documents work better than one giant document.
- **Update regularly** — keep knowledge current by re-creating documents when content changes.
- Documents can also be managed via the [Developer Portal](https://dev.runwayml.com/) UI.

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [runwayml](https://github.com/runwayml)
- **Source:** [runwayml/skills](https://github.com/runwayml/skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** yes
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-runwayml-skills-rw-integrate-documents
- Seller: https://agentstack.voostack.com/s/runwayml
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.