All Products
Search

This Product

    Cloud Phone:CreateAgentSkill

    Document Center

    Cloud Phone:CreateAgentSkill

    Last Updated:Sep 04, 2026

    Creates a custom skill.

    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 syntax

    GET  HTTP/1.1

    Request parameters

    Parameter

    Type

    Required

    Description

    Example
    IconKey

    string

    No

    The icon of the custom skill.

    Valid values:

    • icon07 :

      optimization and enhancement.

    • icon08 :

      development and technology.

    • icon09 :

      security and protection.

    • icon03 :

      office documents.

    • icon04 :

      localization-friendly.

    • icon05 :

      research and exploration.

    • icon06 :

      data and finance.

    • icon01 :

      default icon.

    • icon02 :

      growth.

    icon01
    SkillName

    string

    No

    The skill name.

    weather-enhanced
    SkillDescription

    string

    No

    The skill description.

    Current weather and forecasts with wttr.in via curl for locations, rain, temperature, travel planning.
    PackageOssKey

    string

    No

    The OSS path of the skill package. This parameter is reserved by the system and does not need to be specified.

    test/sk-test/current/skill.zip
    SkillPackageUrl

    string

    No

    The OSS download URL of the skill package. This parameter is required for API calls.

    https://test.oss-cn-hangzhou.aliyuncs.com/weather_skill.zip?Expires=1788168088&OSSAccessKeyId=****
    FileList

    array

    No

    The list of files in the skill package.

    string

    No

    The file in the skill package.

    SKILL.md

    Response elements

    Element

    Type

    Description

    Example

    object

    PlainResult

    RequestId

    string

    The request ID.

    425F351C-3F8E-5218-A520-B6311D0D****
    Code

    string

    The status code. A value of 200 indicates success.

    200
    Message

    string

    The response message.

    Success.
    SkillInfo

    array<object>

    The skill information.

    object

    The skill information.

    SkillId

    string

    The unique ID of the skill.

    sk-051j4pbwxzgol****
    SkillName

    string

    The skill name.

    dev-spec
    Type

    string

    The skill type.

    CUSTOM
    Status

    string

    The skill status.

    ACTIVE
    Description

    string

    The skill description.

    Current weather and forecasts with wttr.in via curl for locations, rain, temperature, travel planning.
    Instruction

    string

    The skill summary.

    Current weather and forecasts.

    Examples

    Success response

    JSON format

    {
  "RequestId": "425F351C-3F8E-5218-A520-B6311D0D****",
  "Code": "200",
  "Message": "Success.",
  "SkillInfo": [
    {
      "SkillId": "sk-051j4pbwxzgol****",
      "SkillName": "dev-spec",
      "Type": "CUSTOM",
      "Status": "ACTIVE",
      "Description": "Current weather and forecasts with wttr.in via curl for locations, rain, temperature, travel planning.",
      "Instruction": "Current weather and forecasts."
    }
  ]
}

    Error codes

    See Error Codes for a complete list.

    Release notes

    See Release Notes for a complete list.