(rocketmq-a2a) branch main updated: Optimize the readme (#9)

jinrongtong Tue, 16 Dec 2025 05:20:20 -0800

This is an automated email from the ASF dual-hosted git repository.

jinrongtong pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/rocketmq-a2a.git



The following commit(s) were added to refs/heads/main by this push:
     new 35df70c  Optimize the readme (#9)
35df70c is described below

commit 35df70c246b39f0df6b6a585cdfdeb8b72034da8
Author: Drizzle <[email protected]>
AuthorDate: Tue Dec 16 21:18:10 2025 +0800

    Optimize the readme (#9)
    
    * update
    
    Change-Id: I2b5f6364699c1c9e07b6ad381b801c49ce641559
    
    * optimize the code
    
    Change-Id: If2495360c76970ac88387e59e3ac15a6237e2f3e
    
    * update
    
    Change-Id: Iceef7a1bd1d05bfa498694ba7c3a007bbfdf378e
    
    * update
    
    Change-Id: Id0b75d941f02387d7b05a96731ea936526bae012
    
    * add spring web demo
    
    Change-Id: I74483972366bd35fee4a8e6c58b928204b3669ed
    
    * update example
    
    Change-Id: I00ec96acdbf1b7b5aabad5d28b10667b605635e1
    
    * update
    
    Change-Id: I0f51bf41c079d782a1a3adbbd388a32a50170980
    
    * update
    
    Change-Id: Id0e84eb0f4aa59d7aa020b36a7de85a8583f142d
    
    * update demo
    
    Change-Id: Ic7af56d1b946b119816848725465b60335bfc9ee
    
    * optimzie the code
    
    Change-Id: Ie45c5bbb6d27af2dd2bd2c66e5b0ee18faa91a41
    
    * update
    
    Change-Id: I930f4792680e577d14b6ae5f28264c03e93d987c
    
    * change the version
    
    Change-Id: I24e144b98c8e7ff5939c2ebdf609c8535aa9bce8
    
    * update
    
    Change-Id: I000b1f2badcd0c6d64d632c73a9381cb1e3857e2
    
    ---------
    
    Co-authored-by: drizzle.zk <[email protected]>
---
 example/rocketmq-multiagent-base-adk/README.md     | 138 ++++++++++++++++++++-
 .../TravelAgent/pom.xml                            |  24 ----
 .../WeatherAgent/pom.xml                           |  24 ----
 example/rocketmq-multiagent-base-adk/img_10.png    | Bin 0 -> 686207 bytes
 example/rocketmq-multiagent-base-adk/img_11.png    | Bin 0 -> 846904 bytes
 example/rocketmq-multiagent-base-adk/img_12.png    | Bin 0 -> 2042840 bytes
 example/rocketmq-multiagent-base-adk/img_13.png    | Bin 0 -> 272917 bytes
 example/rocketmq-multiagent-base-adk/img_14.png    | Bin 0 -> 686207 bytes
 example/rocketmq-multiagent-base-adk/img_15.png    | Bin 0 -> 148560 bytes
 example/rocketmq-multiagent-base-adk/img_16.png    | Bin 0 -> 148560 bytes
 example/rocketmq-multiagent-base-adk/img_6.png     | Bin 0 -> 846904 bytes
 example/rocketmq-multiagent-base-adk/img_7.png     | Bin 0 -> 2042840 bytes
 example/rocketmq-multiagent-base-adk/img_8.png     | Bin 0 -> 272917 bytes
 example/rocketmq-multiagent-base-adk/img_9.png     | Bin 0 -> 606947 bytes
 14 files changed, 132 insertions(+), 54 deletions(-)

diff --git a/example/rocketmq-multiagent-base-adk/README.md 
b/example/rocketmq-multiagent-base-adk/README.md
index 5900c88..b0325d9 100644
--- a/example/rocketmq-multiagent-base-adk/README.md
+++ b/example/rocketmq-multiagent-base-adk/README.md
@@ -24,6 +24,116 @@
 - **2.2** 购买或实现一个具备天气查询功能的 Agent 服务
 - **2.3** 购买或实现一个能根据天气信息制定行程规划的 Agent 服务
 
+### 3. 以下示例以阿里云百炼平台提供的大模型与 Agent 调用服务为例。欢迎社区开发者贡献更多来自其他厂商的集成案例。
+
+1. 
[进入阿里云百炼平台](https://bailian.console.aliyun.com/?spm=a2c6h.28997786.0.0.7cc11833r0cOJH#/home)
+
+2. 
[创建对应的模型调用服务与Agent调用服务的apiKey](https://bailian.console.aliyun.com/?spm=a2c6h.28997786.0.0.7cc11833r0cOJH&tab=model#/api-key)
 
+
+3. 
[在百炼平台中创建天气助手应用与创建行程助手应用](https://bailian.console.aliyun.com/?spm=a2c6h.28997786.0.0.15d91833sq0PBK&tab=app#/app-center)
+
+4. 创建天气助手Agent
+- 在阿里云百炼的应用管理页面，单击创建应用按钮。
+![img_6.png](img_6.png)
+
+- 在弹窗中选择智能体应用，应用名称填写天气助手，单击立即创建。
+![img_7.png](img_7.png)
+- 在应用中选择通义千问 3（通义千问-Plus-Latest） 模型，最长回复长度设定为 
8192，开启思考模式。开启思考模式有助于提升模型处理复杂任务的能力，但同时会增加Token消耗。在实际生产应用中，请根据具体业务需求合理选择是否启用该功能。
+![img_8.png](img_8.png)
+- 在提示词中输入以下内容。
+```
+# 角色
+你是一位专业的天气查询助手，能够根据用户提供的城市和时间信息，提供简洁明了的天气预报。你的任务是帮助用户获取准确的天气信息，以便他们做好相应的准备。
+
+## 技能
+### 技能 1: 获取用户需求
+- 询问用户所需查询的城市和具体时间。
+- 确认用户的需求并确保信息准确无误。
+
+### 技能 2: 查询天气信息
+- 使用天气查询工具（如API）获取实时天气数据。
+- 回复简单的天气预报信息即可，不用过于复杂，包括温度、湿度、风速、降水概率等。
+
+### 技能 3: 解读天气信息
+- 将获取到的天气数据以易于理解的方式呈现给用户。
+- 根据天气情况，给出相应的建议，例如穿衣建议或出行提示。
+
+## 约束
+- 只提供与天气相关的信息和服务。
+- 所有天气信息必须通过调用天气查询工具来获取，不得凭空猜测。
+- 提供的信息应准确且及时，确保用户能够做出合理的决策。
+- 保持简洁明了的沟通方式，避免使用过于专业或复杂的术语。
+```
+
+- 
在左侧导航栏中选择技能，然后单击MCP服务右侧的+按钮，为模型添加MCP服务。在MCP广场中查找并选择最美天气。如果是首次使用MCP服务，点击立即开通并根据页面提示开通服务。
+![img_9.png](img_9.png)
+- 单击发布按钮。
+![img_10.png](img_10.png)
+- 返回应用列表，将应用ID保存到本地用于后续配置。
+-
+- ![img_16.png](img_16.png)
+5. 创建行程规划助手Agent
+- 在阿里云百炼的应用管理页面，单击创建应用按钮。
+![img_11.png](img_11.png)
+- 在弹窗中选择智能体应用，应用名称填写行程助手，单击立即创建。
+![img_12.png](img_12.png)
+- 在应用中选择通义千问 3（通义千问-Plus-Latest） 模型，最长回复长度设定为 
8192，开启思考模式。开启思考模式有助于提升模型处理复杂任务的能力，但同时会增加Token消耗。在实际生产应用中，请根据具体业务需求合理选择是否启用该功能。
+![img_13.png](img_13.png)
+- 在提示词中输入以下内容。
+```
+## 角色
+你是一个智能出行助手，你会给客户推荐最全面的出行建议，为客户的出行保驾护航！
+## 技能
+### 技能1 ： 查询车票
+1，你可以根据客户要去的目的地来帮助客户查询高铁/动车，普通列车。
+2，当客户未提供出发点你需要询问出发点。并帮助客户查询相关车票
+3，输出形式，以为表格的形式列举出所有相关要查询的车票信息。
+4，你会根据列举出的车票信息，来推荐最佳的车票。
+
+### 技能2：航班查询
+1，你可以帮助客户查询目的地相关航班信息
+2，你可以将航班信息以表格的形式列举出来，要求信息详细
+3，你会根据列举出的航班信息，推荐最佳的航班。
+
+### 技能3 ：充电站查询
+1，你能根据客户输入的地点来实时查询所在地的充电站信息
+2，你会推荐最近且有可用充电桩的充电站。
+
+### 技能4：驾车路径规划
+1，你会根据输入的目的地来推荐最佳的驾车路径规划
+
+### 技能5：周边查询
+1，当客户出差时，你可以根据目的地来推荐附近的商务酒店
+2，以及附近的商务酒店哪里有停车场。
+3，酒店，停车场如果有图片的话，请展示相关图像。
+
+## 执行步骤
+1，当客户没有明确选择出行方式时，你需要询问需要哪种出行方式
+2，当客户选择了出行方式，你需要查询相关信息，然后根据要去的目的地，查询当地的天气，以及未来三天的天气情况
+
+## 约束
+1，当客户查询相关车票的时候，你需要将高铁/动车，航班信息以表格的形式列举出来。
+2，信息查询结果要求语言简练，文本信息不要有冗余。只输出相关信息即可，不要有无关信息的输出。
+3，当客户想要查询充电站信息，你只给出相关信息即可。
+4，当客户需要出行时，你必须询问客户要使用哪种出行方式，例如：高铁/动车，航班，驾车等然后再规划出行。
+5，你需要根据目的地查询当日的天气情况，以及未来三天的天气晴朗并且提醒客户关于天气出行的一些建议或注意事项
+6，你需要完全理解客户的意思，在任务中不要有缺漏和疏忽。
+```
+
+- 
在左侧导航栏中选择技能，然后单击MCP服务右侧的+按钮，为模型添加MCP服务。在MCP广场中查找并选择下列MCP服务。如果是首次使用MCP服务，点击立即开通并根据页面提示开通服务。
+```
+12306车票查询
+飞常准-Aviation
+新电途-ChargeStation
+Amap Maps
+```
+- 单击发布按钮。
+![img_14.png](img_14.png)
+
+- 返回应用列表，将应用ID(appId)保存到本地用于后续配置。
+-
+![img_15.png](img_15.png)
+
 ## 运行环境
 
 - JDK 17 及以上
@@ -38,7 +148,23 @@ mvn clean package -Dmaven.test.skip=true 
-Dcheckstyle.skip=true
 ```
 以下三个Agent进程建议在分别在不同的窗口中运行
 
-#### 2.运行WeatherAgent
+#### 2. 基本参数介绍
+
+| 参数名称  | 基本介绍             | 是否必填 |
+|-------|------------------|------|
+| rocketMQEndpoint | rocketmq服务接入点    | 是    |
+| rocketMQNamespace | rocketmq命名空间     | 否    |
+| bizTopic | 普通Topic          | 是    |
+| bizConsumerGroup | 普通消费者CID         | 是    |
+| rocketMQAK | rocketmq账号       | 否    |
+| rocketMQSK | rocketmq密码       | 否    |
+| apiKey | 百炼平台调用apiKey     | 是    |
+| appId | 对应百炼智能应用appId    | 是    |
+| workAgentResponseTopic | LiteTopic        | 是    |
+| workAgentResponseGroupID | LiteConsumer CID | 是    |
+
+
+#### 3.运行WeatherAgent
 ```shell
 cd WeatherAgent
 ```
@@ -48,7 +174,7 @@ MAVEN_OPTS="-DrocketMQEndpoint= -DrocketMQNamespace= 
-DbizTopic=WeatherAgentTask
 ```
 ![img.png](img.png)
 
-#### 3.运行TravelAgent
+#### 4.运行TravelAgent
 ```shell
 cd TravelAgent
 ```
@@ -58,23 +184,23 @@ cd TravelAgent
 ```
 ![img_1.png](img_1.png)
 
-#### 4.运行SupervisorAgent
+#### 5.运行SupervisorAgent
 ```shell
 cd SupervisorAgent/target
 ```
 ```shell
-java -DrocketMQNamespace= -DworkAgentResponseTopic=WorkerAgentResponse 
-DworkAgentResponseGroupID=CID_HOST_AGENT_LITE -DapiKey= 
-DweatherAgentTaskTopic=WeatherAgentTask -DtravelAgentTaskTopic=TravelAgentTask 
-DrocketMQAK= -DrocketMQSK= -jar 
SupervisorAgent-2.1.1-SNAPSHOT-jar-with-dependencies.jar 
+java -DrocketMQNamespace= -DworkAgentResponseTopic=WorkerAgentResponse 
-DworkAgentResponseGroupID=CID_HOST_AGENT_LITE -DapiKey= -DrocketMQAK= 
-DrocketMQSK= -jar SupervisorAgent-2.1.1-SNAPSHOT-jar-with-dependencies.jar 
 ```
 ![img_5.png](img_5.png)
 
-5.运行SupervisorAgent-Web
+6.运行SupervisorAgent-Web
 
 ```shell
 cd SupervisorAgent-Web/target
 ```
 
 ```shell
-java -DrocketMQNamespace= -DworkAgentResponseTopic=WorkerAgentResponse 
-DworkAgentResponseGroupID=CID_HOST_AGENT_LITE -DapiKey= 
-DweatherAgentTaskTopic=WeatherAgentTask -DtravelAgentTaskTopic=TravelAgentTask 
-DrocketMQAK= -DrocketMQSK= -jar SupervisorAgent-Web-2.1.1-SNAPSHOT.jar
+java -DrocketMQNamespace= -DworkAgentResponseTopic=WorkerAgentResponse 
-DworkAgentResponseGroupID=CID_HOST_AGENT_LITE -DapiKey= -DrocketMQAK= 
-DrocketMQSK= -jar SupervisorAgent-Web-2.1.1-SNAPSHOT.jar
 ```
 - 打开浏览器，访问 localhost:9090
 - 下面的示例展示了以RocketMQ作为底层Transport过程中实现异步通信以及断点重传功能
diff --git a/example/rocketmq-multiagent-base-adk/TravelAgent/pom.xml 
b/example/rocketmq-multiagent-base-adk/TravelAgent/pom.xml
index 181d659..14b9637 100644
--- a/example/rocketmq-multiagent-base-adk/TravelAgent/pom.xml
+++ b/example/rocketmq-multiagent-base-adk/TravelAgent/pom.xml
@@ -96,30 +96,6 @@
     </dependencies>
     <build>
         <plugins>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-assembly-plugin</artifactId>
-                <version>3.6.0</version>
-                <configuration>
-                    <archive>
-                        <manifest>
-                            <mainClass>agent.TravelAgentMain</mainClass>
-                        </manifest>
-                    </archive>
-                    <descriptorRefs>
-                        <descriptorRef>jar-with-dependencies</descriptorRef>
-                    </descriptorRefs>
-                </configuration>
-                <executions>
-                    <execution>
-                        <id>make-assembly</id>
-                        <phase>package</phase>
-                        <goals>
-                            <goal>single</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
diff --git a/example/rocketmq-multiagent-base-adk/WeatherAgent/pom.xml 
b/example/rocketmq-multiagent-base-adk/WeatherAgent/pom.xml
index 0cff91a..26fa441 100644
--- a/example/rocketmq-multiagent-base-adk/WeatherAgent/pom.xml
+++ b/example/rocketmq-multiagent-base-adk/WeatherAgent/pom.xml
@@ -116,30 +116,6 @@
                     <target>16</target>
                 </configuration>
             </plugin>
-            <plugin>
-                <groupId>org.apache.maven.plugins</groupId>
-                <artifactId>maven-assembly-plugin</artifactId>
-                <version>3.6.0</version>
-                <configuration>
-                    <archive>
-                        <manifest>
-                            <mainClass>agent.WeatherAgentMain</mainClass>
-                        </manifest>
-                    </archive>
-                    <descriptorRefs>
-                        <descriptorRef>jar-with-dependencies</descriptorRef>
-                    </descriptorRefs>
-                </configuration>
-                <executions>
-                    <execution>
-                        <id>make-assembly</id>
-                        <phase>package</phase>
-                        <goals>
-                            <goal>single</goal>
-                        </goals>
-                    </execution>
-                </executions>
-            </plugin>
             <plugin>
                 <groupId>io.quarkus</groupId>
                 <artifactId>quarkus-maven-plugin</artifactId>
diff --git a/example/rocketmq-multiagent-base-adk/img_10.png 
b/example/rocketmq-multiagent-base-adk/img_10.png
new file mode 100644
index 0000000..f985a83
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_10.png 
differ
diff --git a/example/rocketmq-multiagent-base-adk/img_11.png 
b/example/rocketmq-multiagent-base-adk/img_11.png
new file mode 100644
index 0000000..b6f8468
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_11.png 
differ
diff --git a/example/rocketmq-multiagent-base-adk/img_12.png 
b/example/rocketmq-multiagent-base-adk/img_12.png
new file mode 100644
index 0000000..bb557f2
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_12.png 
differ
diff --git a/example/rocketmq-multiagent-base-adk/img_13.png 
b/example/rocketmq-multiagent-base-adk/img_13.png
new file mode 100644
index 0000000..6fcab2f
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_13.png 
differ
diff --git a/example/rocketmq-multiagent-base-adk/img_14.png 
b/example/rocketmq-multiagent-base-adk/img_14.png
new file mode 100644
index 0000000..f985a83
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_14.png 
differ
diff --git a/example/rocketmq-multiagent-base-adk/img_15.png 
b/example/rocketmq-multiagent-base-adk/img_15.png
new file mode 100644
index 0000000..4c9acd0
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_15.png 
differ
diff --git a/example/rocketmq-multiagent-base-adk/img_16.png 
b/example/rocketmq-multiagent-base-adk/img_16.png
new file mode 100644
index 0000000..4c9acd0
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_16.png 
differ
diff --git a/example/rocketmq-multiagent-base-adk/img_6.png 
b/example/rocketmq-multiagent-base-adk/img_6.png
new file mode 100644
index 0000000..b6f8468
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_6.png 
differ
diff --git a/example/rocketmq-multiagent-base-adk/img_7.png 
b/example/rocketmq-multiagent-base-adk/img_7.png
new file mode 100644
index 0000000..bb557f2
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_7.png 
differ
diff --git a/example/rocketmq-multiagent-base-adk/img_8.png 
b/example/rocketmq-multiagent-base-adk/img_8.png
new file mode 100644
index 0000000..6fcab2f
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_8.png 
differ
diff --git a/example/rocketmq-multiagent-base-adk/img_9.png 
b/example/rocketmq-multiagent-base-adk/img_9.png
new file mode 100644
index 0000000..5b3ed2d
Binary files /dev/null and b/example/rocketmq-multiagent-base-adk/img_9.png 
differ

(rocketmq-a2a) branch main updated: Optimize the readme (#9)

Reply via email to