> ## Documentation Index
> Fetch the complete documentation index at: https://docs.artaios.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Playground

> Build, test, and refine your agents in real-time

The Playground is where you create and test agents. It's split into two main areas: the YAML editor on the left and the chat interface on the right.

![Playground Interface](https://mintcdn.com/arttacsolutions/exBco3_ad4-G0WEa/images/playground_interface.png?fit=max\&auto=format\&n=exBco3_ad4-G0WEa\&q=85\&s=e0410e19d0d432593e2fceac2389bc08)

## Interface Overview

### Left Side: YAML Editor

This is where you write your agent configuration. You'll see:

* **Agents count badge**: Shows how many agents are in your config
* **Tools count badge**: Shows which tools are configured
* **Version dropdown**: Switch between saved versions (when editing an agent)
* **Toolbar buttons**: Load Config, Save Agent, Generate Config

> [!NOTE]
>
> **Learning YAML syntax?** See the [YAML Configuration](https://docs.artaios.ai/amas/yaml-configuration.md) guide for complete syntax reference

### Right Side: Agent Preview

Test your agent here:

* **Connection status**: Shows if your config is loaded
* **Chat interface**: Send messages to test your agent
* **Streaming responses**: See agent responses in real-time

## Building Your First Agent

**1. Start with a Template**

Click **Load Config** in the toolbar

![Load Config Dialog](https://mintcdn.com/arttacsolutions/exBco3_ad4-G0WEa/images/load_agents.png?fit=max\&auto=format\&n=exBco3_ad4-G0WEa\&q=85\&s=f9d02d7c58363276eacf2eb1b23012ab)

Select **"Basic Dynamic Agent Test"** to get a simple working agent

**2. Load the Configuration**

After selecting a template, click **Load Configuration**

Wait for the connection status to show "Connected" in green

**3. Test Your Agent**

Type a message in the chat interface on the right

Your agent will respond using the configuration you loaded

**4. Modify the Config**

Edit the YAML on the left side. Try changing:

* `system_prompt`: Change how the agent behaves
* `temperature`: Adjust creativity (0.0 = focused, 1.0 = creative)
* `max_tokens`: Control response length

> [!NOTE]
>
> **Want to understand all configuration options?** Check:
>
> * [Agent Types](https://docs.artaios.ai/amas/agent_config/types_config/agent-types.md) - Different agent architectures
> * [Model Selection](https://docs.artaios.ai/amas/agent_config/types_config/model-selection.md) - LLM configuration
> * [Prompt Configuration](https://docs.artaios.ai/amas/agent_config/types_config/prompt-configuration.md) - System prompts and templates

**5. Reload and Test**

Click **Load Configuration** again to apply your changes

Test with the same message to see the difference

## Using the AI Config Generator

Don't want to write YAML from scratch? Use the AI generator.

**1. Open the Generator**

Click **✨ Generate Config** in the toolbar

![Config Generator Modal](https://mintcdn.com/arttacsolutions/exBco3_ad4-G0WEa/images/config_generator.png?fit=max\&auto=format\&n=exBco3_ad4-G0WEa\&q=85\&s=4ca8dce180988ca1b91dbfffb019519e)

**2. Describe Your Agent**

Type what you want your agent to do. For example:

```
Extract name, email, and phone number from business cards and meeting notes
```

Be specific about what data you need and what the agent should do

**3. Generate**

Click **Generate Config** and wait a few seconds

![Generated Configuration](https://mintcdn.com/arttacsolutions/exBco3_ad4-G0WEa/images/generated_config.png?fit=max\&auto=format\&n=exBco3_ad4-G0WEa\&q=85\&s=beb63aa38f8de7a2bda6954b62edbaf8)

The AI will create a complete YAML configuration

**4. Review and Load**

The generated YAML appears in your editor

Review it, then click **Load Configuration** to test it

> [!TIP]
>
> **Need help writing descriptions?** Check out the [AI Config Generator guide](https://docs.artaios.ai/amas/studio/ai-config-generator.md) for tips and examples

## Adding Tools and Prompts

Click the **+** button in the toolbar to quickly insert configurations:

![Insert Tool or Prompt](https://mintcdn.com/arttacsolutions/exBco3_ad4-G0WEa/images/add_prompt_tool.png?fit=max\&auto=format\&n=exBco3_ad4-G0WEa\&q=85\&s=ea4a180b72f91031be2a22c4110f9ecd)

### Insert Tool

Adds a sample tool configuration at your cursor position

**→ [Tools Configuration](https://docs.artaios.ai/amas/studio/tools.md)** - Available tools and setup

### Insert Prompt

Inserts a prompt reference from your prompt library

**→ [Prompt Configuration](https://docs.artaios.ai/amas/agent_config/types_config/prompt-configuration.md)** - Advanced prompt features and variables

> [!NOTE]
>
> To add knowledge bases to your agent, manually configure them in the YAML. See the [Knowledge Base Setup](https://docs.artaios.ai/amas/agent_config/knowledge-base-setup.md) guide for YAML syntax.

This helps you quickly add tools and prompts without typing them manually.

## Saving Your Agent

Once you're happy with your agent:

**1. Click Save as Agent**

This opens a dialog to name your agent

**2. Give it a Name**

Choose a clear, descriptive name like "Resume Parser" or "Support Ticket Router"

**3. Save**

Your agent is now saved and appears in **Agent Overview**

> [!TIP]
>
> Saved agents can be accessed via API, deployed as chatbots, or further refined

## Working with Versions

When you save changes to an existing agent, it creates a new version. The version dropdown appears in the Playground toolbar when editing an agent:

### Version Controls

**Green checkmark (✓)**: Current version (deployed and active)

**Yellow scroll (📜)**: Historical version (viewing only)

### Switching Versions

1. Click the version dropdown in the toolbar
2. Select a version to view
3. To make it active, go to **Agent Overview** → **Settings** → **Versions** → **Deploy**

> [!WARNING]
>
> When viewing a historical version, you're in read-only mode. Any changes will create a new version when saved

## Tips for Effective Testing

> [!TIP]
>
> **Test edge cases**: Try unusual inputs, very long messages, and questions your agent shouldn't answer

> [!TIP]
>
> **Use the Load Config button**: After every YAML change, click "Load Configuration" to apply changes. The chat won't update automatically

> [!TIP]
>
> **Watch the badges**: The Agents and Tools badges show what's configured. Hover to see names

> [!TIP]
>
> **Start simple**: Get a basic agent working first, then add complexity (knowledge bases, tools, structured output)

## Common Issues

> [!WARNING]
>
> **"Connection failed"**: Your YAML has errors. Check for typos, missing colons, or incorrect indentation

> [!WARNING]
>
> **"Agent not responding"**: Make sure you clicked "Load Configuration" after making changes

> [!TIP]
>
> **YAML indent errors**: Use 2 spaces for indentation, not tabs. Be consistent with spacing

## What's Next?

> **[YAML Configuration](https://docs.artaios.ai/amas/yaml-configuration.md)**
>
> Complete YAML syntax reference

> **[Agent Types](https://docs.artaios.ai/amas/agent_config/types_config/agent-types.md)**
>
> LLM agents, ReAct agents, and workflows

> **[Knowledge Base Setup](https://docs.artaios.ai/amas/agent_config/knowledge-base-setup.md)**
>
> Configure RAG and retrieval settings

> **[Structured Output](https://docs.artaios.ai/amas/advanced/structured-output.md)**
>
> Extract structured data from agents


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.