All Products
Search

This Product

    Intelligent Media Services:Create and manage AI agents

    Document Center

    Intelligent Media Services:Create and manage AI agents

    Last Updated:Apr 15, 2025

    In AI real-time interaction, AI agents are human-like virtual users that interact with end users. You can create an AI agent and integrate it into your application. The agent performs tasks based on the defined workflow. This topic describes how to create and manage AI agents. 

    Create an AI agent in the console

    1. Log on to the Intelligent Media Services (IMS) console. In the left-side navigation pane, choose Intelligent Production > AI Real-time Interaction > AI Agents. Click Create AI Agent.

      image

      Note

      The region where the agent is created is displayed in the upper right corner. You must call the service in the same region.

    2. Configure the basic Information. 

      image

    3. Configure the workflow.

      1. Associate the agent with a real-time workflow. The agent will run according to the workflow.

        image

      2. Select an ApsaraVideo Real-time Communication (ARTC) application within your account. If no ARTC applications are available, create one.

        image

        Note

        The ARTC application acts as a communication bridge, ensuring the proper functioning of the conversation features.

      3. If the workflow you selected is audio call, you can upload an avatar for the agent.

        image

    4. Click Submit.

    Configure callbacks

    1. After the agent is created, go to its details page. On the Callback Configurations tab, click Enable.image

    2. On the right-side panel, set up the Callback URL, Authentication Token, and User Sentence Callback. 

      • Callback URL: The callback message will be sent to the specified address to inform you of the latest status of the agent. For details, see Parameters in callback message body.

      • Authentication Token: The token for identity verification and authorized access. You can obtain the token from the Authorization field in the header.

      • User Sentence Callback: When enabled, the callback is triggered each time the user completes a sentence. The user-generated audio files will be stored in WAV format in Object Storage Service (OSS)image

    3. Click OK.

    Try an AI agent

    1. On the AI Agents page, find the one you want to try and click QR Code for Demo in the Actions column.

    2. Set up the validity period and click Generate.

    3. There are three ways to test the agent:

      • Use the demo mobile application to scan the QR code on the left.

      • Use DingTalk, WeChat, or a browser application to scan the QR code on the right.

      • Copy the URL for trial on HTML5 page and paste it in a browser.

    image

    Modify or delete an AI agent

    View all agents on the AI Agents page.

    image

    • Modify: Click Manage in the Actions column. Modify the agent information and callback configurations as needed.

    • Delete: Click Delete in the Actions column. Agents cannot be deleted while they are in use. 

    Integrate an AI agent

    To integrate an AI agent, see Developer guide. 

    View usage statistics

    Go to the Usage Statistics page to view the usage time of AI real-time interaction.