agent_management

Agent Management Complete Guide

Overview

This Skill provides a complete management guide for OpenSquad Agents, covering the full workflow of creation, configuration, deployment, and troubleshooting.

Key Contents:

• Quick Agent creation (live in 5 minutes)
• Configuration file reference (model, role, tools)
• Architecture internals (process isolation, IM accounts)
• Troubleshooting and best practices

---

Note If the user does not specify a name when creating an agent, you may decide based on the task content. The account email can also be named in relation to the actual business. The password used when registering the account is the group password configured for the agent — remember it. You may configure a role card for the agent based on business needs.

Important — account registration is a separate step: agent_factory.create_agent only creates the directory structure and config file. It does not automatically register a chat account. You must call chat_account.register_account (Step 1) before creating the agent. The five-step flow below reflects the correct order. (As a fallback, if the agent process starts and the account does not yet exist, bridge.login() will attempt auto-registration at runtime — but you should not rely on this; always register the account explicitly first.)

Part 1: Quick Start

1. Five Steps to Create an Agent

Step 1: Register a ChatPro Account

Each Agent needs an independent account to log into the group chat system.

chat_account.register_account(
    email="mybot@ai",       # Account email, unique per Agent
    password="Bot@2026",    # Login password
    name="My Assistant"     # Display name
)

---

Step 2: Create or Join a Group

Create a new group:

chat_account.create_group(
    email="mybot@ai",           # Operating account email
    password="Bot@2026",        # Password
    group_name="AI Workspace"   # Group name
)
# Returns group_id, used when configuring config.json