案例介绍本案例是以工作流应用类型为例，利用MCP和知识库的能力，构建一个数学助教，该智能体主要应用场景：教师利用自己的知识库编排智能助教Agent，学生利用Agent查找知识点。准备工作访问versatile官网：cid:link_0登录华为云账号，点击“免费试用”，进入versatile产品主页构建Agent部署MCP1、从“资产中心-MCP广场”查找“智谱联网搜索”，配置认证信息“Authorlization”（请从智谱官网获取认证信息：https://bigmodel.cn/usercenter/proj-mgmt/apikeys），点击保存2、安装完成后，可在“组件库-我的MCP”查看安装成功的“智谱联网搜索”创建知识库1、选择“知识库”，新建知识库“数学知识库”，配置模型和参数，点击“确定”2、在知识库列表中，点击“数学知识库”，进入知识库文档管理页面，上传附件中知识文档“数学知识问答.docx”构建智能体1、选择“应用管理-工作流应用”，点击“创建应用”，配置信息工作流名称：智能助教英文名称：intelligent_assistant应用描述：智能助教是一款汇聚人类知识精华的智能知识库应用，能够为用户提供全面、准确且及时的多领域信息查询服务。它整合了科学、历史、文化、技术等学科的专业知识，通过智能检索和结构化呈现，帮助用户快速获取权威解释、背景资料和关联概念。应用支持多维度知识探索，包括时间轴梳理、概念图谱展示和跨学科关联，既可作为学生群体的学习辅助工具，也能满足专业人士的查证需求，同时为普通用户提供日常知识拓展的便捷入口，致力于成为用户终身学习的数字化知识伴侣。。2、进入工作流配置页面，在开始节点之后配置大模型节点，用于提取用户对话中的问题输入参数query：引用开始节点的query输出参数question系统提示词：从用户对话中解析出明确的`问题(question)`用户提示词：{{query}}3、问题提取节点之后添加知识检索节点，根据问题从知识库中查找答案。输入参数query：引用问题提取节点的question知识库：选择数学知识库4、知识检索节点之后添加判断节点，用于判断知识库中是否找到正确答案判断参数引用知识检索的output_list，判断条件为大于0。5、当知识库中查找到答案时，则以知识库的答案为主，利用大模型能力进行润色输出输入参数query：引用问题提取的questioninput：引用知识库中搜索出的内容输出参数raw_output用户提示词：你是经验丰富的老师，请依据“{{input}}”的结果，回答用户提出的问题：{{query}}，润色一份非常丰富的解答输出。6、当知识库中无法查找到答案时，则通过联网搜索的能力获取答案，接入MCP “智谱联网搜索”工具：选择webSearchStd输入参数search_query：引用问题提取的question7、将联网搜索的结果利用大模型能力进行润色输出输入参数query：引用问题提取的questioninput：引用智谱联网搜索出的内容content输出参数raw_output用户提示词：你是经验丰富的老师，请依据“{{input}}”的结果，回答用户提出的问题：{{query}}，润色一份非常丰富的解答输出。8、配置结束节点，将两个分支的结果汇总至结束节点输入参数result：引用知识库润色输出的raw_outputresult1：引用网络润色输出的raw_output指定回复：{{result}}{{result1}}调试智能体1、提问：什么是对数函数可查看调试结果调用了知识库的能力，走知识库润色输出的分支2、提问：什么是呼吸作用可查看调试结果没有调用知识库的能力，走网络润色输出的分支发布Agent1、发布Agent网页版使用2、点击“立即访问”进入网页版Agent对口窗口3、提问：什么是光合作用

案例介绍本案例是以单智能体应用类型为例，利用MCP和知识库的能力，构建一个旅游规划助手，该智能体主要应用场景包括：查询旅游景点信息、火车票信息、行程规划等旅游相关信息。准备工作访问versatile官网：cid:link_0登录华为云账号，点击“免费试用”，进入versatile产品主页构建Agent部署MCP1、从“资产中心-MCP广场”查找“MCP车票查询工具”，点击安装2、安装完成后，可在“组件库-我的MCP”查看安装成功的“MCP车票查询工具”创建知识库1、选择“知识库”，新建知识库“旅游知识”，配置模型和参数，点击“确定”2、在知识库列表中，点击“旅游知识”，进入知识库文档管理页面，上传附件中知识文档“江浙沪旅游及美食.docx”构建智能体1、选择“应用管理-单智能体应用”，点击“创建应用”，配置信息应用名称：旅游规划助手应用描述：旅游规划助手是一款专为旅行爱好者设计的智能行程规划应用。它能够根据用户的偏好、预算及时间安排，智能推荐目的地、景点、住宿和交通方案，同时提供当地天气预报、文化习俗介绍和实用旅行小贴士。这款助手支持定制化行程创建，帮助用户高效地组织旅行计划，避免遗漏重要细节或景点。无论是家庭出游、情侣度假还是独自探险，旅游规划助手都能贴心地为用户提供个性化的旅行建议，致力于让每一次旅行都变得更加轻松愉快、充满美好回忆。主要服务于热爱探索世界的旅行者们，助力打造难忘的旅行体验。2、进入单智能体配置页面，配置提示词信息，比如：旅游规划助手，点击“智能优化提示词”，确定即可3、添加知识库“旅游知识”和MCP服务“MCP车票查询工具”，智能添加开场白和推荐问题。调试智能体1、提问：江苏有哪些旅游景点可查看调试结果调用了知识库的能力2、提问：请查询明天南京到苏州的火车票信息可查看调试结果调用了MCP的能力3、提问：请帮我规划南京到苏州的3天行程可查看旅游规划的场景的调试结果发布Agent1、发布Agent网页版使用2、点击“立即访问”进入网页版Agent对口窗口3、提问：请查询北京到南京明天的火车票信息

  (2025年11月）  < 华为云Versatile智能体平台 体验入口>华为开发者空间--开发平台--Versatile Agent （请在PC端打开）  版本概览 华为云Versatile智能体平台定位为一站式企业级智能体构建平台，倡导人人都能构建自己的企业级智能体。本次十一月版本升级，新增多项重点特性，包括Agent web分享能力、NL2Agent技术的落地——AI创建智能体、提示词工程体验重构、Agent观测等，以及知识库、平台资源订购等能力增强，更好地满足海量客户在企业级Agent平台上的使用需求，并致力于深化产品能力，持续与开发者合力构建易用、好用、开放的AI Agent平台。  新增重点特性介绍 01  Agent web分享能力  应用管理· 支持单智能体应用、工作流应用发布为网页，可分享使用；并增加资源配置，可设置每日调用限额。业务价值：通过一键发布，支持在web端快捷访问智能体应用；可通过链接形式将Agent分享给他人体验，极大提升AI Agent的对外分享能力与成果使用率。  02 一句话智能生成智能体应用管理· 支持通过自然语言、对话交互式创建智能体，轻松实现AI创建应用业务价值：用户通过自然语言描述需求，实现无码化、智能化创建单智能体应用、工作流应用，大幅降低构建AI应用的门槛。面向企业内用户，可显著减轻海量智能体创建的工作量。入口一：首页概览对话区入口二：创建应用-AI创建  03 提示词功能重构  应用管理· 重构"创建提示词"功能，界面更新；重构"优化提示词"功能，可在提示词中引入变量，实现不同场景下的快速复用；新增变量数据测评集，实现模型辅助构建。业务价值：简化提示词工程的开发流程，引入变量概念，借助大模型的学习能力，实现提示词的智能化构建。通过添加数据评测集和补充提示词背景知识等，可以帮助模型更好地理解提示词，多场景评测数据使提示词指令更加具体，输出更加符合预期。=   04 运营运维-观测 观测· 新增会话管理功能，支持查看Agent和工作流的会话历史。 业务价值：记录了智能体和工作流对话中的数据，可以更高效地管理和提升对话系统的性能。  · 增加租户指标统计。租户指标统计页面，提供当前租户下智能体应用和工作流方面的关键使用数据，包括TOP10单智能体/工作流的Tokens消耗、TOP10单智能体/工作流的总调用量等。业务价值：通过这些统计数据，您可以了解智能体和工作流的总数、新增数量、活跃情况以及资源消耗情况，帮助您优化资源分配，提高使用效率，并及时发现和解决问题。   05 Agent应用支持发布到云商店  应用管理· 将单智能体、工作流应用发布到云商店后，生成OpenAPI URL，用户可以在华为云云商店通过调用OpenAPI URL，即可将应用发布到云商店。业务价值：用户可以通过云商店发布上架次接口，支持将Agent在云商店上架交易。   06  单智能体应用能力拓展 应用管理· 单智能体在模型优先场景下，增加变量记忆功能，支持对用户变量进行设置。业务价值：用户变量可存储使用项目过程中需要持久化存储和读取的数据，如用户的语言偏好、个性化设置等，能让智能体提供更个性化回复，更好响应用户的消息，提升输出内容的上下文关联度和准确性。  · 调度模式支持工具优先功能。在处理用户的输入时，结合prompt，系统会优先判断用户添加的工具是否合适的，通过分析工具名称/描述/参数选择合适的工具来处理。业务价值：基于用户指令意图，准确映射到匹配的插件，提升问题处理的精确度。 适用于特定任务处理、高效任务执行、工具依赖性高的场景。  · 单智能体应用在添加插件、工作流、MCP等时支持无断点，可在构建过程中进行开通、创建等操作。业务价值：提升Agent创建全流程的流畅度，优化用户体验。   07  多智能体应用优化 应用管理· 多智能体应用创建过程中，与其关联的工作流、智能体可以修改意图识别。业务价值：增加修改子工作流意图识别的入口，提升多智能体应用的决策执行灵敏度。  08  数据能力 知识库· 知识文档支持上传Markdown和HTML格式的文档。业务价值：支持上传更多样的文档格式，提升文件解析能力，满足用户使用需求。  · 新增知识库从obs桶（Object Storage Service,OBS）中拉取知识文件。业务价值：通过对象存储服务（Object Storage Service,OBS）配置接入知识文档，实现快速调用，效率提升。  · 提供多知识库并行检索能力。知识库检索接口支持语义、关键词、混合及FAQ四种检索模式，并允许自定义相似度阈值与返回结果数量。业务价值1：丰富检索策略，实现更精准的知识调用。通过控制阈值，调节知识库与大模型之间的协作效能，实现精准高效的信息匹配。业务价值2：知识库节点增加“启用FAQ”按钮，默认状态下关闭，支持跳过FAQ查询环节，直接查询文档切片，满足个性化内容检索需求。  09  插件能力 组件库-我的插件· 支持创建函数类型插件。在函数编辑页面，可以创建并上传自定义依赖包，依赖包可包含自定义代码。业务价值：丰富插件创建方式，可实现代码复用，简化流程，以提高工具的灵活性和功能性。10 平台资源订购 平台管理-我的资源· Versatile智能体平台支持购买套餐包，购买后使用Versatile智能体平台的全量功能。业务价值：支持用户按需选购资源，包括免费版和商用版，升级商用版可便捷使用平台全量功能，满足业务需求。   点击可前往>>华为云Versatile智能体平台 官网

由于Versatile平台产品升级维护中，目前已临时关闭自行订阅通道。 请各位开发者扫码进入官方微信群——“Versatile智能体平台技术交流群”进群后请发送“我要开通Versatile，账号ID是xxxxxx”（获取方式：华为云控制台-右上角账号名下拉窗口-账号ID，可复制）技术支持将辅助在24小时内完成开通 如造成不便请谅解，自行订阅通道恢复时间另行通知感谢大家的理解与支持~ tips账号ID获取路径：华为云控制台-右上角账号名下拉窗口-账号ID（红框内）示意图：  【产品体验入口】：华为开发者空间--开发平台--Versatile Agent

案例介绍基于华为开发者空间-云开发环境（容器）+ Versatile Agent，快速构建AI自动作业评分系统，用于作业发布和批改案例内容摘要本案例面向高校/培训机构等教学场景，利用 华为开发者空间云开发环境（容器） + Versatile Agent + MaaS 大模型服务，构建一个可落地的 AI 作业自动评分系统。系统能够：根据老师给出的作业要求与标准答案，对学生提交的答案进行自动评分（0–100 分，整数）。自动生成结构化点评，包括优点、问题和改进建议。支持多题目、多批量作业的统一管理，减轻教师批改压力。本文将从场景与痛点、方案架构、环境准备、开发与部署步骤、功能验证等方面，完整展示如何在华为云上快速搭建一个可用的 AI 作业自动评分系统。一、概述1. 案例介绍1.1 业务场景介绍典型教学场景：大班授课（例如 100+ 学生），期末/平时作业量大。作业内容以简答题、简要论述题、代码题为主。主要痛点：老师手工评分耗时长、主观性强、难以及时反馈。很难对每个学生给出有针对性的“优点/问题/改进建议”。1.2 目标与价值目标：将 作业评分流程自动化：老师提供“作业要求 + 参考答案/评分要点”，AI 自动打分与点评。评分规则 可控可调，保证“符合题意、关键知识点完整、推理是否正确”等核心维度。价值：大幅降低教师批改工作量，提升反馈速度。帮助学生快速了解自己作业中的不足，提升学习效果。2. 适用对象个人开发者高校学生3. 案例时间本案例总时长预计90分钟。4. 案例流程说明：教师在 前端页面/管理端 录入或上传：作业题目说明本次作业的“评分标准 / 知识点要求”官方答案或参考答案学生通过页面/系统提交自己的作业答案。后端服务（运行在 华为开发者空间云开发环境 中）将：教师要求 + 标准答案 + 学生答案封装为 Prompt 调用 Versatile Agent（绑定大模型 MaaS）。Versatile Agent 根据预先配置的 系统提示词，输出：0–100 的整数分数结构化评语（优点、问题、改进建议）后端将结果存储并返回给前端展示。5. 资源总览本案例预计花费0元。资源名称规格单价（元）时长（分钟）华为开发者空间开发平台 - 云开发环境（容器）鲲鹏通用计算增强型 kc1 | 2vCPUs | 4G | HCE免费90华为开发者空间 - Versatile Agent平台系统标配免费90二、环境准备1. 领取注册开发者空间开发者空间是开发者专属的云上成长空间，预置免费华为根技术工具和资源，为开发者提供从学习、开发到部署的全旅程支持。点击免费领取，立即领取开发者空间。三、创建并发布智能评分Agent1. 创建智能评分Agent新账号，首次进入华为开发者空间开发平台，开通Versatile Agent服务，点击切换至华北-北京四，即可正常使用Versatile Agent服务。对于已开通Versatile Agent服务的开发者，直接进入华为开发者空间开发平台，点击开发平台->Versatile Agent->智能体->单智能体应用->创建应用：创建应用：**选择创建类型：单智能体应用 应用名称：AI作业评分系统 应用描述：一个简单的作业自动AI评分系统agent，用户输入评分标准和答案后，AI自动进行评分**点击立即创建：添加提示词：你现在扮演一名严谨型作业评分员 A，根据老师给出的作业要求，对学生答案进行打分和点评。下面是本次作业的要求和答案以及学生提交的作业请你按照以下要求评分与点评：评分标准重点考察：是否符合题意、关键知识点是否完整、推理是否正确。分数范围：0–100 分，必须给出一个整数。输出格式（必须严格遵守）分数：<数字>/100 评语： 1）优点：…… 2）问题：…… 3）改进建议：……其他要求只根据上面给出的作业要求和答案进行判断，不要杜撰题目外的信息。评语尽量简洁、具体，可操作，不要客套话，不要重复题目内容。不要说明你的身份，也不要输出多余的前后缀文字。2. 调试并发布智能评分Agent输入以下问题，调试AI评分助手：【作业要求】 用自己的话说明什么是“二分查找算法”，并给出它在有序数组上的时间复杂度分析。要求：描述算法的基本思想；说明对输入数据的前提条件；给出时间复杂度并简单解释原因。 满分：100 分。【标准答案】基本思想： 二分查找在有序数组中查找目标值，每次比较中间元素与目标值：若相等则查找成功；若目标值小于中间元素，则在左半部分继续查找；若目标值大于中间元素，则在右半部分继续查找。 不断缩小查找区间，直到找到或区间为空。前提条件： 查找对象必须是有序的顺序存储结构（通常是有序数组）。时间复杂度： 时间复杂度为 O(log n)，因为每一步都把搜索区间缩小为原来的一半，最多进行约 log₂n 次比较。【学生答案】 二分查找就是从中间开始找，如果中间的数不是我们要的，就往两边继续找，直到找到为止。 它适合在数组里找数，速度很快。 时间复杂度是 O(n)，因为最多要把所有元素都看一遍。添加描述后点击发布：发布完成之后，记录调用API的url，留作后面步骤使用。四、创建并使用VS Code远程连接云开发环境（容器）登录华为开发者空间 - 云开发环境平台，右侧页签选择容器，点击创建。创建云开发环境（容器），平台为开发者提供了提供了三类容器模板：从空白创建、公开模板和私有模板。从空白创建：预置标准的鲲鹏通用计算增强型 kc1/2vCPUs/4G/HCE。公开模板：包含Go、Java、Node、Python、All In One等云开发环境（容器）模板，预置了标准的开发工具及环境基础。私有模板：自行创建的私有模板。以公开模板中的Python开发环境为例，这里对其进行选中，点右下角的确定。创建云开发环境（容器）参数说明：参数参数说明样例开发环境名称必填，可包含数字、字母、下划线，不能以数字开头，长度不超过15个字符。testCPU类型默认鲲鹏配置。不可更改CPU配额默认2C配置。不可更改内存配额默认4G配置。不可更改镜像名称必填，根据其预置工具不同，公共模板包含All In One、Go、Java、Python、Node等云开发环境（容器）模板，开发者可根据实际情况进行选择All In One环境变量选填，多个键值对之间使用英文分号分隔，如：key1=value1;key2=value2；变量名称只能由字母、数字和下划线组成，且只能以字母或下划线开头，变量名称与变量值长度不能超过128个字符；最多可添加50个环境变量。/工作目录默认目录/workspace。不可更改运行用户默认root。不可更改配置完成后，点下方的创建开发环境按钮，创建云开发环境（容器）AI_scoring提交成功，状态为创建中，云开发环境（容器）创建大约需要2分钟。云开发环境（容器）创建完成后，可以在容器页签的开发环境列表中查看详细信息，其状态变更为已就绪，点击开机执行开机操作后，云开发环境状态由已就绪变为开机中。点击远程连接，连接vscode选择vscode为VScode安装对应的插件选择相信，用于安装华为云的插件安装后，下方显示未登录，点击此处，进行登录选择打开网页进行登录选择账号进行登录登录成功后，VScode显示已登录点击左边的华为开发者空间插件找到正在运行的云开发环境——AI_scoring点击连接选择continue进行连接连接后选择相信作者（即用户本人）创建IAM用户及获取IAM用户信息使用华为账号登录IAM控制台，点击创建用户配置用户基本信息：配置项内容用户信息填写IAM用户名访问方式勾选编程访问、管理控制台访问凭证类型勾选访问秘钥、密码 ，自定义IAM账号密码登录保护关闭登录保护注意：记录IAM用户名、IAM账号密码，IAM用户登录时需要使用。选择用户名，打开管理控制台访问，再点击下一步填写自定义的密码选择admin并创建用户使用IAM账号登录华为云官网登录成功后，进入控制台，选择华北-北京四，右上角个人信息点击我的凭证进入API凭证界面，即可获取IAM用户信息，记录IAM用户名、账号名、区域华北-北京四对应的项目ID，留作后面步骤使用。注意：本案例中使用华北-北京四对应的项目ID。退出IAM账号，使用第一步注册的华为账号重新登录华为开发者空间开发平台。五、轻量级智能评分助手Agent集成实战1. 获取智能评分助手项目代码点击版本控制图标，再点击Initialize Repository：clone代码，输入代码仓地址，Clone from URL：https://gitcode.com/gcw_S9SSfW0T/AI-Scoring.git选择代码仓目录：/root/选择相信以继续2. 安装项目依赖按下Ctrl+Shift+`，打开Terninal窗口，选择SmartOfficeAssistant目录，安装requests。pip install requests flask3. 获取Token鉴权Agent API调用需要通过用户Token进行用户鉴权，所以接口调用前，需要先获取用户的Token。注意：华为账号不支持直接获取账号Token，华为账号获取Token需创建一个IAM用户并授予该用户必要的权限，使用创建的IAM用户名和密码，获取IAM用户Token。IAM用户名和密码，我们已经在“二、环境准备中的3. 创建IAM用户及获取IAM用户信息”中获取。在SmartOfficeAssistant文件夹下，查看编辑get_token.py文件。注意：MAIN_USER替换成“二、环境准备中的3. 创建IAM用户及获取IAM用户信息”获取的账号名；IAM_USER替换成“二、环境准备中的3. 创建IAM用户及获取IAM用户信息”获取的IAM用户名；PROJECT_ID替换成“二、环境准备中的3. 创建IAM用户及获取IAM用户信息”中获取的华北-北京四区域对应的项目ID；IAM_PASSWORD替换成“二、环境准备中的3. 创建IAM用户及获取IAM用户信息”中创建用户时，设置的IAM账号密码。运行get_token.py：python get_token.pytoken即保存在token.txt文件中。4. 测试AI自动评分助手以下是对 main. py 代码功能和结构的详细说明：1. 总体架构后端框架：使用 Flask (app = Flask(__name__)) 提供 Web 服务。前端展示：使用 HTML/CSS (Tailwind CSS) / JavaScript 构建了一个单页面的仪表盘界面，内嵌了聊天窗口。AI 集成：后端通过 HTTP 请求与远程的华为云 AI Agent 进行通信。2. 主要功能模块详解A. 基础配置与工具函数依赖库：引入了 requests 处理 HTTP 请求，urllib3 处理 SSL 警告，uuid 生成唯一会话 ID。Token 读取 (read_token_from_file)：为了安全起见，认证所需的 Token 不直接写在代码里，而是从本地文件 token.txt 中读取。AI Agent 调用核心 (call_agent)：功能：这是代码的核心逻辑。它向华为云的特定 API 端点发送 POST 请求。流式处理：使用了 stream=True 和 iter_lines。代码设计用于处理流式响应 (SSE)（即 AI 一个字一个字吐出的效果），但在这里它将流式数据拼接成完整字符串 (full_content) 后再一次性返回给前端。容错：包含对 Token 缺失、网络错误、JSON 解析错误的异常处理。B. Web 路由 (Routes)主页路由 (@app.route('/'))：前端技术栈：样式：使用 Tailwind CSS CDN，快速构建现代化的 UI（紫色/蓝色渐变风格）。图标：使用 FontAwesome。交互：包含原生 JavaScript。页面内容：仪表盘：展示了“作业提交”、“AI智能评分”、“成绩统计”等功能悬浮聊天窗：页面右下角有一个 AI 助手图标，点击可展开聊天界面。JavaScript 逻辑：负责监听用户输入，通过 fetch API 将消息发送给自家的后端 /api/agent 接口，并将返回结果显示在聊天气泡中。API 接口路由 (@app.route('/api/agent'))：功能：作为前端和华为云 AI 之间的中间层（Proxy）。流程：接收前端发来的 JSON 数据（用户消息）。生成或复用 conversation_id。调用内部的 call_agent 函数去请求真正的 AI 服务。将简单的内存级对话历史记录在全局变量 conversations 字典中。将 AI 的回复以 JSON 格式返回给前端。3. 代码逻辑流程图解用户在网页聊天框输入 ⬇ 前端 JavaScript 捕获输入 ⬇ 发送 POST 请求到本机的 /api/agent ⬇ Flask 后端接收 -> 读取 token.txt -> 调用 call_agent() ⬇ requests 向华为云 API 发送请求 (带 X-Auth-Token) ⬇ 华为云 AI 处理并返回流式数据 ⬇ Flask 后端接收流数据 -> 拼接成完整文本 ⬇ Flask 返回 JSON 响应给前端 ⬇ 前端 JavaScript 解析 JSON -> 更新聊天界面 DOM 先修改url: YOUR_URL替换成“三、创建并发布智能评分Agent中的2. 调试并发布智能评分Agent”中获取的url，再使用 python main.py 运行代码在浏览器中输入：http://127.0.0.1:8082，或者点击Open in Browser进入智能评分系统平台。右下角体验AI自动评分助手：6. 释放资源延时：注：云开发环境（容器）被创建后，其使用时长为15小时，当用户时长小于60分钟时可申请延时，若时长大于60分钟，则不允许申请延时。关机：注：云开发环境的状态由关机中变为已就绪(持续时间2分钟左右)，在已就绪的状态下可以进行删除操作。删除：点击右上角关闭按钮，关闭Remote SSH远程连接窗口。完成关机后，状态变为已就绪。云开发环境（容器）PC端会同步状态。至此，基于华为开发者空间-云开发环境（容器）+ Versatile Agent，构建AI轻量级智能评分助手的案例已全部完成。“我正在参加【案例共创】基于华为开发者空间云开发环境（容器）开发构建AI应用 https://developer.huaweicloud.com/signup/4ffb9c18acff4fe79a782683c1277bbf

 传送门活动帖子(指定评论区)：cid:link_2 活动报名页面：cid:link_1 产品体验入口：华为开发者空间--开发平台--Versatile Agent

一、概述1. 案例介绍利用华为云提供的强大AI与开发工具，构建一个轻量级、趣味性强的AI应用——“智能笑话机器人”。该机器人能够理解用户的意图，并以一个幽默风趣的喜剧演员的口吻，为用户提供源源不断的笑话，为日常生活增添一份乐趣。通过本案例的实践，开发者可以体验到从AI智能体（Agent）的创建、后端服务的开发，到最终Web应用部署的全过程。这不仅是一个有趣的AI应用开发入门教程，也是一个展示如何将大型语言模型（LLM）的能力快速封装成具体产品的典型示例。2. 适用对象企业个人开发者高校学生3. 案例时间本案例总时长预计90分钟。4. 案例流程用户进入开发者空间开发平台云开发环境, 创建容器;创建并发布智能机器人Agent应用;编写Web端项目代码集成Agent API;使用浏览器测试并体验智能笑话机器人助手。5. 资源总览本案例预计花费0元。资源名称规格单价 (元)时长 (分钟)华为开发者空间开发平台 - 云开发环境 (容器)鲲鹏通用计算增强型 kc1 | 2vCPUs | 4G | HCE免费90华为开发者空间 - Versatile Agent 平台系统标配免费90二、环境准备1. 领取注册开发者空间开发者空间是开发者专属的云上成长空间, 预置免费华为根技术工具和资源, 为开发者提供从学习、开发到部署的全旅程支持。点击免费领取, 立即领取开发者空间。2. 云开发环境（容器）的创建及操作登录华为开发者空间- 云开发环境平台, 右侧页签选择容器, 点击创建。创建云开发环境（容器）, 平台为开发者提供了提供了三类容器模板：从空白创建、公开模板和私有模板。从空白创建: 预置标准的鲲鹏通用计算增强型 kc1/2vCPUs/4G/HCE。公开模板: 包含Go、Java、Node、Python、All In One等云开发环境（容器）模板, 预置了标准的开发工具及环境基础。私有模板: 自行创建的私有模板。以公开模板中的Python开发环境为例, 这里对其进行选中, 点右下角的确定。在云开发环境（容器）配置页面, 基础配置板块, 填写开发环境名称: my_test。高级配置板块, 镜像名称选择 Python。创建云开发环境（容器）参数说明:参数参数说明样例开发环境名称必填, 可包含数字、字母、下划线, 不能以数字开头, 长度不超过15个字符。testCPU 类型默认鲲鹏配置。不可更改CPU 配额默认2C配置。不可更改内存配额默认4G配置。不可更改镜像名称必填, 根据其预置工具不同, 公共模板包含All In One、Go、Java、Python、Node等云开发环境（容器）模板, 开发者可根据实际情况进行选择All In One环境变量选填, 多个键值对之间使用英文分号分隔, 如: key1=value1;key2=value2; 变量名称只能由字母、数字和下划线组成, 且只能以字母或下划线开头, 变量名称与变量值长度不能超过128个字符; 最多可添加50个环境变量。/工作目录默认目录/workspace。不可更改运行用户默认root。不可更改配置完成后, 点下方的创建开发环境按钮, 创建云开发环境（容器）my_test 提交成功, 状态为创建中, 云开发环境（容器）创建大约需要2分钟并选择开机。开机需耗时1~3分钟, 完成开机后, 状态变为运行中。3. 创建IAM用户及获取IAM用户信息使用华为账号登录IAM控制台, 点击创建用户。配置项内容用户信息填写IAM用户名访问方式勾选编程访问、管理控制台访问凭证类型勾选访问秘钥、密码, 自定义IAM账号密码登录保护关闭登录保护注意: 记录IAM用户名、IAM账号密码, IAM用户登录时需要使用并加入用户组admin。使用IAM账号登录华为云官网。登录成功后, 进入控制台, 选择华北-北京四, 右上角个人信息点击我的凭证。进入API凭证界面, 即可获取IAM用户信息, 记录IAM用户名、账号名、区域华北-北京四对应的项目ID, 后面步骤使用。注意:本案例中使用华北-北京四对应的项目ID。退出IAM账号, 使用第一步注册的华为账号重新登录华为开发者空间开发平台。三、创建并发布每日笑话机器人Agent1. 创建每日笑话机器人Agent对于已开通Versatile Agent服务的开发者, 直接进入华为开发者空间开发平台, 点击开发平台->Versatile Agent->智能体->单智能体应用->创建应用:选择创建类型: 单智能体应用应用名称: 每日笑话机器人应用描述: 每日笑话机器人助手是一款专为提升用户日常欢乐指数设计的AI幽默大师。它能够智能生成各类风格的笑话（包括冷幽默、谐音梗、情景喜剧等），并支持根据用户偏好定制笑话主题和难度级别。该助手具备情绪感知能力，可在用户疲惫或压力大时主动推送轻松内容，同时提供收藏分享功能便于传播快乐。主要服务于压力人群、社交达人及需要调节气氛的职场团队，通过科学验证的幽默疗法帮助缓解焦虑、促进人际互动，让每一天都从会心一笑开始。点击立即创建。添加提示词:人设:你是一个幽默风趣的喜剧演员，你的唯一任务就是用中文给用户讲各种类型的笑话，让用户开心任务描述:当用户让你讲笑话时，请你生成一个简短、有趣的笑话。不要做讲笑话之外的任何事情选择模型: DeepSeek-V3-64K智能添加开场白和推荐问题。2. 调试并发布每日笑话机器人助手Agent输入以下问题, 调试每日笑话机器人助手:问题: 请分享一个简短有趣的笑话点击发布。发布完成之后, 记录调用API的url, 后面步骤使用，智能笑话机器人Agent已成功创建并发布。四、VS Code远程连接云开发环境（容器）华为开发者空间 - 云开发环境（容器）支持VS Code等IDE远程连接。在云开发环境（容器）“my_test”操作栏点远程连接 > VS Code。此时若Visual Studio Code未安装, 请点前往下载, 然后点继续前往, 跳转官网, 对其进行下载安装。若VS Code已经在PC本地安装, Google浏览器将会提示“要打开Visual Studio Code吗?”, 点击打开Visual Studio Code。1. 安装插件打开VS Code后, 提示安装Huawei Developer Space, 点Install Extension and Open URI。2. 授权/认证与登录插件安装完成后, 会自动打开并提示跳转开发者空间登录, 选择允许。提示是否打开网站, 选择Open。网站自动跳转, 此处选择确认授权。返回VS Code, 显示登录成功。注意: 如果登录的是未实名/未签署协议的帐号, 首次进入会提示跳转至web实名/签署协议, 若是关了弹框, 点击创建的时候会再次提醒。3. 远程连接云开发环境与云开发环境（容器）my_test的Remote SSH远程连接被成功创建。五、轻量级智能笑话机器人助手Agent集成实战1. 获取智能笑话机器人助手项目代码点击 “Terminal” (终端) -> “New Terminal” (新建终端)。clone代码, 输入代码仓地址, Clone from URL:https://gitcode.com/weixin_43757402/mybot.git2. 安装项目依赖按下Ctrl+Shift+, 打开Terminal窗口, 选择 mybot 目录, 安装requests\Flask。pip install requests pip install Flask pip install --upgrade flask3. 获取Token鉴权Agent API调用需要通过用户Token进行用户鉴权, 所以接口调用前, 需要先获取用户的Token。二、环境准备中的3. 创建IAM用户及获取IAM用户信息”中获取。在mybot文件夹下, 查看编辑get_token.py文件。注意:MAIN_USER替换成“二、环境准备中的3. 创建IAM用户及获取IAM用户信息”获取的账号名;IAM_USER替换成“二、环境准备中的3. 创建IAM用户及获取IAM用户信息”获取的IAM用户名;PROJECT_ID替换成“二、环境准备中的3. 创建IAM用户及获取IAM用户信息”中获取的华北-北京四区域对应的项目ID;IAM_PASSWORD替换成“二、环境准备中的3. 创建IAM用户及获取IAM用户信息”中创建用户时, 设置的IAM账号密码。点击右上角运行按钮, 运行get_token.py文件。token即保存在token.txt文件中。4. 每日笑话机器人助手代码功能介绍mybot├── get_token.py # 职责：获取API访问令牌(Token)的Python文件├── main.py # 职责：“每日笑话机器人”的主执行文件│ └── read_token_from_file() # 功能：从文件中读取Token│ └── call_agent() # 功能：调用“笑话机器人”Agent的函数│ └── index() # 功能：主页路由，包含“笑话机器人”的UI界面│ └── get_joke_api() # 功能：处理前端获取笑话请求的API└── token.txt # 说明：运行get_token.py后生成，保存获取到的Token注意: call_agent方法中的AGENT_URL替换成“三、创建并发布每日笑话机器人Agent中的2. 调试并发布智能笑话机器人助手Agent”中获取的url。# 调用Agent的函数 def call_agent(query, conversation_id=None): url = f"AGENT_URL" # 此处更换agent url payload = json.dumps({"query": query}, ensure_ascii=False) 5. 测试体验智能笑话机器人助手运行智能笑话机器人助手Web项目: 点击右上角运行按钮, 运行main.py文件。在浏览器中输入: http://127.0.0.1:8082, 或者点击Open in Browser进入智能笑话机器人助手系统平台。体验智能每日笑话机器人助手: 点击 给我讲个笑话基于华为开发者空间-云开发环境（容器）+ Versatile Agent，构建AI轻量级智能笑话机器人助手。

智能体平台 Versatile/ 常见问题/ Agent应用/ 单智能体模式支持上传文件吗？单智能体支持上传文件，目前单智能体模式支持图片文件、音频文件和图片文件等。图片文件说了两遍。https://support.huaweicloud.com/versatile_faq/versatile_05_0013.html 

智能体平台 Versatile/ 常见问题/ 提示词/ 创建提示词时模型参数详解针对话题重复度控制的解释错误，直接复制了最大token限制的解释了https://support.huaweicloud.com/versatile_faq/versatile_05_0028.html

活动介绍：时下大热的AI Agent智能体，正推动千行万业进入AI数字生产力的革新快轨。Versatile智能体平台是华为云在本年度重磅推出的一站式企业级智能体构建平台，面向企业AI+转型、软件及解决方案提供商、独立开发者等多角色多场景，使能高效开发Agent，将“人人都能构建自己的企业级智能体”产品愿景照进现实。为了让Versatile产品能力更贴合用户应用场景、进一步满足用户需求、提升体验，我们发起本次产品体验官招募活动，邀请各位有热情、有想法的开发者们加入Versatile智能体平台体验官阵营，提出真实的产品改进意见，以帮助产品开发和优化迭代。期待联接广大开发者们的力量，合力构建易用、好用、开放的AI Agent平台。图：产品架构图图：产品界面图 活动时间：2025.11.4-2025.12.15 活动流程：1、 在活动页点击报名后，进入官方微信群开通服务（下图），访问产品体验环境：华为开发者空间--开发平台--Versatile Agent2、 参照官网帮助文档（内含实践案例指导）或收录进案例中心的实操案例，进行产品深度使用体验；同时需创建并发布任一类型的智能体应用（至少一个）;3、 将体验完成截图发送至活动指定评论区（本帖下方），跟帖评论体验感受，可以围绕体验流程、操作步骤、问题建议（搭配产品界面截图说明）等方向进行展开说明；4、在官网云声·建议平台，反馈产品优化建议。（注：以上四步需全部完成）  服务开通方式：报名成功后，请参与者扫描二维码进入官方微信群，进群后请发送“我要开通Versatile，账号ID是xxxxxx”，技术支持将辅助在24小时内完成服务开通；同时欢迎在群聊内开展技术交流，反馈操作疑问。（Versatile智能体平台产品体验交流群）TIPS:账号ID获取路径：华为云控制台-右上角账号名下拉窗口-账号ID（红框内，可复制）示意图：  产品体验官职责：为了构建更好的用户体验，各体验官可从以下要素考虑，反馈体验感受，包括：交互体验层面、感官体验层面、bug类、需求类、能力创新类等等。 奖项设置：奖项设置获奖要求获奖名额激励礼品高价值建议奖被评选为高价值需求3每人价值500元开发者礼包1份建议贡献排名奖被采纳建议数≥3条，且根据积分排名TOP55每人价值200元开发者礼包1份说明1、每条被采纳建议累计1积分，被采纳建议数统计截止时间为2025年12月15日24点；2、若出现积分相同且排名一致的情况，因奖品数量有限，根据先到先得原则进行发放；3、同一用户仅限获评一个奖项；4、 如礼品库存不足将存在替换成等价值礼品的可能；5、激励礼品如下：序号礼包名称介绍1500元开发者礼包华为手环8NFC版（黑色）华为12000mh移动电源充电宝（白色）开发者定制不锈钢水杯   开发者空间定制鼠标垫（大号）2200元开发者礼包华为FreeBuds SE 2无线耳机（白色）U型按摩枕开发者空间定制鼠标垫（大号）(奖品示意图）  活动说明：1、 完成体验请进入活动指定评论区（本帖下方），截图体验完成的实际截图，并说明体验感受。提交建议内容需表述清晰，有操作截图、链接等详细描述。2、 您对Versatile智能体平台有任何改进建议，请提交至云声·建议平台（填写时，关联产品/功能 选择“智能体平台Versatile”) 并标明以【Versatile智能体平台体验】为开头，让我们听到你的声音，为产品改进贡献一份力量。示例：【Versatile智能体平台体验】整体上手体验不错，建议考虑XXX场景，实现AI应用一键分享的能力等等。3、所有参与活动的开发者需要完成实际体验，有任何问题欢迎进入Versatile论坛阵地发帖交流，我们将在48小时内解答。  关于华为云Versatile智能体平台产品官网主页：cid:link_5帮助文档：cid:link_1Versatile论坛交流阵地：cid:link_4产品体验入口：华为开发者空间--开发平台--Versatile Agent 

 (2025年10月）  < 华为云Versatile智能体平台 体验入口>华为开发者空间--开发平台--Versatile Agent （请在PC端打开）  版本概览  Summary   华为云Versatile智能体平台定位为一站式企业级智能体构建平台，倡导人人都能构建自己的企业级智能体。本次十月版本升级围绕MCP服务、工作流应用、知识库、插件、工作空间等模块实现10+项特性优化，全力为开发者们在创建创意智能体过程中带来更流畅的体验，与开发者合力构建易用、好用、开放的AI Agent平台。   新增重点特性介绍  Introduction     01  资产中心  资产中心 · MCP广场 新增80+官方预置MCP工具，总数累计达100业务价值：丰富MCP资产的类型与数量，开箱即用，降低开发门槛，为用户带来更流畅的开发体验。   02 Agent发布     应用管理 · 支持单智能体应用、工作流应用发布为网页，可在web端打开Agent进行快速交互。业务价值：通过一键发布，生成链接，支持在web端以网页形式快捷访问智能体应用，丰富打开方式。    03  工作流节点   应用管理-工作流应用 · 新增异常节点功能，用户可以根据业务需求自定义异常信息。可通过直接输入或插入创建好的消息模板，在异常码抛出中输入异常信息。业务价值：可由用户自主抛出业务异常。异常节点用于抛出预定义的业务异常码，可传递给中控进行后续处理。   配置管理 · 新增消息模板功能，用户可以自定义消息模板，并在工作流应用的对应节点中使用。(如：异常分类的消息模板可以在异常节点中使用）业务价值：通过将消息完成结构化创建存为模板，实现租户或工作空间内的共享；方便在节点创建时直接选用模板，简化操作。  应用管理-工作流应用 · 工作流应用在编排节点配置时，支持通过搜索栏输入关键词，快速定位所需引用参数业务价值：提供关键词搜索能力，方便用户快速定位所需参数，提升筛选效率。   · 消息节点支持引用流式和非流式输出参数业务价值：丰富消息节点的引用模式。  04  数据能力   知识库 · 知识库新增查看引用功能，提供引用列表，可查看当前知识库被哪些智能体和工作流引用业务价值：提供知识库被引用关系溯源，便于清晰查看知识库被引用的路径，用于判断知识库变更对哪些Agent、检索流产生影响。    05 插件能力   组件库-我的插件 · 创建插件支持多工具管理，一个插件下可以新建多个相关工具业务价值：优化插件创建流程，实现插件的多工具集合管理，通过类别划分支撑插件在智能体选用时更为便捷。  应用管理 · 在智能体及工作流应用中，灵活选择多个插件下的工具或一个插件下的多个工具。业务价值：提高插件选择的便捷性，优化用户体验。   06  工作空间  工作空间 · 工作空间角色优化，增加开发工程师、运维工程师业务价值：通过增加特定角色，优化对团队空间的操作权限细分，方便组织内多岗位成员协作，显著提升团队的工作效率。    07  模型管理  模型调测· 模型服务调测时，支持一键清除输入内容业务价值：一键快速清除，提升模型调测的操作效率。  08  开发中心   应用管理· 单智能体应用、工作流应用在“发布管理”页面支持复制URL业务价值：可一键复制，简化操作，提升用户体验。 · 调用工作流应用接口，增加响应参数业务价值：补充响应参数信息，方便调用查看。 点击可前往>>华为云Versatile智能体平台 官网   

 为方便开发者们参照实操案例进行Versatile产品体验特地把收录进案例中心的Versatile相关案例搬运过来，方便查看后续持续更新~hi~ 来试试构建出彰显个人创意的AI Agent智能体(小助手） 案例标题入口推荐值案例创作方基于华为开发者空间-Versatile Agent构建旅游出行助手LINK⭐⭐⭐⭐⭐官方(开发者空间)华为开发者空间云开发环境+Versatile Agent，构建AI轻量级智能办公助手LINK ⭐⭐⭐⭐官方(开发者空间)基于华为开发者空间开发平台 MCP资产快速构建AI Agent应用LINK ⭐⭐⭐官方(开发者空间)基于华为开发者空间开发平台构建We码会议助手LINK ⭐⭐⭐⭐官方(开发者空间)基于开发者空间开发平台工作流构建旅行行程规划应用LINK ⭐⭐⭐官方(开发者空间)【案例共创】基于华为云开发者空间-Versatile Agent开发平台构建昇腾C算子开发知识库LINK⭐⭐⭐⭐⭐贡献用户：黄生【案例共创】使用开发者空间 AI Agent+RAG+高德地图MCP开发班车出行助手LINK ⭐⭐⭐⭐贡献用户：神一样的老师【案例共创】基于华为开发者空间Versatile agent平台快速搭建智能搜索可视化应用LINK ⭐⭐⭐贡献用户：胡琦【案例共创】基于华为开发者空间构建实时股票分析助手LINK ⭐⭐⭐贡献用户：miyalian【案例共创】基于华为开发者空间-AI Agent开发平台构建旅游规划助手LINK ⭐⭐⭐贡献用户：yd_272483742【案例共创】基于华为开发者空间开发平台 MCP资产快速构建税务AI助手服务LINK ⭐⭐⭐贡献用户：小草飞上天【案例共创】基于华为云开发者空间的AI Agent【旅行灵感生成器】智能体LINK ⭐⭐⭐贡献用户：柠檬味拥抱【案例共创】基于华为云开发者空间-Versatile Agent开发平台零基础开发购房助手LINK ⭐⭐⭐贡献用户：CC07   < 华为云Versatile智能体平台 体验入口>华为开发者空间--开发平台--Versatile Agent （请在PC端打开）