Videos
The Videos page is where you add video entries to your agent's knowledge base. The agent does not process raw video files — instead it uses the transcript associated with each video entry as its searchable text. This makes video content discoverable and citable alongside documents and websites.
Navigate to Resources → Videos in the left sidebar.
Managing the Videos List
The list displays video entries as cards (grid view) or rows (list view). Use the view toggle to switch between them.
Each video card shows:
| Field | Description |
|---|---|
| Thumbnail | Cover image from URL or uploaded image; fallback thumbnail if none provided |
| Status badge | Processing state: Draft → Pending → Processing → Processed or Failed |
| Title | The video's display name |
| Tag | Video type label (Upload Video, YouTube Video, or Online Video) |
| Code | A short unique identifier for the video entry |
| Author | The attributed author, if assigned |
| Progress | Processing progress indicator during indexing |
Use Search Videos to filter by title, code, author, type, or status. Use the Sort By controls in the top-right to change the sort order.
Creating a New Video
Click New Video in the top-left of the page. You are first asked to select a video type before filling in the form.
Video Types
There are three video types. Each type differs in how the video source is provided and what fields are required.
Upload Video
Use this type when you have a video file saved on your computer that you want to upload directly.
How it works: You upload the video file from your local machine. The system stores the file temporarily, extracts the audio, transcribes it using the languages you selected, then discards the original file after processing is complete.
Required fields:
| Field | Description |
|---|---|
| File | The video file to upload. Accepted formats: MP4, AVI, MOV, MKV, WMV, WEBM, M4V. Check Video Guidelines in the form for the maximum allowed duration. |
| Ingestion Mode | How the transcript is split into searchable chunks. See Ingestion Modes below. |
| Languages | Languages to use for transcription. Select up to 4. Default: English (US) and Indonesian. |
| Title | Display name for the video. |
| Author | Author registered in the system. |
| Code | A unique identifier for this video. Must be unique within your agent. Cannot be changed after creation. |
Optional fields:
| Field | Description |
|---|---|
| Video Source | A link to the original source or location of the video (e.g., an internal CDN link). Used for reference only — not processed. |
| Thumbnail Source | A cover image shown in the video list. Provide a URL or upload an image file. |
| Permissions | Restrict video access to users who hold specific permission codes. Leave empty to make the video accessible to all users. |
YouTube Video
Use this type when the video is published on YouTube and you want the YouTube URL to appear as the citation link in conversations.
How it works: You provide the YouTube URL and upload the corresponding video file. The YouTube URL is stored as the citation reference — when the agent cites this video in a conversation, it links users back to the YouTube page. The uploaded file is used for transcription and is discarded after processing.
Click Get Metadata after entering the YouTube URL to automatically fill in the video title and thumbnail from YouTube.
Required fields:
| Field | Description |
|---|---|
| Video Source | The full YouTube video URL (e.g., https://www.youtube.com/watch?v=...). Click Get Metadata to auto-fill title and thumbnail. |
| File | The video file to upload for transcription. Download the video from YouTube first, then upload it here. Accepted formats: MP4, AVI, MOV, MKV, WMV, WEBM, M4V. |
| Ingestion Mode | How the transcript is split into searchable chunks. See Ingestion Modes below. |
| Languages | Languages to use for transcription. Select up to 4. Default: English (US) and Indonesian. |
| Title | Display name for the video (auto-filled via Get Metadata). |
| Author | Author registered in the system. |
| Code | A unique identifier for this video. Must be unique within your agent. Cannot be changed after creation. |
Optional fields:
| Field | Description |
|---|---|
| Thumbnail Source | Cover image. Auto-filled from YouTube when using Get Metadata, or provide your own URL or upload a file. |
| Permissions | Restrict video access to users who hold specific permission codes. Leave empty to make the video accessible to all users. |
Online Video
Use this type when the video is hosted at a publicly accessible URL — for example, a video on your CDN, a company server, or any direct video link.
How it works: You provide the URL pointing directly to the video file (e.g., https://cdn.example.com/video.mp4). The system downloads and processes the video from that URL, extracts the audio, transcribes it, then indexes the transcript. No file upload is required.
Required fields:
| Field | Description |
|---|---|
| Video Source | Direct URL to the video file (e.g., https://example.com/video.mp4). Must be publicly accessible. |
| Ingestion Mode | How the transcript is split into searchable chunks. See Ingestion Modes below. |
| Languages | Languages to use for transcription. Select up to 4. Default: English (US) and Indonesian. |
| Title | Display name for the video. |
| Author | Author registered in the system. |
| Code | A unique identifier for this video. Must be unique within your agent. Cannot be changed after creation. |
Optional fields:
| Field | Description |
|---|---|
| Thumbnail Source | A cover image shown in the video list. Provide a URL or upload an image file. |
| Permissions | Restrict video access to users who hold specific permission codes. Leave empty to make the video accessible to all users. |
Ingestion Modes
When you add a video, you choose an Ingestion Mode that controls how the system splits the transcript into searchable chunks. Two modes are available for videos.
Not sure which to pick? Choose Skimming. It works well for most video types and preserves the natural structure of the transcript.
Semantic
The simplest mode. The transcript is split at natural sentence boundaries into evenly sized chunks. Each chunk overlaps slightly with the previous one so context is not lost at the edges.
Best for
- Conversational or unstructured videos — interviews, Q&A sessions, podcasts
- Short videos or videos with no clear chapters
- Any video when you are unsure which mode to use
Parameters
| Parameter | Description |
|---|---|
| Content Size | Maximum number of tokens per chunk. Larger values produce fewer, longer chunks. Default: 500. |
| Start Page | First segment to process. Leave blank to start from the beginning. |
| Finish Page | Last segment to process. Leave blank to process to the end. |
Skimming
Detects the transcript's chapter and section structure using AI, then creates one chunk per section — each chunk is titled with the full path of headings. Sections that are too small are automatically merged with their neighbours; sections that are too large are split at semantic boundaries.
Best for
- Long-form videos with clear structure — lectures, tutorials, training materials
- Videos with chapter markers or distinct topic segments
- Any video where preserving section titles in search results matters
Parameters
| Parameter | Description |
|---|---|
| Video Training AI Model | The AI model used to analyse the transcript structure. Required for this mode. |
Advanced Parameters (optional)
| Parameter | Description |
|---|---|
| Page Overlap | Number of segments shared between adjacent processing passes. Helps detect section boundaries that span pass edges. Default: 2. |
| Keep Small Sections Separate | When on, small sections are not merged with their neighbours. |
| Minimum Section Size | Sections with fewer tokens than this value are merged with an adjacent section. Only applies when Keep Small Sections Separate is off. |
Languages
The Languages field controls which languages are used when transcribing the video audio.
- Select up to 4 languages. The system attempts transcription in each selected language and uses the best result.
- Default: English (United States) and Indonesian (Indonesia).
- Over 100 languages are available.
- At least one language must be selected.
Choosing languages that match the actual spoken language of the video produces the most accurate transcript and therefore the best search results.
Permissions
The Permissions field restricts which users can receive answers sourced from this video.
- Leave empty to make the video accessible to all users.
- Select one or more permission codes to restrict access to users who hold a matching permission.
- Available permission codes are defined by your agent's settings. If no permissions are configured in the agent, this field has no effect.
When a user asks a question, the agent only retrieves chunks from videos the user is permitted to access.
How Videos Appear in Conversations
Once a video is fully processed (status: Processed), the agent can cite it in conversations. When the agent uses a video chunk to answer a question, the chat interface shows:
- The video thumbnail
- The video title and attributed author
- A section link — clicking it opens the video at the relevant timestamp
Multiple chunks from the same video are grouped together and displayed in a carousel.
Deactivating and Activating a Video
A fully processed video (status: Processed) can be deactivated to prevent the agent from using it in responses, without permanently deleting it. A deactivated video can be reactivated at any time.
Deactivate a video
- Open the video detail page.
- Click Deactivate in the top-right action bar.
- The video status changes to Suspended. The agent will no longer reference this video.
Activate a video
- Open the detail page of a suspended video.
- Click Activate in the top-right action bar.
- The video status returns to Processed and becomes available to the agent again.
Delete a video permanently
A suspended video can be permanently deleted.
- Open the detail page of a suspended video.
- Click Delete in the top-right action bar.
- Confirm the deletion. The video and all its indexed chunks are permanently removed and cannot be recovered.
To delete a video that is still Processed, deactivate it first, then delete it.
Retry Chunking
If processing fails or produces poor results, you can reprocess the video without deleting and re-adding it.
- Open the video detail page.
- Click Retry Chunking in the top-right action bar.
- Type the video title to confirm.
- The system reprocesses the transcript from scratch.
Related pages
- Documents — upload file-based knowledge sources
- Websites — extract web page content as knowledge
- Permissions — configure permission codes for your agent
- Search Chunks — inspect the text units the agent retrieves from your video transcripts
- Citations — manage authors and citation display settings