根据智能体（Agent）ID 获取 Agent 信息。

请求信息

请求 URI

GET https://rtc-agent.yunxinapi.com/v1/agent/{agentId}

请求头参数

请求 Header 的参数说明请参考 请求结构。

请求路径参数

参数名称	类型	是否必选	示例	说明
agentId	String	是	"agent123"	Agent ID

响应信息

响应参数

参数名称	类型	说明	是否必返回
code	Integer	状态码	是
message	String	状态描述	是
requestId	String	请求标识符	是
- data	Object	响应数据	是
agentId	String	Agent 标识符	是
agentName	String	Agent 名称	是
llmPromptContent	String	LLM 提示词	是
llmConfig	Object	LLM 配置，具体请参考创建智能体的说明	是
ttsConfig	Object	TTS 音色相关配置，具体请参考创建智能体的说明	是
asrConfig	Object	ASR 相关配置，具体请参考创建智能体的说明	是
agentConfigProperties	Object	AI Pipeline 设置等，具体请参考创建智能体的说明	是
status	Long	0 表示启用，1 表示禁用	是
createdAt	Long	创建时间，单位为毫秒的时间戳	是
updatedAt	Long	修改时间，单位为毫秒的时间戳	是
success	Boolean	操作是否成功	是

响应体示例

JSON{
    "code": 200,
    "message": "操作成功",
    "requestId": "ai5b799034b90f4bd4ae165085e67ce112",
    "data": {
        "agentId": "yunxin-Xiaoyi",
        "agentName": "助手小易",
        "llmPromptContent": "作为网易云信的智能语音助手，我遵循以下原则：我的名字叫小易，我的回答语气可爱乖巧，和真正的人类对话一样，内容清晰全面，但不超过 50 个词, 不回复表情和表情符号。",
        "ttsConfig": {
            "ttsVendor": 3,
            "voice": "aiya",
            "gender": "Female",
            "language": "Chinese",
            "ignoreBracketTextSet": [
                1,
                2
            ],
            "speed": 1,
            "volume": 1,
            "enableLatex": false
        },
        "asrConfig": {
            "asrVendor": 9,
            "srcLan": "AUTO",
            "maxSentenceSilence": 600,
            "enableSaveAudio": true,
            "enableSemanticVad": false
        },
        "llmConfig": {
            "llmVendor": 5,
            "llmModel": "doubao-pro-32k-functioncall-241028",
            "temperature": 1,
            "topP": 0.9,
            "maxTokens": 4000,
            "enableWebSearch": false,
            "contextSize": 3,
            "enableVision": false
        },
        "agentConfigProperties": {
            "useMemory": true,
            "enableMemoryByVoicePrint": true,
            "reference": true,
            "pipeline": {
                "interruptMode": 2,
                "interruptWords": [

                ],
                "enableWelcomeMessage": true,
                "welcomeMessage": "",
                "enablePause": false,
                "serverAudioProcess": {
                    "enableServerAec": false,
                    "serverAnsMode": 0,
                    "enableSpeakerVerify": true,
                    "speakerVerifyLevel": 1,
                    "enableSpeakerLock": false,
                    "enableShowSpeakerInAsrResult": true
                }
            }
        },
        "createdAt": 1750389520000,
        "updatedAt": 1756717028000,
        "status": 0
    },
    "success": true
}

错误码

本文仅列举部分业务接口错误码，完整列表请参考 错误码。

错误码	说明	处理建议
407	Agent 不存在	请检查 Agent ID 是否正确