Note Agent

Updated at:

You can subscribe to offline inference results from the Note Agent through a lightweight message queue (formerly Message Service or MNS).

Return parameters

Parameter

Type

Description

call_id

String

The call ID.

biz_id

String

The business ID for the inference task.

out_id

String

A passthrough field that returns the value of the extended field from the API request.

cell_number

String

The called number.

success

Boolean

Indicates whether the inference was successful.

error_code

String

The inference result code.

success: The inference was successful.

NOTE_AGENT_PROCESS_FAIL: The inference failed.

error_msg

String

The description of the inference result.

content_length

Integer

The length of the inference content.

duration

Integer

The billing duration, in seconds.

start_time

String

The time the inference started.

report_time

String

The time the report was pushed.

type

String

The inference type. Examples: call quality inspection, call summary.

result

String

The Note Agent inference result. For more information, see Inference results for call quality inspection and Inference results for call summary.

task_id

String

The task ID. This parameter is returned only for task-based outbound calls.

task_batch_id

String

The task batch ID. This parameter is returned only for task-based outbound calls.

task_detail_id

String

The task detail ID. This parameter is returned only for task-based outbound calls.

Inference results for call quality inspection

  • Sample result:

    [
      {
        "item": "Dimension 1",
        "full_score": 30,
        "score": 27,
        "problem": "Specific problem description",
        "suggestion": "Specific suggestion for improvement"
      },
      {
        "item": "Dimension 2",
        "full_score": 70,
        "score": 65,
        "problem": "Specific problem description",
        "suggestion": "Specific suggestion for improvement"
      }
    ]
  • Field descriptions:

    Parameter

    Type

    Description

    item

    String

    The quality inspection item or dimension.

    full_score

    Integer

    The full score for the quality inspection item.

    score

    Integer

    The score for the quality inspection item.

    problem

    String

    The problem description.

    suggestion

    String

    The suggested improvement.

Inference results for call summary

  • Sample result:

    {
      "Enumerated Label 1": ["Value 1"],
      "Enumerated Label 2": ["Value 2.1", "Value 2.2"],
      "Text Label 1": "Content 1",
      "Text Label 2": "Content 2"
    }

Recording Summary Callback Message

After the recording summary is processed, the system sends a callback via MNS.

Note

Due to the message size limit of Simple Message Queue (formerly MNS), the callback message body must not exceed 48 KB.

If the transcript text for a call exceeds 45 KB (approximately 8,000 characters, corresponding to a call recording of about 30 minutes), you can still receive the recording summary callback and the summary result for that call, but the transcript_content field in the callback will be discarded.

Callback fields

Field

Type

Description

call_id

String

The unique identifier of the recording summary task.

biz_id

String

The customer's business identifier. If not provided when the task was submitted, the value is the same as call_id.

success

Boolean

Indicates whether the summary processing was successful.

error_code

String

The result code. The value is success if processing succeeds, or a specific error code if it fails.

error_msg

String

The result description. The value is success if processing succeeds, or a specific error message if it fails.

content_length

Integer

The length of the ASR transcript text, excluding punctuation and whitespace. Returns 0 if summary processing fails.

duration

Long

The recording duration, in seconds. Not returned if the duration cannot be obtained.

start_time

String

The time when the task was created. The format is yyyy-MM-dd HH:mm:ss.

report_time

String

The time when the callback was generated. The format is yyyy-MM-dd HH:mm:ss.

type

String

The summary type. Valid values: Call Summary and Call Quality Inspection.

result

String

The summary inference result. Not returned if summary processing fails.

transcript_content

Array

The ASR transcript of the conversation. Not returned if the ASR transcription is unsuccessful, the result is empty, or the content exceeds the callback size limit.

Fields for transcript_content elements

Field

Type

Description

role

String

The conversation role. caller indicates the calling party. callee indicates the called party.

content

String

The transcription text for the conversation segment.

interval

Array<Number>

The time interval of the conversation segment in the recording. The format is [start time, end time], in seconds.

Mock callback

{
  "call_id": "196758003815628800_196758003815628801",
  "biz_id": "customer-audio-note-202607270001",
  "success": true,
  "error_code": "success",
  "error_msg": "success",
  "content_length": 30,
  "duration": 18,
  "start_time": "2026-07-27 10:30:00",
  "report_time": "2026-07-27 10:30:26",
  "type": "Call Summary",
  "result": "The customer agreed to learn more about the service. The call proceeded normally.",
  "transcript_content": [
    {
      "role": "caller",
      "content": "Hello, is now a good time to talk?",
      "interval": [0.35, 3.42]
    },
    {
      "role": "callee",
      "content": "Yes, please go ahead.",
      "interval": [4.08, 5.36]
    },
    {
      "role": "caller",
      "content": "Great. Let me briefly introduce our service.",
      "interval": [5.82, 10.76]
    }
  ]
}

Optional fields that do not meet return conditions are omitted directly. null is not returned as a placeholder.