AgentScope AI Init

AgentScope AI provides a streamlined initialization process for setting up a local development environment. This guide will walk you through initializing AgentScope AI, setting up the necessary dependencies, and configuring your development workspace.

Prerequisites

Before initializing AgentScope AI, ensure that your system meets the following requirements:

• Node.js (version 16 or later)

• npm or yarn (latest stable version)

• Docker (for containerized development)

• Git (for repository management)

Installing AgentScope AI CLI

To begin, install the AgentScope AI CLI tool, which facilitates initialization and management.

npm install -g @agentscope/cli

Verify the installation by running:

agentscope --version

Initializing a New Project

Once the CLI is installed, you can create a new AgentScope AI project by running:

agentscope init my-project

This command will prompt you to provide:

• Project Name

• Default Configuration (Yes/No)

• Database Connection (if applicable)

Project Structure

After initialization, your project will have the following structure:

my-project/
│── agentscope.config.js  # Main configuration file
│── src/
│   ├── agents/           # Agent definitions
│   ├── tools/            # Custom tool implementations
│   ├── workflows/        # Workflow automation
│── tests/                # Unit and integration tests
│── package.json          # Project dependencies
│── README.md             # Project documentation

Running the Development Server

To start the local development environment, navigate into your project directory and execute:

cd my-project
agentscope start

This will launch the AgentScope AI runtime, allowing you to develop, test, and iterate locally.

Configuration and Environment Variables

AgentScope AI supports environment variables for configuring integrations and settings. Create a .env file in your project root and define required values:

AGENTSCOPE_API_KEY=your-api-key-here
DATABASE_URL=postgres://user:password@localhost:5432/mydb

Load environment variables by restarting the AgentScope service:

agentscope restart

Debugging and Logs

For real-time debugging and log monitoring, use:

agentscope logs --tail

Next Steps

Once your development environment is set up, explore the following features:

• Creating Custom Agents

• Defining and Using Tools

• Automating Workflows