Skip to main content

Creating an Actor

This page walks you through the full lifecycle of creating an Actor: writing the YAML definition, uploading it to CleverThis, and deploying it to a namespace so it is callable as a model.

1. Write the Actor YAML​

Create a file named my-actor.yaml. The minimal viable Actor is a single llm agent with a system prompt:

name: my-actor
version: "1.0.0"

agents:
  - id: main
    type: llm
    model: openai/gpt-4o-mini
    system_prompt: |
      You are a helpful assistant specializing in concise, accurate answers.
      Keep responses under 3 sentences unless the user asks for more detail.

routes:
  entry: main
  stream: true

See Actor YAML Format for an overview of all available fields, or the Actor Configuration Standard for the full spec.

2. Upload the Actor​

  1. Navigate to Library → Models and click Upload Actor (top-right).
  2. Select your .yaml file or paste the YAML into the editor.
  3. CleverThis validates the YAML and reports any errors inline.
  4. Click Save Actor. The Actor appears in the Models list tagged as "Actor".

3. Deploy to a namespace​

  1. Click your new Actor's card in the Models list.
  2. Click Deploy to Namespace.
  3. Select the target namespace and optionally set an endpoint alias.
  4. Click Deploy. The deployment status becomes running within a few seconds.

4. Test your Actor​

Navigate to Chat in the sidebar. Switch the model selector to your Actor (it will appear by its deployment slug). Send a message. See Testing Actors for more detailed testing workflows.

Coming soon

CLI upload (ct actors push my-actor.yaml) documentation is being added alongside the CLI reference.