-
前提条件 预置服务或我的服务满足以下条件： 预置服务中商用服务：已开通预置服务中的商用服务。具体操作，请参见在ModelArts Studio（MaaS）预置服务中开通商用服务。 预置服务中免费服务：已领取预置服务中的免费服务额度。具体操作，请参见
免费体验 ModelArts Studio（MaaS）预置服务。 我的服务：已在“我的服务”页面部署模型服务且状态为运行中。具体操作，请参见使用ModelArts Studio（MaaS）部署模型服务。 已在MCP广场开通MCP服务。具体操作，请参见在ModelArts Studio（MaaS）MCP广场开通MCP服务。
-
调用已发布的应用 仅发布的应用支持调用。如果应用的状态为草稿，需要先进行发布才能调用。具体操作，请参见编辑和发布草稿应用。 在“应用管理”页面，在状态为已发布目标应用卡片，单击“调用”，在“调用说明”页面按照页面信息进行调用。 关于创建API Key的操作步骤，请参见在ModelArts Studio（MaaS）管理API Key。 在
函数工作流 FunctionGraph控制台查看应用的调用总量统计及资源用量统计。 数据可能存在1~2小时的时延。
-
编辑和发布草稿应用 您可以在“编辑应用”页面按需修改草稿应用的名称、模型服务、提示词、添加或删除MCP等。 在“应用管理”页面，在状态为草稿的目标应用卡片单击“编辑”。 在“编辑应用”页面，按需修改应用名称、模型服务、提示词、添加或删除MCP等，在右上角单击“保存草稿”或“发布”。 关于参数的说明，请参见表1。单击“发布”后，会出现“计费提醒”对话框，请仔细阅读计费相关信息，然后单击“确定”。关于如何计费，请参见计费说明。 在“应用管理”页面的目标应用卡片中，当应用状态显示为已发布，表示该应用可以调用。
-
计费说明 应用发布后，将托管至函数工作流FunctionGraph服务中。实际计费请以FunctionGraph计费为准，详情请参见FunctionGraph函数工作流计费规则。您可以在函数工作流FunctionGraph控制台查看应用的调用总量统计及资源用量统计。 调用应用按调用请求次数、资源用量（函数执行时间）收费。 每个自然月内，您全部的应用的总请求次数 、总资源用量有一定的免费额度。 MCP服务返回的内容将被计入输入Token消耗。
-
响应示例 状态码： 200 list applications successfully {
"applications" : [ {
"id" : "a2685d64-9bf6-481d-8845-0482271f99cc",
"name" : "testApplication",
"status" : "repoFail",
"last_modified_time" : 1699320954910,
"description" : "test function application"
} ],
"next_marker" : 1,
"count" : 1
}
-
URI GET /v2/{project_id}/fgs/applications 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 租户项目 ID，获取方式请参见获取项目ID。 表2 Query参数 参数 是否必选 参数类型 描述 limit 否 String 本次查询最大返回的数据条数，最大值500，默认值100 缺省值：100 最小长度：1 最大长度：64 marker 否 String 本次查询起始位置，默认值0 缺省值：0 最小长度：1 最大长度：64
-
响应参数 状态码： 200 表4 响应Body参数 参数 参数类型 描述 applications Array of ListFunctionApplicationResult objects 函数应用列表 next_marker Long 下次读取位置 count Long 应用程序总数 表5 ListFunctionApplicationResult 参数 参数类型 描述 id String 应用id name String 应用名称 status String 应用状态 last_modified_time Long 最后修改时间 description String 应用描述 状态码： 400 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 401 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 403 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 404 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息 状态码： 500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误信息
-
应用中心介绍 “MaaS应用体验中心”提供基于行业客户应用场景的AI解决方案。MaaS提供的模型服务和华为云各AI应用层构建工具之间相互连通，通过灵活的组合方案，来帮助客户快速解决模型落地应用时所面临的业务及技术挑战。 MaaS应用体验中心结合
KooSearch 企业搜索服务、盘古数字人大脑和Dify，为具体的客户应用场景提供一整套解决方案。 KooSearch
企业搜索 服务：基于在MaaS开源大模型部署的模型API，搭建企业专属方案、LLM驱动的语义搜索、多模态搜索增强。 盘古数字人大脑：基于在MaaS开源大模型部署的模型API，升级智能对话解决方案，含智能客服、数字人。 Dify：支持自部署的应用构建开源解决方案，用于Agent编排、自定义工作流。
-
响应示例 状态码：200 请求响应成功。 {
"data" : {
"notExistAgentIds" : "[\"362de749046e40de95650fa6b9d677eb\",\"362de749046e40de95650fa6b9d677eb\"]",
"pageInfos" : {
"total" : 3,
"list" : {
"id" : "149fd3a992c044d7960f15e5c09aa6af",
"tenant_id" : "9190086000001247361",
"dept_code" : "d491985550b34b1c901aff363d030c4f",
"agent_id" : "CFEUYYIX6d",
"user_id" : "1008600000300604420",
"agent_work_type" : "agent_llm",
"invoke_count" : 7,
"invoke_succeed_count" : 1,
"invoke_failed_count" : 6,
"prompt_tokens" : 10,
"completion_tokens" : 20,
"total_tokens" : 30,
"duration" : 398.3,
"statistics_time" : "2025/02/27 11:33:39"
}
}
}
} 状态码：400 缺少请求体。 {
"error_code" : "AIAE.00001400",
"error_msg" : "Request body is missing"
} 状态码：500 服务器内部错误或三方服务器内部错误。 {
"error_code" : "AIAE.00001500",
"error_msg" : "Internal Server Error."
}
-
请求示例 分页查询Agent调用情况，每页10条，查询第1页。 https://xxx.x.x.x:xxxx/v1/routes/open/queryAgentInvokeStatistics
{
"agentIds" : "[\"362de749046e40de95650fa6b9d677eb\",\"362de749046e40de95650fa6b9d677eb\"]",
"startTime" : 1740588223000,
"endTime" : 1740714223000,
"current" : 1,
"pageSize" : 10
}
-
响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 pageInfos RecordsStatisticsVo object 参数解释： 查询成功时接口返回的分页数据列表。 取值范围： 不涉及。 notExistAgentIds Array of strings 参数解释： 不存在的Agent ID列表。 取值范围： 不涉及。 表4 RecordsStatisticsVo 参数 参数类型 描述 id String 参数解释： 主键ID。 取值范围： 不涉及。 agentId String 参数解释： Agent ID。 取值范围： 不涉及。 userId String 参数解释： 用户 ID。 取值范围： 不涉及。 agentWorkType String 参数解释： Agent 工作类型。 取值范围： 不涉及。 invokeCount Number 参数解释： 调用总次数。 取值范围： 不涉及。 invokeSucceedCount Number 参数解释： 调用成功次数。 取值范围： 不涉及。 invokeFailedCount Number 参数解释： 调用失败次数。 取值范围： 不涉及。 promptTokens Number 参数解释： 提示tokens。 取值范围： 不涉及。 completionTokens Number 参数解释： 输出tokens。 取值范围： 不涉及。 totalTokens Number 参数解释： 总tokens。 取值范围： 不涉及。 duration Number 参数解释： 时延。 取值范围： 不涉及。 tenantName String 参数解释： 租户名称。 取值范围： 不涉及。 statisticsTime Number 参数解释： 统计时间。 取值范围： 不涉及。 状态码：400 表5 响应Body参数 参数 参数类型 描述 error_code String 参数解释： 错误码。 取值范围： 不涉及。 error_msg String 参数解释： 错误信息。 取值范围： 不涉及。 状态码：500 表6 响应Body参数 参数 参数类型 描述 error_code String 参数解释： 错误码。 取值范围： 不涉及。 error_msg String 参数解释： 错误信息。 取值范围： 不涉及。
-
请求参数 表1 请求Header参数 参数 是否必选 参数类型 描述 Authorization 是 String 参数解释： 鉴权信息。获取平台API Key，并为API Key添加前缀Bearer，得到标准鉴权信息，例如Bearer sk-74e4157***。API Key获取方法请参见创建API Key。 约束限制： 不涉及。 取值范围： 不涉及。 默认取值： 不涉及。 表2 请求Body参数 参数 是否必选 参数类型 描述 agentIds 否 Array of strings 参数解释： 需要查询的Agent ID的列表。 约束限制： 格式为uuid列表,列表数量不超过100。 取值范围： 不涉及。 默认取值： 不涉及。 startTime 是 Number 参数解释： 需要查询的Agent ID的统计开始时间。 约束限制： 毫秒级别时间戳。 取值范围： 不涉及。 默认取值： 目前最多查询近一个月的数据。 endTime 是 Number 参数解释： 需要查询的Agent ID的统计结束时间。 约束限制： 毫秒级别时间戳。 取值范围： 不涉及。 默认取值： 目前最多查询近一个月的数据。 current 是 Integer 参数解释： 当前页号。 约束限制： 数字。 取值范围： 大于0。 默认取值： 1。 pageSize 是 Integer 参数解释： 每页数量。 约束限制： 数字。 取值范围： (0,999]。 默认取值： 10。
-
响应参数 状态码：400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：401 表6 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：403 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：404 表8 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：405 表9 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：500 表10 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。 状态码：503 表11 响应Body参数 参数 参数类型 描述 error_code String 错误码，失败时返回。 error_msg String 错误描述。
-
请求示例 {
"app_ids" : [ "3f791197-d166-4c8e-81e4-38c40ffc1989", "62f48b59-0ebb-4b1e-ad35-f64948a0591b" ],
"assign_scope" : "ALL_USER",
"users" : [ {
"account" : "zhangsan******@test.com",
"domain" : "siv.**.huawei.com",
"account_type" : "SIMPLE",
"platform_type" : "AD"
} ]
}
-
请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 否 String 用户Token。 通过调用
IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 表3 请求Body参数 参数 是否必选 参数类型 描述 app_ids 是 Array of strings 批量唯一标识请求列表，一次请求数量区间 [1, 50]。 assign_scope 是 String ALL_USER - 全部用户 ASSIGN_USER - 授权指定用户 users 否 Array of AccountInfo objects 用户列表，一次请求数量区间 [1, 50]。 表4 AccountInfo 参数 是否必选 参数类型 描述 account 是 String 账户，账户的格式必须为:账户(组)的形式。 domain 否 String
域名 (用户组必填，不填时使用默认值 local.com)。 account_type 是 String 账户类型： 'SIMPLE' - 普通用户 'USER_GROUP' - 用户组 platform_type 否 String 平台类型： AD - AD域 LOCAL - LiteAs
