Getting Started with Agents App

The Agents App is your central hub for managing and orchestrating AI agents within FlowState. This guide will help you set up and configure the app for first-time use.

Prerequisites

Before using the Agents App, ensure you have:

• A FlowState account with appropriate permissions
• At least one workspace configured in your organization
• Access to the Agents App (contact your administrator if access is not available)
• A modern browser (Chrome, Firefox, Safari, or Edge)

Accessing the App

1. Open FlowState in your browser
2. Navigate to the App Launcher from the sidebar
3. Click on Agents to launch the app

Alternatively, navigate directly to /agents in your FlowState instance.

Initial Setup

Step 1: Review the Dashboard

When you first open the Agents App, you'll see the main dashboard displaying:

• Active Workers: Number of agents currently processing tasks
• Task Queue: Tasks waiting to be picked up by agents
• Pending Approvals: Agent outputs awaiting your review
• 24-Hour Success Rate: Recent agent performance metrics

Step 2: Configure Your First Codebase

Agents work within codebases. To set up your first codebase:

1. Navigate to Codebases in the sidebar
2. Click New Codebase
3. Fill in the codebase details:
   • Name: A descriptive name for the repository
   • Description: What this codebase is for
   • Path: The repository path or URL
4. Click Save

Step 3: Create Your First Task

With a codebase configured, you can now create tasks for agents:

1. From the Dashboard, click New Task
2. Enter a clear, descriptive task title
3. Provide detailed instructions in the description
4. Select the target codebase (if applicable)
5. Click Create

The task will enter the queue and be picked up by an available agent.

Step 4: Configure Approval Workflows

For tasks requiring human review:

1. Navigate to Approvals in the sidebar
2. Review the approval settings
3. Pending approvals will appear here as agents complete work

Understanding the Interface

Sidebar Navigation

Task Status Colors

Next Steps

Once you've completed the initial setup:

• Explore Features to learn about all capabilities
• Follow the Creating an Agent workflow guide
• Review the FAQ for answers to common questions
• Check Troubleshooting if you encounter issues

Quick Tips

1. Monitor the Dashboard regularly - It provides real-time insights into agent activity
2. Review approvals promptly - Pending approvals block agent workflow continuation
3. Use clear task descriptions - Well-defined tasks lead to better agent outputs
4. Check logs when debugging - The log viewer provides detailed execution traces
5. Organize by codebase - Group related work within codebases for better organization