概述
本文将介绍如何完成火山方舟高代码应用的在线创建、部署、体验和修改全流程。
对于高代码应用的介绍请参考高代码产品使用说明--火山方舟大模型服务平台-火山引擎。
方舟高代码应用基于veFaaS函数服务等多个云产品,提供了便捷的在线部署流程和生产级的运行环境。如无法满足需求,您也可以选择使用高代码应用sdk在本地或其他环境进行开发。
注意
高代码应用功能已对个人用户开放使用。如需使用,请完成实名认证。
一、创建高代码应用
登录火山方舟控制台,访问“应用广场-创建应用-创建高代码应用”。

1.1 权限获取
- 进入高代码应用创建页时,您需具备高代码应用所需权限,将进行IAM权限校验。
- 高代码在线部署依赖veFaaS函数服务,需要授权IAM角色
SeverlessApplicationRole
。 - 首次创建IAM角色需由主账号操作,如您登录的为子账号,可先点击【立即开通】,并根据提示点击【复制信息】并发送给主账号管理员,由主账号管理员创建角色并对子账号授权。

如您登录的为主账号,且已完成企业认证,
- 您可直接点击【立即开通】,进行ServerlessApplicationRole授权。
- 您也可请前往【访问控制- 角色管理】模块,进行空白角色服务新建,并在后续应用创建时,需根据提示添加权限。具体操作如下:
【新建角色】

选择信任身份类型为「服务」,选择服务为「火山方舟」,点击下一步
角色名填写:ServerlessApplicationRole,其余均不填,点击下一步
不选择策略,点击跳过,完成角色授权。
后续在高代码应用创建时,根据提示按需配置策略:CloudMonitorReadOnlyAccess,TLSFullAccess,VPCFullAccess,VeFaaSFullAccess,STSAssumeRoleAccess,APIGFullAccess
完成授权后,将提示「IAM角色已授权」

1.2云产品服务开通
- 高代码应用在线部署依赖函数服务等多个云产品提供的服务,需要开通相关云产品。
- 若存在未开通产品,可通过页面上的【立即开通】,在阅读相关协议文档后批量开通相关云产品。


1.3 创建高代码应用
填写应用名称等基础信息后,点击页面右上角“发布”按钮。
保存后即可通过【创建新函数】去部署高代码应用相关联的函数服务。

二、部署高代码应用
完成“创建函数应用”页面的配置,进行高代码应用函数服务的创建部署。

2.1 所需权限及产品开通
- 若在创建高代码应用时完成了权限获取和云产品开通,应当已具备所需权限和服务。
- 若IAM角色未授权或关联云服务未开通,请联系管理员进行授权或开通,可参考1.1 权限获取。
2.2 选择推理接入点和API Key

2.3 填写函数名称
填写函数名称等基础信息。
2.4 配置日志服务-Trace(可选)
启用 Trace 日志服务后,系统将自动采集您请求的 input 和 output 及各阶段耗时信息,并记录在您的日志服务中,便于后续运维和排查。
选择启用“日志服务-Trace”后,需要填写API 访问密钥(AK/SK),可参考可在此获取AK/SK。

2.5 选择触发器
为了在调用时触发执行函数,需要在创建函数时关联触发器,现为您提供以下类型触发器。

触发器类型 | 目标群体 | 创建流程 | 调用流程 |
---|
方舟触发器(推荐使用) | 默认提供,面向无特殊要求的大部分群体。 | 创建高代码应用时选用方舟触发器,即可将函数服务关联到指定的高代码应用ID。 | 获取方舟长效/短效API key,调用时通过方舟统一域名+BotID,使用API key鉴权。 |
APIG触发器-API 网关服务 | 有独立部署网关需求
对信息传输安全性要求高,需要通过VPC保障数据安全。
对APIG、VPC了解深入,已有相关服务配套设施。 | 已有APIG:选择关联的APIG。确认部署应用后将创建关联的APIG触发器。
无APIG但有VPC:跳转到APIG控制台,创建好APIG后再关联。
无VPC:跳转到APIG控制台,创建好VPC和APIG后再关联。 | 获取有效期7天的jwt token,通过APIG调用,使用jwt token鉴权。 |
2.6 确认部署

- 部署需耗时约数分钟,请耐心等候。页面上将展示部署日志,若部署失败可根据日志信息定位原因。
- 部署成功后,可通过页面右上角按钮跳转到函数代码页编辑代码,或返回体验应用。
三、修改和体验高代码应用
完成部署后,您可根据业务需求对函数代码进行修改、更新、发布。
3.1 体验高代码应用和Trace追踪
等待应用完成部署,函数完成发布后,您就可以在高代码应用页面上和应用交互进行体验了。

在体验中得到的回答,可以点击右侧的“调试按钮”,获取调试信息。

您也可以参考下文修改优化高代码应用,让应用的表现更符合您的预期。
3.2 修改高代码应用
在高代码应用编辑页,点击“更新代码”进入函数代码管理页修改代码。

方案一:在线编辑

- 您可在线进行代码修改,按照您的配置调整各插件参数,以进行效果和性能优化或实现业务逻辑。详见SDK说明文档
- 完成编辑后,点击保存按钮保存代码,保存完成后可进行函数发布。
方案二:下载代码包编辑
代码包下载
您可在函数代码页下载最新版本服务对应的代码包。

修改代码
- 您可在本地IDE进行代码修改,按照您的配置调整插件参数,以进行效果和性能优化或实现业务逻辑。
详见SDK说明文档 应用SDK说明文档--火山方舟大模型服务平台-火山引擎。
代码包上传和保存
将本地代码包打包为zip文件后,上传更新函数代码。


如线上预览耗时较久,可能是代码包较大。建议在本地预览后,上传到函数服务进行发布。
方案三:使用命令行工具编辑
可以联系我们获取 vefaas命令行工具使用说明文档 使用命令行工具,结合本地IDE进行代码编辑和发布等操作。
函数发布
- 完成代码修改、上传、保存后,可根据需求进行全量发布/灰度发布,并配置函数版本
建议使用灰度发布,防止变更失误影响线上服务


可在函数详情-发布管理找到灰度发布的版本,并调整灰度比例直至全量发布。

完成发布后,可点击对话测试返回

3.3调用和鉴权
- 方舟触发器
- 如果您配置了方舟触发器,可通过 Bot API 接口调用,使用 API key鉴权。接口文档请参见应用(Bot) API。
- APIG 触发器
- 如果您配置了 APIG 触发器,可通过您配置的 APIG 访问地址进行调用。调用时需使用 jwt token鉴权。
四、添加MCP服务 (可选)
当前高代码应用已支持添加MCP服务,以下为具体操作指南:
4.1 创建应用并选择函数模版
- 根据步骤一的指引创建高代码应用,并点击【创建新函数】,在随后弹出的原型应用选择弹窗中,选择【示例-大模型MCP应用】,点击确认


4.2 配置函数及MCP服务
- 函数创建的基础配置请参照“步骤二”,例如权限及产品开通、推理接入点和API Key、触发器选择、日志服务-Trace等。
- 下面为您详细介绍如何添加MCP服务:
- 点击【添加更多MCP服务】,随后的弹窗已为您列出 火山引擎大模型生态广场 中的MCP服务,并支持添加自定义MCP服务


- 根据业务需求选择所需的MCP服务。前往 火山引擎大模型生态广场 生成专属的 JSON 配置信息。如需填写相关环境变量参数,可根据【详情】中的 Readme 进行获取。(注:Remote MCP 添加较为便捷,但生成的URL存在48小时有效期,如需长期使用建议选择 Local MCP 或 云部署MCP版本)

- 将生成的配置信息粘贴至MCP服务设置的config.json中,点击【确认并更新】。完成其他函数配置后,点击 【确定】 进行部署函数。

- 等待函数部署成功后,即可进行对话体验,并调用相应的MCP服务

4.3 二次编辑MCP服务
- 您可对MCP服务进行二次编辑,点击需要编辑的 MCP服务 或【添加更多MCP服务】按钮,操作流程同 4.2

- 完成编辑后,点击【确认并更新】,等待函数更新完成后,即可再次进行对话测试

相关参考