Merge branch 'main' into release/1.0.4

Author: AlbumenJ

agentscope-distribution/agentscope-bom/pom.xml

@@ -206,6 +206,13 @@
                 <version>${project.version}</version>
             </dependency>
 
+            <!-- AgentScope Higress Extension -->
+            <dependency>
+                <groupId>io.agentscope</groupId>
+                <artifactId>agentscope-extensions-higress</artifactId>
+                <version>${project.version}</version>
+            </dependency>
+
             <!-- AgentScope Micronaut Extension -->
             <dependency>
                 <groupId>io.agentscope</groupId>

agentscope-examples/advanced/src/main/java/io/agentscope/examples/advanced/AutoMemoryExample.java

@@ -19,8 +19,8 @@
 import io.agentscope.core.ReActAgent;
 import io.agentscope.core.formatter.dashscope.DashScopeChatFormatter;
 import io.agentscope.core.memory.autocontext.AutoContextConfig;
+import io.agentscope.core.memory.autocontext.AutoContextHook;
 import io.agentscope.core.memory.autocontext.AutoContextMemory;
-import io.agentscope.core.memory.autocontext.ContextOffloadTool;
 import io.agentscope.core.memory.mem0.Mem0LongTermMemory;
 import io.agentscope.core.message.Msg;
 import io.agentscope.core.message.MsgRole;
@@ -29,6 +29,7 @@
 import io.agentscope.core.model.GenerateOptions;
 import io.agentscope.core.session.JsonSession;
 import io.agentscope.core.session.SessionManager;
+import io.agentscope.core.studio.StudioManager;
 import io.agentscope.core.tool.Toolkit;
 import io.agentscope.core.tool.file.ReadFileTool;
 import io.agentscope.core.tool.file.WriteFileTool;
@@ -43,6 +44,16 @@ public class AutoMemoryExample {
 
     public static void main(String[] args) {
 
+        // Initialize Studio
+        System.out.println("Connecting to Studio at http://localhost:3000...");
+        StudioManager.init()
+                .studioUrl("http://localhost:3000")
+                .project("JavaExamples")
+                .runName("studio_demo_" + System.currentTimeMillis())
+                .initialize()
+                .block();
+        System.out.println("Connected to Studio\n");
+
         String apiKey = ExampleUtils.getDashScopeApiKey();
 
         DashScopeChatModel chatModel =
@@ -61,15 +72,13 @@ public static void main(String[] args) {
                         .apiBaseUrl("https://api.mem0.ai");
         Mem0LongTermMemory longTermMemory = builder.build();
         AutoContextConfig autoContextConfig =
-                AutoContextConfig.builder().tokenRatio(0.4).lastKeep(10).build();
+                AutoContextConfig.builder().tokenRatio(0.4).lastKeep(20).build();
         AutoContextMemory memory = new AutoContextMemory(autoContextConfig, chatModel);
 
         Toolkit toolkit = new Toolkit();
         toolkit.registerTool(new ReadFileTool());
         toolkit.registerTool(new WriteFileTool());
-        // AutoContextMemory implements ContextOffLoader interface, can be used directly
-        toolkit.registerTool(new ContextOffloadTool(memory));
-        // Create Agent with minimal configuration
+
         ReActAgent agent =
                 ReActAgent.builder()
                         .name("Assistant")
@@ -82,16 +91,16 @@ public static void main(String[] args) {
                         .longTermMemory(longTermMemory)
                         .enablePlan()
                         .toolkit(toolkit)
+                        .hook(new AutoContextHook()) // Register the hook for automatic setup
                         .build();
-        String sessionId = "session000005";
+        String sessionId = "session111111111111";
         // Set up session path
         Path sessionPath =
                 Paths.get(System.getProperty("user.home"), ".agentscope", "examples", "sessions");
         SessionManager sessionManager =
                 SessionManager.forSessionId(sessionId)
                         .withSession(new JsonSession(sessionPath))
-                        .addComponent(agent) // Automatically named "agent"
-                        .addComponent(memory); // Automatically named "memory"
+                        .addComponent(agent); // Automatically named "agent"
         if (sessionManager.sessionExists()) {
             // Load existing session
             sessionManager.loadIfExists();

agentscope-examples/boba-tea-shop/HIMARKET_DEPLOYMENT.md

@@ -0,0 +1,196 @@
+# HiMarket Deployment and Usage Guide
+
+## Overview
+
+HiMarket is an AI capability marketplace for publishing and distributing various Agents in the AgentScope multi-agent system.
+
+### HiMarket Features
+
+- **Agent Marketplace**: One-click listing of Agents registered in Nacos, developers can browse and subscribe to various Agent services
+- **Admin Console**: Unified management of Agent products, permission configuration, and subscription approval
+- **Developer Portal**: Developers can discover, subscribe to, and use Agent capabilities in the portal
+- **Observability**: Monitor Agent invocation success rate, latency, and other runtime metrics
+
+HiMarket shares the same Nacos instance with the AgentScope multi-agent system, enabling unified management and exposure of Agents.
+
+---
+
+## Configure Helm Values
+
+Edit `himarket-helm/values.yaml` to configure HiMarket:
+
+```yaml
+# HiMarket image configuration
+server:
+  image:
+    hub: registry.cn-hangzhou.aliyuncs.com/agentscope
+    repository: himarket-server-auto-init
+    tag: "latest"
+
+# MySQL configuration (optional: use built-in or external)
+mysql:
+  enabled: true  # Use built-in MySQL
+
+# Nacos configuration (import AgentScope's Nacos)
+nacos:
+  enabled: true  # Enable Nacos import
+  name: agentscope-nacos
+  serverUrl: http://agentscope-nacos:8848  # Keep consistent with the Nacos address configured earlier
+  username: nacos
+  password: nacos
+```
+
+For more configuration options, please refer to [himarket-helm/README.md](himarket-helm/README.md)
+
+---
+
+## Deploy to K8s
+
+```bash
+# Create namespace (if not already created)
+kubectl create namespace mse
+
+# Deploy AgentScope multi-agent system (must be deployed first)
+helm install agentscope helm/ --namespace mse
+
+# Deploy HiMarket AI capability marketplace
+# Import AgentScope's Nacos into HiMarket for unified Agent management
+helm install himarket himarket-helm/ --namespace mse
+
+# Check deployment status
+kubectl get pods -n mse
+kubectl get services -n mse
+```
+
+---
+
+## Using HiMarket
+
+### 1. Access HiMarket Admin Console
+
+Access the HiMarket admin console via `kubectl port-forward`:
+
+```bash
+# Forward admin console service
+kubectl port-forward svc/himarket-admin 5174:80 -n mse
+
+# Browser access
+# http://localhost:5174
+```
+
+If using LoadBalancer or NodePort:
+
+```bash
+# Get HiMarket service address
+kubectl get svc -n mse | grep himarket
+
+# LoadBalancer: http://<external-ip>:80
+# NodePort: http://<node-ip>:<node-port>
+```
+
+### 2. Login with Admin Account
+
+HiMarket automatically creates an admin account during deployment:
+
+**Default Admin Account**:
+- Username: `admin`
+- Password: `admin`
+
+**Custom Admin Account**:
+
+To modify the default admin account, configure it in `himarket-helm/values.yaml`:
+
+```yaml
+autoInit:
+  # Admin account configuration
+  admin:
+    username: your-admin    # Custom username
+    password: your-password # Custom password
+```
+
+### 3. View Imported Nacos
+
+1. Login to admin console
+2. Navigate to "Service Management" → "Nacos Instances"
+3. Confirm that AgentScope's Nacos instance has been automatically imported (configured during deployment)
+4. Click on the Nacos instance to view all registered Agent services
+
+### 4. List an Agent
+
+1. In the admin console, go to "API Products"
+2. Click "Create Product" and select an Agent service from Nacos (e.g., `supervisor-agent`, `business-sub-agent`, etc.)
+3. Configure product information, documentation, permissions, etc.
+4. Save and publish to the developer portal
+
+### 5. List an MCP Server
+
+In addition to MCP Servers automatically imported during deployment, users can also list their own MCP Servers registered in Nacos.
+
+**Listing Process** (similar to Agent listing):
+
+1. **Register MCP Server to Nacos**
+   - Register your MCP Server to the Nacos instance shared with HiMarket
+   - Ensure the MCP Server is running properly and can be discovered by Nacos
+
+2. **List in Admin Console**
+   - Go to HiMarket admin console
+   - Navigate to "API Products" → "Create Product"
+   - Select your MCP Server service from the service list
+   - Configure product information:
+     - Product name and description
+     - Description of tools provided by the MCP Server
+     - API documentation and usage examples
+     - Access permission configuration
+   - Save and publish to developer portal
+
+3. **Developer Usage**
+   - Developers browse MCP Server products in the portal
+   - After subscription, integrate into AgentScope applications
+   - Call MCP Server tools via MCP protocol
+
+**Notes**:
+- HiMarket automatically discovers all MCP Servers registered in Nacos
+- Supports listing services with standard MCP protocol
+- Different access permissions and subscription policies can be configured for different MCP Servers
+
+### 6. Developer Subscription
+
+HiMarket automatically creates a demo developer account during deployment, which can be used directly:
+
+**Default Developer Account**:
+- Username: `demo`
+- Password: `demo123`
+
+**Usage Flow**:
+1. Login to HiMarket developer portal with the default account
+2. Browse published Agent products
+3. Create an application and subscribe to Agents
+4. Obtain credentials and integrate into your own applications
+
+**Custom Developer Account**:
+
+To modify the default developer account, configure it in `himarket-helm/values.yaml`:
+
+```yaml
+autoInit:
+  # Developer account configuration
+  developer:
+    username: your-developer  # Custom username
+    password: your-password   # Custom password
+```
+
+Or set via Helm command line:
+
+```bash
+helm install himarket himarket-helm/ \
+  --set autoInit.developer.username=mydev \
+  --set autoInit.developer.password=mypassword123
+```
+
+**Notes**:
+- HiMarket shares the same Nacos instance with AgentScope
+- All Agents registered in Nacos will be automatically discovered by HiMarket
+- HiMarket enables unified management and exposure of these Agent capabilities
+
+---
+