帮你快速理解、总结文档立即下载
文档中心>物联网开发平台>服务端 API>TWeTalk相关接口>查询TWeTalk智能体详情

查询TWeTalk智能体详情

最近更新时间：2026-07-16 02:21:15

我的收藏

本页目录：

1. 接口描述

接口请求域名： iotexplorer.tencentcloudapi.com 。

用户查询TWeTalk智能体详情

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

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

2. 输入参数

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

参数名称 必选 类型 描述
Action 是 String 公共参数，本接口取值：DescribeTWeTalkAgent。
Version 是 String 公共参数，本接口取值：2019-04-23。
Region 是 String 公共参数，详见产品支持的 地域列表，本接口仅支持其中的: ap-guangzhou 。
AgentId 是 String

智能体ID


示例值：agent-SValZ1****

3. 输出参数

参数名称 类型 描述
Data TalkAgentInfo

智能体详情
RequestId String 唯一请求 ID，由服务端生成，每次请求都会返回（若请求因其他原因未能抵达服务端，则该次请求不会获得 RequestId）。定位问题时需要提供该次请求的 RequestId。

4. 示例

示例1 查询智能体详情

输入示例

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

{
    "AgentId": "agent-SValZ1****"
}

输出示例

{
    "Response": {
        "Data": {
            "AgentId": "agent-SValZ1****",
            "AppId": 251440000,
            "Bindings": [
                {
                    "AgentId": "agent-SValZ1****",
                    "BindingScope": "device",
                    "CreateTime": 1781148290,
                    "DeviceName": "test_02",
                    "ProductId": "MD2JRU****",
                    "UpdateTime": 1781148290
                }
            ],
            "ConversationConfig": {
                "InterruptMode": 0,
                "WelcomeMessage": "今天过得怎么样？我可以陪你聊天。",
                "WelcomeMessagePriority": 1
            },
            "CreateTime": 1781058518,
            "Description": "暖男",
            "InstanceId": "ins-31ooyYQ****",
            "LLMConfig": {
                "ApiKey": "sk-26515f17a9e24f******************",
                "BaseUrl": "https://api.deepseek.com/v1/chat/completions",
                "ExtraBody": "{\"thinking\":{\"type\":\"disabled\"}}",
                "History": 20,
                "Model": "deepseek-v4-flash",
                "SystemPrompt": "你是一个暖男，照顾用户情绪",
                "Temperature": 1,
                "Type": "openai"
            },
            "MemoryConfig": {
                "Enabled": true
            },
            "Name": "学弟",
            "STTConfig": {
                "TRTC": {
                    "Language": "zh",
                    "VADLevel": 3,
                    "VADSilenceTime": 300
                },
                "Type": "trtc"
            },
            "TTSConfig": {
                "Flow": {
                    "Speed": 0.5,
                    "VoiceId": "v-male-W1tH9jVc"
                },
                "Type": "flow"
            },
            "Uin": 700002289689,
            "UpdateTime": 1781517985,
            "WebhookTools": [
                {
                    "Description": "点咖啡，拿铁，美式",
                    "Endpoint": {
                        "Url": "http://*****************/coffee/order"
                    },
                    "Name": "order_coffee",
                    "Parameters": "{\"type\":\"object\",\"properties\":{\"coffee_type\":{\"type\":\"string\",\"description\":\"咖啡类型\",\"enum\":[\"拿铁\",\"美式\",\"卡布奇诺\"]},\"size\":{\"type\":\"string\",\"description\":\"咖啡杯型\",\"enum\":[\"小杯\",\"中杯\",\"大杯\"]},\"sugar\":{\"type\":\"string\",\"description\":\"咖啡糖度\",\"enum\":[\"标准\",\"半糖\",\"无糖\"]}},\"required\":[\"coffee_type\",\"size\",\"sugar\"],\"additionalProperties\":false}",
                    "Required": [
                        "coffee_type"
                    ]
                }
            ]
        },
        "RequestId": "de5ababb-a7e7-4278-b6b5-9a6fe1b6d0a5"
    }
}

5. 开发者资源

腾讯云 API 平台

腾讯云 API 平台 是综合 API 文档、错误码、API Explorer 及 SDK 等资源的统一查询平台，方便您从同一入口查询及使用腾讯云提供的所有 API 服务。

API Inspector

用户可通过 API Inspector 查看控制台每一步操作关联的 API 调用情况，并自动生成各语言版本的 API 代码，也可前往 API Explorer 进行在线调试。

SDK

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

命令行工具

6. 错误码

该接口暂无业务逻辑相关的错误码，其他错误码详见 公共错误码。

中国站