Skip to main content

Manage an agent Limited availability

Update an existing agent, including its system instructions, AI model, and tools. You can also delete an agent or remove Managed Agents from a project.

To send a task or question, see Chat with an agent. To run a task on a schedule, see Schedule an agent.

Prerequisites​

An existing agent. To create one, see Create an agent.

Open an agent​

  1. In the Aiven Console, open your project.
  2. Click Agents.
  3. Click the agent.

The agent opens in a new chat. To chat or open a previous conversation, see Chat with an agent.

View agent details​

Click Overview.

Overview shows Agent details and System instructions. Agent details includes the agent name and AI model.

Edit the agent name or model​

  1. In Agent details, click Edit.
  2. Change the agent name or the AI model.
  3. Click Save.

Edit system instructions​

  1. In System instructions, click Edit.
  2. Update the instructions.
  3. Click Save.

Change tools and integrations​

Click Integrations to change the tools the agent can use, including built-in tools and Aiven MCP.

For more information, see Manage integrations.

Manage schedules​

Click Agent schedules to view or create scheduled tasks for the agent.

For more information, see Schedule an agent.

Delete an agent​

Deleting an agent permanently removes the agent and its chat sessions. You can't undo this action. Aiven also revokes the agent's Aiven MCP token and removes its Aiven identity.

Other agents in the project aren't affected.

  1. In the Aiven Console, open your project.

  2. Click Agents.

  3. Find the agent and click Actions > Delete agent.

    You can also open the agent and click Delete agent in the page header menu.

  4. In the Delete agent? dialog, click Delete.

Remove Managed Agents​

Removing Managed Agents deletes all agents in the project and the infrastructure that runs them. Use this to stop using Managed Agents in a project.

warning

This action is permanent. The following are deleted:

  • All agents and their chat history
  • Agent schedules
  • Connected integrations
  • The infrastructure required to run your agents

To use agents in the project again, enable Managed Agents and create the agents again.

You need the Operator or Administrator project role. For more information, see Agent permissions.

  1. In the Aiven Console, open your project.
  2. Click Agents.
  3. In the page header, open the context menu and click Remove Managed Agents.
  4. In the Remove Managed Agents dialog, enter the project name to confirm.
  5. Click Remove Managed Agents.

A Managed Agents removed message appears when removal is complete. If removal fails, click Try again. If the error mentions termination protection, turn off termination protection for the service it names and try again. If the problem continues, contact support.

Related pages