Consulte une instance.
Description de l'opération
Description : Cette opération consulte les détails d'une instance d'agent spécifiée.
Scénarios : Appelez cette opération pour obtenir les données requises lorsque vous devez surveiller ou analyser les performances d'un agent pendant un appel, ou déboguer la configuration d'un agent.
Testez maintenant
Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.
Test
Autorisation RAM
|
ice:DescribeAIAgentInstance |
none |
*All Resource
|
Aucune | Aucune |
Paramètres de requête
|
Paramètre |
Type |
Requis |
Description |
Exemple |
| InstanceId |
string |
Oui |
L'identifiant de l'instance d'agent.\n\n> InstanceId est l'identifiant unique renvoyé après le démarrage réussi de l'instance d'agent. Pour les opérations de démarrage d'un agent, reportez-vous à StartAIAgentInstance et GenerateAIAgentCall. |
39f8e0bc005e4f309379701645f4**** |
Éléments de réponse
|
Élément |
Type |
Description |
Exemple |
|
object |
Schéma de la réponse. |
||
| Instance |
object |
Les informations de l'instance d'agent. |
|
| CallLogUrl |
string |
L'URL du journal d'appels. |
https://example.com/call_logs/12345 |
| RuntimeConfig | AIAgentRuntimeConfig |
La configuration d'exécution de l'agent. |
{"VoiceChat":{"AgentUserId":"voice_agent_001","ChannelId":"voice_channel_001","AuthToken":"votre_jeton_auth_chat_vocal"}} |
| Status |
string |
L'état de l'instance d'agent, tel que Finished ou Executing. Valeurs valides :
|
Finished |
TemplateConfig
deprecated
|
AIAgentTemplateConfig |
La configuration du modèle de l'agent. |
{"VoiceChat": {"AppId": "votre_id_app_chat_vocal"}} |
| UserData |
string |
Les informations utilisateur personnalisées. |
{"Email":"johndoe@example.com","Preferences":{"Language":"en"}} |
| SessionId |
string |
L'identifiant unique de la conversation. Aucune valeur par défaut. |
955535************** |
| AgentConfig | AIAgentConfig |
La configuration du modèle de l'agent. |
|
| GmtCreate |
string |
L'heure de création (UTC). |
2025-07-18T06:39:08.000+00:00 |
| GmtModified |
string |
L'heure de modification (UTC). |
2025-07-18T06:40:12.000+00:00 |
| CallInfo | AIAgentCallInfo |
Les détails de l'appel PSTN. Ce champ peut être vide si l'appel n'est pas terminé. |
|
| RequestId |
string |
L'identifiant de la requête. |
7B117AF5-2A16-412C-B127-FA6175ED1AD0 |
Exemples
JSON format
{
"Instance": {
"CallLogUrl": "https://example.com/call_logs/12345",
"RuntimeConfig": {
"AvatarChat3D": {
"AgentUserId": "877ae632caae49b1afc81c2e8194ffb4",
"AuthToken": "eyJhcHBpZCI6ICIxMjM0MTIzNxxxxx",
"ChannelId": "70f22d5784194938a7e387052f2b3208"
},
"VisionChat": {
"AgentUserId": "877ae632caae49b1afc81c2e8194ffb4",
"AuthToken": "eyJhcHBpZCI6ICIxMjM0MTIzNxxxxx",
"ChannelId": "70f22d5784194938a7e387052f2b3208"
},
"VoiceChat": {
"AgentUserId": "877ae632caae49b1afc81c2e8194ffb4",
"AuthToken": "eyJhcHBpZCI6ICIxMjM0MTIzNxxxxx",
"ChannelId": "70f22d5784194938a7e387052f2b3208"
},
"AgentUserId": "877ae632caae49b1afc81c2e8194ffb4",
"AuthToken": "eyJhcHBpZCI6ICIxMjM0MTIzNxxxxx",
"ChannelId": "70f22d5784194938a7e387052f2b3208\n"
},
"Status": "Finished",
"TemplateConfig": {
"AvatarChat3D": {
"AsrMaxSilence": 400,
"AvatarId": "1231",
"EnableIntelligentSegment": true,
"EnablePushToTalk": false,
"EnableVoiceInterrupt": true,
"GracefulShutdown": false,
"Greeting": "早上好，我的朋友！",
"UseVoiceprint": false,
"UserOnlineTimeout": 60,
"VoiceId": "zhixiaoxia",
"Volume": 100,
"VoiceprintId": "uniqueId",
"BailianAppParams": "{}",
"UserOfflineTimeout": 5,
"MaxIdleTime": 600,
"WorkflowOverrideParams": "{}",
"WakeUpQuery": "今天天气怎么样？",
"LlmHistory": [
{
"Role": "user",
"Content": "你好"
}
],
"LlmHistoryLimit": 10,
"VoiceIdList": [
"zhixiaoxia"
],
"AsrLanguageId": "zh_mandarin",
"LlmSystemPrompt": "你是一位友好且乐于助人的助手，专注于为用户提供准确的信息和建议。",
"InterruptWords": [
"停止"
],
"VadLevel": 0,
"CharBreak": true,
"AsrHotWords": [
"检查"
]
},
"VisionChat": {
"AsrMaxSilence": 400,
"EnableIntelligentSegment": true,
"EnablePushToTalk": false,
"EnableVoiceInterrupt": true,
"GracefulShutdown": false,
"Greeting": "早上好，我的朋友！\n",
"UseVoiceprint": false,
"UserOnlineTimeout": 60,
"VoiceId": "zhixiaoxia",
"Volume": 100,
"VoiceprintId": "uniqueId",
"BailianAppParams": "{}",
"UserOfflineTimeout": 5,
"MaxIdleTime": 600,
"WorkflowOverrideParams": "{}",
"WakeUpQuery": "今天天气怎么样？",
"LlmHistory": [
{
"Role": "user",
"Content": "你好"
}
],
"LlmHistoryLimit": 10,
"VoiceIdList": [
"zhixiaoxia"
],
"AsrLanguageId": "zh_mandarin",
"LlmSystemPrompt": "你是一位友好且乐于助人的助手，专注于为用户提供准确的信息和建议。\n",
"InterruptWords": [
"停止"
],
"VadLevel": 0,
"CharBreak": true,
"AsrHotWords": [
"检查"
]
},
"VoiceChat": {
"AsrMaxSilence": 400,
"EnableIntelligentSegment": true,
"EnablePushToTalk": false,
"EnableVoiceInterrupt": true,
"GracefulShutdown": false,
"Greeting": "早上好，我的朋友",
"UseVoiceprint": false,
"UserOnlineTimeout": 60,
"VoiceId": "zhixiaoxia",
"Volume": 100,
"VoiceprintId": "uniqueId",
"BailianAppParams": "{}",
"UserOfflineTimeout": 5,
"AvatarUrl": "http://example.com/a.jpg",
"AvatarUrlType": "USER",
"MaxIdleTime": 600,
"WorkflowOverrideParams": "{}",
"WakeUpQuery": "今天天气怎么样？",
"LlmHistory": [
{
"Role": "user",
"Content": "你好"
}
],
"LlmHistoryLimit": 10,
"VoiceIdList": [
"zhixiaoxia"
],
"AsrLanguageId": "zh_mandarin",
"LlmSystemPrompt": "你是一位友好且乐于助人的助手，专注于为用户提供准确的信息和建议。",
"InterruptWords": [
"停止"
],
"VadLevel": 11,
"CharBreak": true,
"AsrHotWords": [
"检查"
]
}
},
"UserData": "{\"Email\":\"johndoe@example.com\",\"Preferences\":{\"Language\":\"en\"}}",
"SessionId": "955535**************",
"AgentConfig": {
"Greeting": "你好",
"WakeUpQuery": "今天天气怎么样？\n",
"MaxIdleTime": 600,
"UserOnlineTimeout": 60,
"UserOfflineTimeout": 5,
"EnablePushToTalk": false,
"GracefulShutdown": true,
"Volume": 100,
"WorkflowOverrideParams": "{}",
"AvatarUrl": "http://example.com/a.jpg\n",
"AvatarUrlType": "USER",
"EnableIntelligentSegment": true,
"AsrConfig": {
"AsrLanguageId": "zh_mandarin",
"AsrMaxSilence": 400,
"AsrHotWords": [
"检查"
],
"VadLevel": 11,
"CustomParams": "mode=fast&sample=16000&format=wav",
"VadDuration": 300
},
"TtsConfig": {
"VoiceId": "longcheng_v2\n\n",
"VoiceIdList": [
"zhixiaoxia"
],
"PronunciationRules": [
{
"Word": "一一零",
"Pronunciation": "幺幺零",
"Type": "replacement"
}
],
"ModelId": "speech-01-turbo",
"LanguageId": "Chinese",
"Emotion": "happy",
"SpeechRate": 1
},
"LlmConfig": {
"LlmHistory": [
{
"Role": "user",
"Content": "你好"
}
],
"LlmHistoryLimit": 10,
"LlmSystemPrompt": "你是一位友好且乐于助人的助手，专注于为用户提供准确的信息和建议。\n",
"BailianAppParams": "\"{\\\"biz_params\\\":{\\\"user_defined_params\\\":{\\\"your_plugin_id\\\":{\\\"article_index\\\":2}}},\\\"memory_id\\\":\\\"your_memory_id\\\",\\\"image_list\\\":[\\\"https://your_image_url\\\"],\\\"rag_options\\\":{\\\"pipeline_ids\\\":[\\\"your_id\\\"],\\\"file_ids\\\":[\\\"文档ID1\\\",\\\"文档ID2\\\"],\\\"metadata_filter\\\":{\\\"name\\\":\\\"张三\\\"},\\\"structured_filter\\\":{\\\"key1\\\":\\\"value1\\\",\\\"key2\\\":\\\"value2\\\"},\\\"tags\\\":[\\\"标签1\\\",\\\"标签2\\\"]}}\"",
"OpenAIExtraQuery": "api-version=2024-02-01&api-key=sk-xxx",
"LlmCompleteReply": true,
"FunctionMap": [
{
"Function": "hangup",
"MatchFunction": "hangup"
}
],
"OutputMinLength": 5,
"OutputMaxDelay": 2000,
"HistorySyncWithTTS": false
},
"AvatarConfig": {
"AvatarId": "5257"
},
"InterruptConfig": {
"EnableVoiceInterrupt": true,
"InterruptWords": [
"打断一下"
],
"NoInterruptMode": "cache",
"KeepInterruptWordsForLLM": true
},
"VoiceprintConfig": {
"UseVoiceprint": false,
"VoiceprintId": "zhixiaoxia",
"RegistrationMode": "Explicit"
},
"TurnDetectionConfig": {
"TurnEndWords": [
"我说完了"
],
"Mode": "Semantic",
"SemanticWaitDuration": -1,
"Eagerness": "High"
},
"ExperimentalConfig": "\"\"",
"VcrConfig": {
"StillFrameMotion": {
"Enabled": false,
"CallbackDelay": 3000
},
"InvalidFrameMotion": {
"Enabled": false,
"CallbackDelay": 3000
},
"PeopleCount": {
"Enabled": false
},
"Equipment": {
"Enabled": false
},
"HeadMotion": {
"Enabled": false
},
"LookAway": {
"Enabled": true
}
},
"AmbientSoundConfig": {
"ResourceId": "f67901c595834************",
"Volume": 50
},
"AutoSpeechConfig": {
"UserIdle": {
"WaitTime": 5000,
"MaxRepeats": 5,
"Messages": [
{
"Text": "您还在吗？",
"Probability": 0.5
}
],
"HangupEndWord": "我挂了，再见"
},
"LlmPending": {
"WaitTime": 3000,
"Mode": "",
"Messages": [
{
"Text": "稍等一下",
"Probability": 0.5
}
]
}
},
"BackChannelingConfigs": [
{
"Enabled": true,
"TriggerStage": "pause_detected",
"Probability": 0.5,
"Words": [
{
"Text": "嗯嗯",
"Probability": 0.3
}
]
}
],
"BackChannelingConfig": [
{
"Enabled": true,
"TriggerStage": "pause_detected",
"Probability": 0.5,
"Words": [
{
"Text": "嗯嗯",
"Probability": 0.3
}
]
}
]
},
"GmtCreate": "2025-07-18T06:39:08.000+00:00",
"GmtModified": "2025-07-18T06:40:12.000+00:00",
"CallInfo": {
"Status": "4",
"CallStartTime": "2026-04-01T16:53:53.184797+00:00",
"CallEndTime": "2026-04-01T16:53:58.875932+00:00",
"CallDuration": 5,
"HangupRole": 0,
"CallerNumber": "183*****333",
"CalleeNumber": "136******794"
}
},
"RequestId": "7B117AF5-2A16-412C-B127-FA6175ED1AD0"
}Codes d'erreur
Consultez Codes d'erreur pour la liste complète.
Notes de version
Consultez Notes de version pour la liste complète.