Agent Management Center

Cloud Agent Types

Constraints

Only the basic and professional packages support the creation of cloud agents.

Creating a Cloud Custom Agent

1. Log in to the CodeArts Agent console as an enterprise member or administrator.
2. Choose Agent Settings > Agent Center and click Create Agent.
3. Set custom agent parameters by referring to Table 2.

   Table 2 Parameters for creating an agent

   Parameter	Description
   Agent icon	The system provides various preset icons for agents. Click on the icon to select a preferred style.
   Agent name	Name of the custom agent to be created. Naming convention: 2 to 20 characters, consisting of letters, digits, underscores, and hyphens (-), and must start with a letter.
   Agent Type	Working mode of the agent, which affects its behavior logic and capability boundary. Primary/Sub-agent: It can be used as a sub-agent to be called by a primary agent or as a primary agent to call a sub-agent. Primary agent: It runs independently to process user requests and cannot be called by other agents. Sub-agent: It can be called by primary agents to perform specific tasks.
   Base Model	This parameter is displayed only when Agent Type is set to Primary/Sub-agent or Primary agent. Only large language models in the enabled state are displayed. Select a large language model from the drop-down list.
   Description	A brief explanation of what the agent does to help users understand its functionality, with a maximum of 5,000 characters.
   Applied To	Application scope of the custom agent, which cannot be modified after creation. Individual: Only the creator can use it. Team: It is available only to specified teams and can be created by enterprise administrators or team administrators. Enterprise: It is available to all enterprise members and can be created only by enterprise administrators.
   Available team space	This parameter is displayed only when Applied To is set to Team. It specifies the teams that can use the agent. Enterprise administrators can view all teams but can select only one, while team administrators can only view and select the team they belong to.
   Prompt	System instructions that define the role, tone, workflow, and rules/specifications of the agent.
   Built-in tools	Built-in, out-of-the-box tools provided by the agent. Read: used to retrieve and view files. Edit: used to add, modify, or delete files. Terminal: used to run system commands in the command line environment. Preview: used to preview the generated frontend page in real time. Webfetch: used to capture and read web page content.
   Skills	Skills that are associated with the agent to enable it to perform certain specialized tasks. NOTE: CodeArts Agent has no hard limit on the number of associated skills, but it is recommended that the number not exceed 20 to ensure optimal user experience.

4. Click Create and Enable.

   Check the created agent on the Agents page.

   To check the cloud agent created on the local client immediately, choose Settings > Agents and click the refresh icon to synchronize the cloud agent to the client.

   

   • The client automatically synchronizes cloud agents every 24 hours.
   • The client synchronizes only enabled agents.

Managing Cloud Custom Agents

Table 3 shows the operation permissions of different roles on managing cloud custom agents.

System built-in agents cannot be enabled, disabled, copied, or deleted. Only enterprise administrators can edit them.