一、内网穿透cpolarNATAPP二、JSONPlaceholderPOST/PUT 只是模拟成功不会真实保存数据非常适合 Agent 工具调用调试。返回模拟 JSON 数据无 token 无鉴权。GET https://jsonplaceholder.typicode.com/posts/1{userId:1,id:1,title:sunt aut facere repellat provident occaecati excepturi optio reprehenderit,body:quia et suscipit\nsuscipit recusandae consequuntur expedita et cum\nreprehenderit molestiae ut ut quas totam\nnostrum rerum est autem sunt rem eveniet architecto}GET https://jsonplaceholder.typicode.com/users 用户列表GET https://jsonplaceholder.typicode.com/todos 待办列表三、创建应用创建智能体应用https://bailian.console.aliyun.com/cn-beijing?tabapp#/app-market/suggest设置模型设置提示词角色 你作为在线教育平台资深客服代表兼讲师。你的任务根据学员的需求调用知识库中的课程信息为学员推荐合适的课程同时解答学员对课程内容和知识点的疑问。 技能 1: 课程推荐 1. 当学员提出课程推荐需求时需判断是否提供必要信息。必要信息包含年龄、学历、是否有编程基础。 2. 若缺少必要信息需礼貌追问。 3. 若学员未提供感兴趣的方向需追问。若没有明确方向优先推荐学习人数多的课程。 4. 若信息充足根据必要信息和感兴趣的课程方向去知识库匹配合适的课程获取课程id调用queryCourseById根据课程id查询课程详细信息为学员推荐课程可推荐单门/多门课程。 5. 若知识库未包含学员感兴趣方向需明确告知学员未提供该方向课程并推荐其他课程。 6. 若必要信息未匹配合适课程需提示学员您的情况与现有课程要求并不完全匹配说明详细原因后再推荐其他课程。 7. 推荐课程必须要通过queryCourseById查询后才能返回数据。 技能 2: 课程购买 1. 当学员提出购买课程时需判断此次会话中学员是否明确提出购买xx课/系统已为学员推荐课程。 2. 若已推荐/明确课程名称需调用prePlaceOrder根据此次上文已推荐/学员明确的课程直接进入预下单流程。 3. 若未推荐课程需引导学员进入到课程推荐流程。 4. 若学员未明确提出购买某门课程时需询问用户购买哪门课程。 5. 支持购买一门/多门课程。 技能 3: 课程咨询 1. 当学员咨询课程内容时需去知识库匹配合适的课程获取课程id根据课程id查询课程详细信息。回复的内容要全面要引导学员报名购买。 2. 若未查询到需礼貌告知学员未检索到相关的内容请联系人工客服010-12345678。 3. 若咨询课程有效期需将当前时间{now} 与 课程有效期相加回复学员准确日期。课程有效期999天代表永久有效。 技能 4: 知识讲解 1. 当学员咨询与IT相关的知识点内容时需详细讲解知识点并提供示例。 限制: - 推荐的课程只能从知识库中选择坚决不能凭空编造 - 回答的内容要逻辑清晰、内容全面、不要有遗漏。 - 只能回答与课程和IT知识点相关的内容若学员咨询与课程无关的内容你需告知学员不能回答与课程和IT知识点无关的问题并引导学员咨询与课程/IT知识点相关的问题。 - 若学员询问课程ID则告知学员无法提供课程ID引导学员咨询其他的问题。数据连接导入数据知识库这里也可以直接上传文件。添加知识库。添加插件添加工具需要发布。工具转为MCP。也可以直接创建MCP。添加MCP调试完即可发布。四、程序调用dependencygroupIdcom.alibaba/groupIdartifactIddashscope-sdk-java/artifactIdversion2.19.0/versionexclusionsexclusiongroupIdcom.github.victools/groupIdartifactIdjsonschema-generator/artifactId/exclusionexclusionartifactIdslf4j-api/artifactIdgroupIdorg.slf4j/groupId/exclusionexclusionartifactIdslf4j-simple/artifactIdgroupIdorg.slf4j/groupId/exclusion/exclusions/dependencypublic class AppTest{Test publicvoidtestAppCall()throws Exception{// 构造业务参数工具调用需要String tokenxxxxxxxxxxx;MapString,ObjectbizParamsMapUtil.String,Objectbuilder().put(user_defined_tokens,MapUtil.of(tool_xxxxx,// 工具idMapUtil.of(user_token,token))).build();// bizParams.add(user_defined_tokens, JsonObject);ApplicationParam paramApplicationParam.builder()// 若没有配置环境变量可用百炼API Key将下行替换为.apiKey(sk-xxx)。但不建议在生产环境中直接将API Key硬编码到代码中以减少API Key泄露风险。.apiKey(System.getenv(ALIYUN_API_KEY).appId(xxxxxxxxxx)// 智能体id.prompt(课程推荐20岁本科没有编程基础对java感兴趣).incrementalOutput(true)// 开启增量输出.bizParams(JsonUtils.toJsonObject(bizParams)).build();Application applicationnewApplication();FlowableApplicationResultresultapplication.streamCall(param);// 阻塞式的打印内容result.blockingForEach(data-{System.out.printf(%s\n,data.getOutput().getText());});}}五、Spring集成tj:ai:dashscope:key:sk-xxxxxxxxxxxapp-agent:id:xxxxxxxxxtools:-tool_xxxxx-tool_xxxxxDataConfigurationConfigurationProperties(prefixtj.ai.dashscope)publicclassDashScopeProperties{privateStringkey;privateAppAgentappAgent;DataBuilderAllArgsConstructorNoArgsConstructorpublicstaticclassAppAgent{privateStringid;privateListStringtools;}}提供App版本阿里云百炼的ChatService实现。ServiceRequiredArgsConstructorConditionalOnProperty(prefixtj.ai,namechat-type,havingValueAPP)publicclassAppAgentChatServiceimplementsChatService{privatefinalDashScopePropertiesdashScopeProperties;// 存储大模型的生成状态这里采用ConcurrentHashMap是确保线程安全// 目前的版本暂时用Map实现如果考虑分布式环境的话可以考虑用redis来实现privatestaticfinalMapString,BooleanGENERATE_STATUSnewConcurrentHashMap();// 输出结束的标记privatestaticfinalChatEventVOSTOP_EVENTChatEventVO.builder().eventType(ChatEventTypeEnum.STOP.getValue()).build();OverridepublicFluxChatEventVOchat(Stringquestion,StringsessionId){// 获取对话idvarconversationIdChatService.getConversationId(sessionId);vartokenTokenContext.getToken();vartoolsMapnewHashMapString,Object();for(vartool:dashScopeProperties.getAppAgent().getTools()){toolsMap.put(tool,Map.of(user_token,token));}varbizParamsMap.of(user_defined_tokens,toolsMap);varparamApplicationParam.builder().apiKey(dashScopeProperties.getKey()).appId(dashScopeProperties.getAppAgent().getId())// 智能体id.prompt(question).incrementalOutput(true)// 开启增量输出.bizParams(JsonUtils.toJsonObject(bizParams)).sessionId(conversationId)// 设置会话ID.build();varapplicationnewApplication();try{varresultapplication.streamCall(param);// 将Flowable 转化为 Flux 进行处理输出returnFlux.from(result).doFirst(()-{//输出开始标记正在输出GENERATE_STATUS.put(sessionId,true);}).doOnComplete(()-{//输出结束清除标记GENERATE_STATUS.remove(sessionId);}).doOnError(throwable-GENERATE_STATUS.remove(sessionId))// 错误时清除标记// 输出过程中判断是否正在输出如果正在输出则继续输出否则结束输出.takeWhile(s-GENERATE_STATUS.getOrDefault(sessionId,false)).map(applicationResult-{// 获取大模型的输出的内容vartextapplicationResult.getOutput().getText();// 封装响应对象returnChatEventVO.builder().eventData(text).eventType(ChatEventTypeEnum.DATA.getValue()).build();}).concatWith(Flux.just(STOP_EVENT));}catch(Exceptione){thrownewRuntimeException(e);}}Overridepublicvoidstop(StringsessionId){// 移除标记GENERATE_STATUS.remove(sessionId);}}在线平台适合通用的功能没法自定义功能返回值没法自定义结合客户端展示没有历史记录等常适用于一次性的功能各种工具常用于个人企业中还需要自己开发。