GetCustomTopicSelectionPerspectiveAnalysisTask

Updated at:

Retrieve the result of a custom topic selection perspective analysis task.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

aimiaobi:GetCustomTopicSelectionPerspectiveAnalysisTask

get

*All Resource

*

NoneNone

Request syntax

POST  HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

AgentKey

string

Yes

Unique identifier of the workspace: AgentKey

xxxxx_p_efm

TaskId

string

Yes

Unique ID of the task.

The system generates a TaskId by default. If you specify the same TaskId for multiple tasks, those tasks belong to the same conversation group.

0dbf1055f8a2475d99904c3b76a0ffba

Response elements

Element

Type

Description

Example

object

PlainResult

Code

string

Status code

NoData

Data

object

Business data

CustomViewPointsResult

object

Result of the custom topic selection analysis task

Attitudes

array<object>

List of custom viewpoints. By default, the system generates one viewpoint based on the prompt input.

array<object>

Attitude

string

Current viewpoint

当前观点

AttitudeType

string

Viewpoint type

观点类型

Ratio

string

Proportion of the current viewpoint

当前观点占比

ViewPoints

array<object>

List of topic selection perspectives

array<object>

Outlines

array<object>

Outline

object

Outline

string

Outline

大纲

Summary

string

Outline summary

大纲摘要

Point

string

Generated perspective

视角

Summary

string

Summary

摘要

Topic

string

Hot topic event

热点主题事件

ErrorMessage

string

Error message

错误信息

Status

string

Task status (PENDING: pending, RUNNING: running, SUCCESSED: succeeded, SUSPENDED: suspended, FAILED: failed, CANCELED: canceled)

FAILED

HttpStatusCode

integer

HTTP status code

200

Message

string

Error description

success

RequestId

string

Unique request identifier

1813ceee-7fe5-41b4-87e5-982a4d18cca5

Success

boolean

Indicates success: true for success, false for failure

true

Examples

Success response

JSON format

{
  "Code": "NoData",
  "Data": {
    "CustomViewPointsResult": {
      "Attitudes": [
        {
          "Attitude": "当前观点",
          "AttitudeType": "观点类型",
          "Ratio": "当前观点占比",
          "ViewPoints": [
            {
              "Outlines": [
                {
                  "Outline": "大纲",
                  "Summary": "大纲摘要"
                }
              ],
              "Point": "视角",
              "Summary": "摘要"
            }
          ]
        }
      ],
      "Topic": "热点主题事件"
    },
    "ErrorMessage": "错误信息",
    "Status": "FAILED"
  },
  "HttpStatusCode": 200,
  "Message": "success",
  "RequestId": "1813ceee-7fe5-41b4-87e5-982a4d18cca5",
  "Success": true
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.