> ## Documentation Index
> Fetch the complete documentation index at: https://developer.watson-orchestrate.ibm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing agents

## Listing agents

To list all agents, run the following command:

Use the `orchestrate agents list` command to list all agents in your environment. You can also use the `--verbose` (`-v`) flag to get detailed information about each agent in JSON format.

```bash BASH theme={null}
orchestrate agents list -v
```

## Exporting agents

Use the `orchestrate agents export` command to export an agent configuration from your active environment.

You can export the full agent configuration with all its dependencies (default), or only the agent configuration by including the `--agent-only` flag.

```bash BASH theme={null}
orchestrate agents export -n <agent-name> -k <agent-type> -o <output-path>.zip
```

<Expandable title="command flags">
  | Flag              | Type   | Required | Description                                                                                                                                                                                                                                                   |
  | ----------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `--name` (`-n`)   | string | Yes      | The name of the agent you want to export.                                                                                                                                                                                                                     |
  | `--kind` (`-k`)   | string | Yes      | The type of the agent (`native` or `external`).                                                                                                                                                                                                               |
  | `--output` (`-o`) | string | Yes      | The path where the exported agent file will be saved. When using `--agent-only` this will be the yaml spec of the agent. When not using `--agent-only` this will be a zip file containing the agent, its collaborators, its knowledge bases and Python tools. |
  | `--agent-only`    | --     | No       | Exports only the agent configuration without its dependencies.                                                                                                                                                                                                |
</Expandable>

<Note>
  **Note:**
  Agentic workflow tools are only exported when you use a local environment with **watsonx Orchestrate Developer Edition**.
</Note>

## Updating agents

To update an agent, run the import command again using the same agent name as the agent you want to update.

```bash BASH theme={null}
orchestrate agents import -f <path to agent file that you want to update>
```

## Removing agent

To remove an existing agent, run the following command:

```bash BASH theme={null}
orchestrate agents remove --name my-agent --kind native
```