Skip to main content

Deploy Your Agents

This guide shows you how to deploy AI Agents with the videosdk-agents python package. Once your AI Agent is ready to use, you need to create an AI Worker. The AI Worker is responsible for running your AI Agent. Before proceeding, ensure you have completed the steps under Prerequisites.

Prerequisites​

To deploy your AI Worker, make sure you have:

YAML Configuration​

Create a videosdk.yaml file with the following structure:

version: "1.0"

worker:
id: your_worker_id
entry:
path: entry_point_for_worker

env: # Optional to run your agent locally
path: "./.env"

secrets:
VIDEOSDK_AUTH_TOKEN: your_auth_token

deploy:
cloud: true

Field Descriptions​

FieldDescription
worker.idThe workerId obtained from the Create AI Worker API.
worker.entry.pathPath to the entry point script for your AI Worker.
env.pathPath to your .env file, used only when running the agent locally.
secrets.VIDEOSDK_AUTH_TOKENYour VideoSDK auth token (required for deployment).
deploy.cloudSet to true to allow deploying the worker to VideoSDK Cloud, when using the deploy command. Use false to avoid accidental deploys.

CLI Commands​

  • Run the AI Worker locally for Testing.​
videosdk.agents run 
videosdk.agents deploy

Next Steps​

After deploying your AI Worker, you can start using it by:

  1. Creating a new session using the Start Session API
  2. Ending the session using the End Session API

Got a Question? Ask us on discord