Getting Started

Get Expert up and running in three steps. By the end, you’ll have a working search endpoint your AI agents can call.

Quick setup

Create an Expert

Open your workspace dashboard, go to Expert, and create a new Expert instance. Give it a name that describes the knowledge domain (e.g., "Product Support" or "Onboarding").

Add at least 30 published bites

Expert requires a minimum of 30 published bites to activate. Each published bite is automatically indexed, no manual tagging or configuration needed.

Create an API key

In the Expert settings, generate an API key. This key authenticates all requests from your AI agents. Keep it secure, treat it like a password.

Your first search

Once you have an API key and 30+ published bites, test Expert with a curl request:

Terminal

curl -X POST https://expert.demobites.com/v2/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "How do I set up integrations?",
    "limit": 5
  }'

Understanding the response

Expert returns structured JSON with video matches, transcript segments, and confidence scores. Your AI agent uses this data to build its answer.

Response

{
  "results": [
    {
      "video_id": "abc123",
      "title": "Setting Up CRM Integration",
      "url": "https://hub.example.com/bites/crm-setup",
      "segments": [
        {
          "text": "Open Settings, then click Integrations...",
          "start_time": 15.2,
          "end_time": 28.7
        }
      ],
      "confidence": 0.94
    }
  ],
  "results_count": 3
}

video_id , Unique identifier for referencing or fetching full video details.

title / url , The bite title and its published URL for linking.

segments , Transcript excerpts with start and end timestamps in seconds.

confidence , Score from 0 to 1 indicating match quality. Higher is better.

What to do next

Now that you’ve confirmed Expert is working, connect it to your AI agents: