# AgentScope-skill-ai

**Repository Path**: billho/agent-scope-skill-ai

## Basic Information

- **Project Name**: AgentScope-skill-ai
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Agent Skill Demo

A Web application demonstrating AgentScope Java with dynamic Skill loading and AG-UI Protocol support.

## Features

- **Web Interface**: Modern chat interface with real-time streaming
- **AG-UI Protocol**: Standard protocol for frontend-backend communication
- **Dynamic Skill Loading**: Skills loaded from file system directories
- **Tool Visualization**: Visual display of tool calls and results
- **Web Search**: Built-in web search capability

## Architecture

```
┌─────────────────────────────────────────────────────────────┐
│                     Browser (Frontend)                       │
│  ┌─────────────────────────────────────────────────────┐    │
│  │  HTML/JS - Chat Interface + Tool Visualization     │    │
│  └─────────────────────────────────────────────────────┘    │
└──────────────────────────┬──────────────────────────────────┘
                           │ AG-UI Protocol (SSE)
┌──────────────────────────▼──────────────────────────────────┐
│              Spring Boot WebFlux (Backend)                   │
│  ┌─────────────────────────────────────────────────────┐    │
│  │  AG-UI Spring Boot Starter                          │    │
│  │  - AguiWebFluxHandler                               │    │
│  │  - Agent Registry                                   │    │
│  └─────────────────────────────────────────────────────┘    │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                    AgentScope Core                          │
│  ┌─────────────────────────────────────────────────────┐    │
│  │  ReActAgent + Toolkit + SkillBox                    │    │
│  │  - DashScope LLM (Qwen)                             │    │
│  │  - WebSearchTool                                    │    │
│  │  - FileSystemSkillRepository                        │    │
│  └─────────────────────────────────────────────────────┘    │
└──────────────────────────┬──────────────────────────────────┘
                           │
┌──────────────────────────▼──────────────────────────────────┐
│                    Skills Directory                         │
│  src/main/resources/skills/                                 │
│  └── web_search/                                            │
│      ├── SKILL.md                                          │
│      └── references/                                        │
└─────────────────────────────────────────────────────────────┘
```

## Quick Start

### 1. Set API Key

```bash
export DASHSCOPE_API_KEY=your-api-key
```

### 2. Build and Run

```bash
mvn spring-boot:run
```

### 3. Access the Application

Open browser: http://localhost:8080

## Skill Structure

Skills are organized as directories with the following structure:

```
skills/
└── skill-name/
    ├── SKILL.md          # Required: Skill definition
    ├── references/       # Optional: Reference docs
    ├── examples/         # Optional: Examples
    └── scripts/          # Optional: Helper scripts
```

### SKILL.md Format

```yaml
---
name: skill_name
description: When to use this skill
---
# Skill Title

## 功能概述
Description...

## 使用说明
Instructions...
```

## Configuration

### application.yml

```yaml
server:
  port: 8080

agentscope:
  model:
    name: qwen-plus
  agui:
    path-prefix: /agui
    cors-enabled: true
    server-side-memory: true
```

## API Endpoints

| Endpoint | Method | Description |
|----------|--------|-------------|
| `/agui/run` | POST | Execute agent (SSE stream) |
| `/` | GET | Web UI (index.html) |

## Dependencies

- Java 17+
- Spring Boot 3.2.x
- AgentScope Java 1.0.9
- DashScope API Key