AI 助理
备案控制台
官方文档
输入文档关键字查找
首页音视频通信开发参考API参考API目录智能体智能体模版管理ModifyAppAgentTemplate - 修改智能体模板

ModifyAppAgentTemplate - 修改智能体模板

更新时间：2025-08-04 06:44:20
产品详情
我的收藏

更新应用智能体模版

接口说明

QPS 限制

本接口的单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流，这可能会影响您的业务，请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

  • 操作：是指具体的权限点。
  • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
  • 资源类型：是指操作中支持授权的资源类型。具体说明如下：
    • 对于必选的资源类型，用前面加 * 表示。
    • 对于不支持资源级授权的操作，用全部资源表示。
  • 条件关键字：是指云产品自身定义的条件关键字。
  • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。
操作访问级别资源类型条件关键字关联操作
操作访问级别资源类型条件关键字关联操作
rtc:ModifyAppAgentTemplatenone
*App
acs:rtc::{#accountId}:app/{#AppId}
    无
无

请求参数

名称类型必填描述示例值
名称类型必填描述示例值
AppIdstring是

应用 ID。通过控制台创建和查询，仅支持传单个 ID。

ac7N****
Idstring是

模版 ID。

1231231312312131231
Namestring是

模版名称。

智能体模版
Typeinteger否

智能体类型：

  • 1: 语音通话（默认）
1
ChatModeinteger否

对话模式：

  • 1: 自然对话模式（默认）
  • 2: 对讲机模式
2
InterruptModeinteger否

打断方式：

  • 1: 支持打断（默认）
  • 2: 禁止打断
2
Greetingstring否

问候语，最大长度不超过 500。

早上好，我的朋友
AsrConfigobject否

语音转文字设置。

Namestring是

名称。

STT
VocabularyIdstring否

热词 ID。

0bb1776b1745123332074d1b6b
WordWeightsarray<object>否

每个词表最多包含 500 个热词，每个热词中文长度不超过 10 个字符。 热词必须为 UTF-8 编码，不能包含标点、特殊字符，不符合的情况下，无热词效果。

object是

热词权重。

Wordstring是

热词文本，每个词语最长 10 个汉字或英文单词。

苹果
Langstring否

语言代码。可不写，大模型会自动设别。

  • zh: 中文
  • en: 英文
zh
Weightinteger是

热词权重，取值范围为[1, 5]之间的整数。 常用值：4。 如果效果不明显可以适当增加权重，但是当权重较大时可能会引起负面效果，导致其他词语识别不准确。

4
MaxSentenceSilenceinteger否

语音断句检测阈值，默认 500ms，允许范围[200，6000]。

500
LlmConfigobject否

大模型设置。

Namestring是

名称。

llm
Vendorstring否

提供方，目前支持阿里云-百炼和第三方配置（符合 OpenAI 接口规范）。

thirdparty
Urlstring否

接入第三方大模型时，该字段表示接入的 endpoint。

https://llm.example.aliyuns.com
ApiKeystring是

大模型服务商需要的 apikey。

ak-1213123123132123131
Temperaturefloat否

采样温度，取值范围[0,2)，默认值 0.7。

0.7
TopPfloat否

采样的选择范围(0,1]，默认值 0.8

0.8
MaxTokeninteger否

输出文本的最大限制，默认值 8192。

1024
HistoryDepthinteger否

给大模型提供多少历史对话轮次，最大 100，默认值 3。

8
Promptstring否

大模型提示词，最大长度为 5000。

你好，小叮当
TtsConfigobject否

文字转语音设置。

Namestring是

名称。

Tts
Vendorstring是

提供方，目前支持阿里云-百炼。

aliyun
ApiKeystring是

大模型服务商需要的 apikey。

ak-1213123123132123131
Voicestring否

音色，默认音色是 longxiaoxia。

  • longwan
  • longcheng
  • longhua
  • longxiaochun
  • longxiaoxia
  • longxiaocheng
  • longxiaobai
  • longlaotie
  • longshu
  • longshuo
  • longjing
  • longmiao
  • longyue
  • longyuan
  • longfei
  • longjielidou
  • longtong
  • longxiang
  • loongstella
  • loongbella
longwan
Volumeinteger否

音量，取值范围[0~100]，默认 50。

50
Ratefloat否

语速，取值范围[0.5~2.0]，默认 1.0。

0.8
Pitchfloat否

音调，取值范围[0.5~2.0]，默认 1.0。

0.8
FilterBracketsarray否

过滤设置。

  • 1-中文刮号（）
  • 2-英文刮号()
  • 3-中文方刮号【】
  • 4-英文方刮号[]
  • 5-英文花刮号{}
integer否

具体字段。

1
AgentSilenceConfigobject否

智能体静默配置。

AlertTimeoutinteger否

静默提醒的超时时间（单位：秒）。 可能多次触发，若智能体静默提醒超时后依然静默，则再超时还会继续触发，取值范围：[5, 600]，默认值 0，0 表示不提醒

30
WebhookTriggerTimeoutinteger否

触发智能体静默超时 webhook 的静默超时时间（单位：秒）。可能多次触发，若智能体 webhook 静默超时后依然静默，则再超时还会继续触发，取值范围：[10, 600]，默认值 0，0 表示不触发

30
Strategyinteger否

静默超时处理策略。 1 - 向用户语音播报 content 指定的提示消息 2 - 把 content 指定的提示消息和历史对话发送给 LLM，并播报模型生成的回复 默认值：1

2
Contentstring否

静默提示消息的内容。

返回参数

名称类型描述示例值
名称类型描述示例值
object

Schema of Response

RequestIdstring

Id of the request

231470C1-ACFB-4C9F-844F-4CFE1E3804C5
Idstring

模版 ID。

1223131213231313213

示例

正常返回示例

JSON格式

{
  "RequestId": "231470C1-ACFB-4C9F-844F-4CFE1E3804C5",
  "Id": 1223131213231313200
}

错误码

HTTP status code错误码错误信息描述
HTTP status code错误码错误信息描述
400ParameterError%s.参数错误
404NotFound%s.请求的资源不存在

访问错误中心查看更多错误码。
上一篇：ModifyAppAgentFunctionStatus - 修改智能体功能开关下一篇：DescribeAppAgentTemplates - 查询智能体模版列表
  • 本页导读 （0）
  • 接口说明
  • QPS 限制
  • 调试
  • 授权信息
  • 请求参数
  • 返回参数
  • 示例
  • 错误码