Working with Agents

Agents are the core building blocks of Aethyr. Learn how to create, configure, and orchestrate AI agents for your workflows.

Creating Agents

Agents can be created through the Console UI or programmatically via the API. Each agent has a unique configuration that determines its behavior.

Via Console UI

Navigate to Agents in the sidebar
Click Create Agent
Fill in the agent details (name, model, system prompt)
Configure tools and capabilities
Save the agent

Via API

POST /api/agents

fetch('/api/agents', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    name: 'Research Assistant',
    model: 'gpt-4',
    systemPrompt: 'You are a helpful research assistant...',
    temperature: 0.7,
    tools: ['web_search', 'document_analysis']
  })
})

Agent Configuration

Property	Type	Description
name	string	Display name for the agent
model	string	Model ID (e.g., gpt-4, claude-3, llama3)
systemPrompt	string	Instructions that define agent behavior
temperature	number	Creativity level (0-2, default 0.7)
tools	string[]	MCP tools the agent can use
maxTokens	number	Maximum response length
knowledgeBase	string	RAG corpus ID for context retrieval

Multi-Agent Workflows

Aethyr supports multi-agent orchestration where multiple specialized agents collaborate on complex tasks. Agents can be chained, run in parallel, or coordinate through a supervisor agent.

Sequential

Agents execute in order, each receiving the output of the previous agent.

Parallel

Multiple agents work simultaneously on different aspects of a task.

Supervisor

A coordinator agent delegates tasks to specialized sub-agents.

Example: Research Workflow

workflow.ts

// Define a multi-agent research workflow
const workflow = {
  name: 'Research Pipeline',
  agents: [
    {
      id: 'researcher',
      role: 'Gather information from sources',
      tools: ['web_search', 'document_reader']
    },
    {
      id: 'analyst', 
      role: 'Analyze and synthesize findings',
      tools: ['data_analysis']
    },
    {
      id: 'writer',
      role: 'Create final report',
      tools: ['document_generator']
    }
  ],
  flow: 'sequential' // researcher → analyst → writer
}