00-creating-agents

Creating Agents

The SmythOS SDK offers flexible ways to create and configure agents. This guide covers everything from basic agent creation to advanced model configuration.

The example scripts in examples/01-agent-code-skill, examples/02-agent-smyth-file, and examples/03-agent-workflow-components provide hands-on illustrations of all the concepts covered here.

Code-Based Agent Creation

You can define agents programmatically by instantiating the Agent class with configuration options:

import { Agent } from '@smythos/sdk';

const agent = new Agent({
    id: 'crypto-assistant', // Optional: unique identifier
    name: 'CryptoMarket Assistant',
    behavior: 'You are a crypto price tracker...',
    model: 'gpt-4o', // The language model to use
});

Configuration Options:

• id (optional): A unique identifier for the agent. Useful for persistence and tracking.
• name: A descriptive name for the agent.
• behavior: Instructions that define the agent's persona and role.
• model: The language model to use (see Model Configuration below).
• mode (optional): Agent execution mode. See Agent Modes.

Importing from .smyth Files

For complex agents with visual workflows created in the SmythOS Builder, you can import pre-configured .smyth files:

import { Agent, Model } from '@smythos/sdk';
import path from 'path';

const agentPath = path.resolve(__dirname, './my-agent.smyth');

const agent = Agent.import(agentPath, {
    model: 'gpt-4o', // Override the model
    teamId: 'team-123', // Optional: specify team context
});

The .smyth file format allows you to define complex workflows with multiple components, skills, and integrations visually, then import them into your code with full programmatic control.