Feedback

修改AI对话任务

1. 接口描述

接口请求域名: trtc.intl.tencentcloudapi.com 。

成功开启对话后,可以使用此接口来修改对话任务配置。

默认接口请求频率限制:20次/秒。

推荐使用 API Explorer
点击调试
API Explorer 提供了在线调用、签名验证、SDK 代码生成和快速检索接口等能力。您可查看每次调用的请求内容和返回结果以及自动生成 SDK 调用示例。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数,完整公共参数列表见 公共请求参数。

参数名称必选类型描述
Action是String公共参数,本接口取值:ModifyVoiceConversation。
Version是String公共参数,本接口取值:2019-07-22。
Region是String公共参数,详见产品支持的 地域列表,本接口仅支持其中的: ap-guangzhou, ap-hongkong, ap-singapore 。
SdkAppId是Integer

TRTC的SdkAppId,和对话的房间所对应的SdkAppId相同。

TaskId是String

对话任务的唯一Id,在启动对话成功后会返回。

SequenceNumber是Integer

需要保证同一个任务,每次更新请求中的SequenceNumber递增,防止请求乱序。

LLMConfig否VoiceConversationLLMConfig

大模型配置。仅 Cascade 模式生效;S2S 模式报错。

S2SConfig否VoiceConversationS2SConfig

端到端语音大模型配置。仅 S2S 模式生效;Cascade 报错。

DialogConfig否VoiceConversationDialogConfig

对话控制配置。仅 Cascade 模式生效。

3. 输出参数

参数名称类型描述
TaskIdString

任务ID

RequestIdString唯一请求 ID,由服务端生成,每次请求都会返回(若请求因其他原因未能抵达服务端,则该次请求不会获得 RequestId)。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 修改ai对话

输入示例

POST / HTTP/1.1
Host: trtc.intl.tencentcloudapi.com
Content-Type: application/json
X-TC-Action: ModifyVoiceConversation
<公共请求参数>

{
    "SdkAppId": 1400704311,
    "TaskId": "-nG0jIFU7llEfJ3MR8El60TD18*************************bOp75dg0i7c+NqbBQ2tAxOAE.",
    "SequenceNumber": 0,
    "LLMConfig": {
        "LLMType": "openai",
        "Model": "gpt-4o-mini",
        "APIUrl": "https://translationsllm.openai.azure.com****************************************pletions?api-version=2025-01-01-preview",
        "APIKey": "CKLhA70tjVXN8Tp0ADnCiv5YSqFe****************************99BJAC4f1cMXJ3w3AAABACOG9t8q",
        "SystemPrompt": "你是一个简洁的对话助手。",
        "MaxTokens": 2048,
        "MaxHistory": 50,
        "MaxToolRound": 20,
        "Timeout": 20000,
        "Temperature": 0.5,
        "TopP": 0.9,
        "McpServer": {
            "Name": "weather-mcp",
            "Url": "https://m*********e.com/v1",
            "Timeout": 5000,
            "ToolList": [
                "get_weather"
            ]
        }
    },
    "DialogConfig": {
        "InterruptMode": 2,
        "InterruptKeywords": [
            "停止"
        ]
    }
}

输出示例

{
    "Response": {
        "TaskId": "-nG0jIFU7llEfJ3MR8El60TD18*************************bOp75dg0i7c+NqbBQ2tAxOAE.",
        "RequestId": "0842be45-1e51-401a-8372-f57f6c86edb9"
    }
}

5. 开发者资源

SDK

云 API 3.0 提供了配套的开发工具集(SDK),支持多种编程语言,能更方便的调用 API。

命令行工具

6. 错误码

以下仅列出了接口业务逻辑相关的错误码,其他错误码详见 公共错误码。

错误码描述
AuthFailureCAM签名/鉴权错误。
AuthFailure.UnauthorizedOperationCAM鉴权失败。
AuthFailure.UnsupportedOperation不支持该操作。
FailedOperation操作失败。
InternalError内部错误。
InvalidParameter参数错误。
InvalidParameter.OutOfRange参数超出范围。
InvalidParameter.SdkAppIdSdkAppId参数错误。
MissingParameter缺少参数错误。
MissingParameter.Region缺少Region参数。
MissingParameter.SdkAppId缺少SdkAppId参数。
MissingParameter.UserId缺少UserId参数。
ResourceNotFound资源不存在。
UnsupportedOperation操作不支持。