GetDepGroupTreeData-Artificial Intelligence Cloud Call Service(AICCS)-阿里云帮助中心

Queries skill group categories and the skill group list by AICCS instance ID and agent ID.

Operation description

The skill groups returned by this API are grouped by department ID, which can be specified when you create a skill group.
To query detailed skill group information, you can invoke the QuerySkillGroups API.
Before invoking this API, you should confirm the AICCS instance ID and agent ID. For guidance on how to obtain them, see the description of Request Parameters.

Queries per second (QPS) limits

Per-user invocation frequency: 1000 queries per second.
API-wide invocation frequency: 1000 queries per second.

Note

If the total invocations from multiple users exceed the API-wide frequency limit, throttling will be triggered.

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.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	The Artificial Intelligence Cloud Call Service (AICCS) instance ID. You can obtain it from Instance Management in the left-side navigation pane of the Artificial Intelligence Cloud Call Service console.	ccc_xp_pre-cn-***
AgentId	integer	Yes	The agent ID. You can invoke the GetAgent API and view the AgentId parameter in the response to obtain the agent ID.	123456

Response elements

Element	Type	Description	Example
	object	result
RequestId	string	The request ID.	EE338D98-9BD3-4413-B165
Message	string	Description of the status code.	successful
Data	array<object>	Department information.
	array<object>	Department information.
DepGroupId	string	The department ID.	10****
GroupDTOS	array<object>	Skill group data.
	object	Skill group information.
SkillGroupId	integer	The skill group ID.	55****
Name	string	The name of the skill group.	自动化技能组
DepGroupName	string	The department name.	部门A
Code	string	The status code. A value of Success indicates that the request succeeded.	Success
Success	string	Indicates whether the API call succeeded. Valid values: true: Succeeded. false: Failed.	true

Examples

Success response

JSON format

{
  "RequestId": "EE338D98-9BD3-4413-B165",
  "Message": "successful",
  "Data": [
    {
      "DepGroupId": "10****",
      "GroupDTOS": [
        {
          "SkillGroupId": 0,
          "Name": "自动化技能组"
        }
      ],
      "DepGroupName": "部门A"
    }
  ],
  "Code": "Success",
  "Success": "true"
}

Error codes

HTTP status code	Error code	Error message	Description
500	SystemError	A system error occurred. Please contact the administrator.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.