POST /v1/agents

Create an agent

Creates a new AI agent with the specified configuration.

Creates a new agent object. After creation, the agent will be in an active state and ready to process requests.

Request Body

name required

string

A human-readable name for the agent. Maximum 100 characters.

model required

string

The AI model to use. One of: gpt-4, gpt-4-turbo, gpt-3.5-turbo, claude-3-opus, claude-3-sonnet.

description

string

An optional description of what the agent does. Maximum 500 characters.

system_prompt

string

The system prompt that defines the agent behavior and personality.

tools

array

An array of tool IDs the agent can use. Tools must be created separately.

metadata

object

Set of key-value pairs for storing additional information. Maximum 50 keys, 500 characters per value.

Response

Returns the created agent object if successful. Returns an error if the request fails validation or if you have exceeded your agent quota.

Request

curl https://api.celeriscloud.io/v1/agents \
  -H "Authorization: Bearer cel_live_xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Support Bot",
    "model": "gpt-4",
    "description": "Handles customer inquiries",
    "system_prompt": "You are a helpful customer support agent..."
  }'import celeris

client = celeris.Client("cel_live_xxxx")

agent = client.agents.create(
    name="Customer Support Bot",
    model="gpt-4",
    description="Handles customer inquiries",
    system_prompt="You are a helpful customer support agent..."
)import Celeris from 'celeris';

const celeris = new Celeris('cel_live_xxxx');

const agent = await celeris.agents.create({
  name: 'Customer Support Bot',
  model: 'gpt-4',
  description: 'Handles customer inquiries',
  systemPrompt: 'You are a helpful customer support agent...'
});import "github.com/celeris/celeris-go"

client := celeris.NewClient("cel_live_xxxx")

agent, err := client.Agents.Create(&celeris.AgentParams{
    Name:         "Customer Support Bot",
    Model:        "gpt-4",
    Description:  "Handles customer inquiries",
    SystemPrompt: "You are a helpful customer support agent...",
})

Response 201 Created

{
  "id": "agt_1234567890abcdef",
  "object": "agent",
  "name": "Customer Support Bot",
  "model": "gpt-4",
  "description": "Handles customer inquiries",
  "system_prompt": "You are a helpful customer support agent...",
  "status": "active",
  "tools": [],
  "metadata": {},
  "created_at": "2024-01-31T10:30:00Z",
  "updated_at": "2024-01-31T10:30:00Z"
}