Configuring Your Employee

After hiring an AI employee, you can fine-tune their configuration at any time. This guide covers all configuration options and best practices.

The employee configuration page with all settings sections

Accessing Configuration

1. Navigate to Employees in the sidebar (or press G then E)
2. Click on the employee you want to configure
3. Click Edit or Configure button

Click on an employee card to access its configuration

Configuration Sections

1. Basic Information

2. Model Configuration

Select which AI model powers your employee.

Model selection in employee configuration

Tip: You can change the model anytime. The change takes effect on the next response.

3. API Key Configuration

Your employee uses your included AI credits or your own API key.

API key configuration

Using Included Credits

Each employee slot includes AI credits (~16 million tokens per month). These are used automatically.

Using Your Own API Key

If you prefer to use your own API key:

1. Go to Settings → API Keys
2. Add your API key
3. Select it in the employee configuration

Select or add API keys for your employee

4. Channels Configuration

Configure communication channels

Configure how users communicate with your employee. See Employee Channels for detailed setup.

Active Channels:

• Toggle channels on/off
• Update credentials anytime
• Test connection before saving

5. Tools Configuration

Enable capabilities for your employee.

Built-in tools and MCP server configuration

Built-in Tools

Web Search

Execution Tools

MCP Tools (Marketplace & Custom)

Manage installed MCP tools

Browse and install additional tools that integrate with external services:

• Marketplace Tools — Pre-configured, one-click install
• Custom Tools — Your own MCP server configurations

See Tools, MCP Servers & Skills for complete MCP documentation.

6. Skills Configuration

Skills define your employee's knowledge and behavior through markdown instructions.

Manage and edit employee skills

Skill Types

Writing Effective Skills

Writing a customer support skill

# Customer Support Skill

## Your Role
You are a friendly customer support agent for [Company Name].

## Guidelines
- Always greet customers warmly
- Ask clarifying questions before providing solutions
- Escalate billing issues to human support
- Never share internal information

## Common Issues

### Password Reset
1. Verify customer identity
2. Send reset link to registered email
3. Confirm they received it

### Refund Requests
1. Check order status
2. If within 30 days, process refund
3. Otherwise, explain policy politely

Real-Time Updates

Configuration changes take effect immediately:

Configuration Best Practices

Do's

Don'ts

Saving and Validation

When you save configuration:

Configuration validation in progress

1. Validation runs — System checks all required fields
2. Token verification — Confirms no duplicate bot tokens
3. Connection test — Verifies channel connectivity
4. Sync to employee — Updates the running container

Common Validation Errors

Example of a validation error with suggested fix

Configuration Templates

Save your configurations as templates for quick reuse:

Save configuration as a reusable template

1. Configure an employee exactly how you want
2. Click Save as Template (if available)
3. Use this template when hiring new employees

Quick Reference

Next Steps

• Employee Channels — Detailed channel setup
• Tools, MCP Servers & Skills — Extend capabilities
• Managing Employees — Day-to-day management