Manually adding your agents

You can manually add your agents to either existing custom accounts or to a new custom account.

Benefits of manually adding your agents

The benefits of manually adding your agents include:

• Full lifecycle management: You can create, update, and delete custom providers, agents, and their associations directly from the UI.
• Simplified UI: Redesigned, intuitive screens make data entry and relationships easy to configure.
• Flexible editing: Users can modify or enrich data added through other sources (e.g., APIs or AI-Catalog uploads).
• Broader customization: Empowers customers to integrate and manage non-native AI providers seamlessly within ACT.
• No technical dependency: All setup and maintenance can be done through guided UI forms.
• Consistent and structured Data: Enforces standardized fields and relationships across all providers and agents.

1. Navigate to Agentstudio >Agent Control Tower>Manage Providers > Custom Accounts.
2. You can either create a new account and add agents to that account or you can add agents to an existing account.
3. Click +Add Agent.
4. In the Add Agent window that pops up, select Add Manually.
5. Enter the Agent Name (required) and an optional External ID.
   note

   If you choose to leave the External ID blank, an external ID is auto-generated for you. This ID is not editable.

6. In the newly created Agent window, under the Overview tab, enter the following:
   • Agent Name: Name of the agent, prepopulated from step 5, and you can modify it if needed.
   • Description: Description of the agent.
   • Status: Status of the agent. By default the status will be set to DRAFT and you cannot edit it.
   • Version: Version of the agent. The version field is alphanumeric, this value is managed by the platform and you cannot edit it.
   • Trust Level: Choose your trust level between Endorsed and Unendorsed.
   • Tags: Add identifiable tags that will help identify the agent.
   • Json Viewer: Add in agent details if present in json format. You can switch between a code and object view."
7. In the Tasks tab:
   1. Click + Add New Task.
   2. Add a Name to the task.
   3. In the Description tab, enter the Task Name and Description.
   4. In the Instructions tab, you can add the instructions for your task. After adding your instructions, click Next.
   5. In the Tools tab, click + Add New Tool to add a tool to your task. In the Add New Tool window, enter the Tool Name, Description, Tool Type, Status, and fill in the JSON Viewer. Click Add Tool when done.
   6. Once done click Add Task.
8. In the Guardrails tab, you can add your Guardrails by clicking + Add Guardrails and filling in the Guardrail Name, Description, and additional information in the JSON viewer. Click Add.
9. In the Large Language Model tab, you can add multiple large language models by clicking +Add Large Language Model, filling in the Large Language Model Name and Description, and clicking Add.
10. Return to the Overview tab, click Save or Create Alias. You only need to click Save if you make any changes in the Overview tab.

The created agent remains in the DRAFT state as a TEST ALIAS. If you want to publish your agent you need to create an agent alias.

Creating an Agent Alias

An agent alias is a public reference related to a specific version of the agent. A Test Alias is a system-managed agent alias tied to the Draft Version of the agent. Active agent aliases are the published versions of the agent. Each agent alias receives a unique externalId (extAccountAliasId) used for metric submission and monitoring.

1. Click Create Alias.
2. Enter the following details:
   1. Alias Name: Name of the agent alias. Since DRAFT agents are saved as TEST ALIAS you cannot name your agent alias as the same.
   2. External ID: ID for the agent alias. If not entered by you, the ID is autogenerated.
   3. Description: Description of agent alias.
   4. Trust Levels: Endorsed or Unendorsed.
   5. Tags: Add identifiable tags that will help identify the agent alias.
3. Click Save.

Creating an agent alias results in one published version. A new published version is created with an auto-incremented version number for example, v1, v2, etc. This version is non-editable.

You can only edit an agent from its DRAFT version and re-publish it by creating an agent alias. The Draft version will have the latest version of your agent. Publishing a second agent alias does not affect the previous agent alias.

You can also choose to clone your agent alias. Cloning creates a new agent alias from an existing version. You can assign it a new Alias name, External ID, and Description, but you cannot modify its associated entities or relationships (such as Tasks, Tools, etc.). It will remain an exact replica of the original agent alias.

To enable agent monitoring, you need to complete the setup described in Enabling metrics of Custom accounts, so you can start sending metrics to Agent Control Tower and monitor your agents metrics effectively.

Deleting an agent

Deleting a draft agent results in the deletion of:

• All published versions.
• All active agent aliases.
• The draft version and draft agent alias.
• The agent record is removed.

To delete an agent, follow these steps:

1. Navigate to the Agent Listing page.
2. Locate the agent you want to delete.
3. Go to the Actions menu for that agent.
4. Select the Delete option from the menu.
5. You can also delete an agent from the agent's overview page

Deleting an agent alias

Deleting an individual agent alias removes only that specific agent alias. An associated version and other agent aliases remain unaffected.