--- schema_version: "1" id: 31f9b79c86918bf0efe1ef8a964ab46b09a0f17a95d6449c682a6fb84c6ce0fc title: agent Commands collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/salesforcedx/sfclireference/guides/agent/cli_reference_agent.md canonical_url: https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent.html source_site: developer.salesforce.com content_type: documentation content_hash: 79f3bcf662feab1165a560f57b11053d2c51209eb0f7ba96d36045ceb4c5759c products: - Salesforce CLI Command Reference - salesforcedx --- # agent Commands Commands to work with agents. - **[agent activate](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_activate.md)**
Activate an agent in an org. - **[agent adl create](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_adl_create.md)**
Create an Agentforce Data Library. - **[agent adl delete](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_adl_delete.md)**
Delete an Agentforce Data Library. - **[agent adl file add](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_adl_file_add.md)**
Add files to an existing Agentforce Data Library. - **[agent adl file delete](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_adl_file_delete.md)**
Delete a file from an Agentforce Data Library. - **[agent adl file list](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_adl_file_list.md)**
List files in an Agentforce Data Library. - **[agent adl get](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_adl_get.md)**
Get details of an Agentforce Data Library. - **[agent adl list](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_adl_list.md)**
List Agentforce Data Libraries in an org. - **[agent adl status](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_adl_status.md)**
Get indexing status of an Agentforce Data Library. - **[agent adl update](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_adl_update.md)**
Update an Agentforce Data Library. - **[agent adl upload](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_adl_upload.md)**
Upload a file to an SFDRIVE Agentforce Data Library. - **[agent create](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_create.md)**
Create an agent in your org using a local agent spec file. - **[agent deactivate](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_deactivate.md)**
Deactivate an agent in an org. - **[agent generate agent-spec](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_generate_agent-spec.md)**
Generate an agent spec, which is a YAML file that captures what an agent can do. - **[agent generate authoring-bundle](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_generate_authoring-bundle.md)**
Generate an authoring bundle from an existing agent spec YAML file. - **[agent generate template](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_generate_template.md)**
Generate an agent template from an existing agent in your DX project so you can then package the template in a second-generation managed package. - **[agent generate test-spec](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_generate_test-spec.md)**
Generate an agent test spec, which is a YAML file that lists the test cases for testing a specific agent. - **[agent mcp asset list (Developer Preview)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_mcp_asset_list.md)**
List the assets (tools, prompts, and resources) for an MCP server in the catalog. - **[agent mcp asset replace (Developer Preview)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_mcp_asset_replace.md)**
Replace the asset set of an MCP server in the API Catalog. - **[agent mcp create (Developer Preview)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_mcp_create.md)**
Create an MCP server in the API Catalog. - **[agent mcp delete (Developer Preview)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_mcp_delete.md)**
Delete an MCP server from the API Catalog. - **[agent mcp fetch (Developer Preview)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_mcp_fetch.md)**
Fetch the live assets (tools, prompts, resources) advertised by an MCP server. - **[agent mcp get (Developer Preview)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_mcp_get.md)**
Get a single MCP server registered in the API Catalog. - **[agent mcp list (Developer Preview)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_mcp_list.md)**
List the MCP servers registered in the API Catalog. - **[agent mcp update (Developer Preview)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_mcp_update.md)**
Update an MCP server registered in the API Catalog. - **[agent preview](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_preview.md)**
Interact with an agent to preview how it responds to your statements, questions, and commands (utterances). - **[agent preview end](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_preview_end.md)**
End an existing programmatic agent preview session and get trace location. - **[agent preview send](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_preview_send.md)**
Send a message to an existing agent preview session. - **[agent preview sessions](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_preview_sessions.md)**
List all known programmatic agent preview sessions. - **[agent preview start](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_preview_start.md)**
Start a programmatic agent preview session. - **[agent publish authoring-bundle](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_publish_authoring-bundle.md)**
Publish an authoring bundle to your org, which results in a new agent or a new version of an existing agent. - **[agent test create](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_test_create.md)**
Create an agent test in your org using a local test spec YAML file. - **[agent test list](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_test_list.md)**
List the available agent tests in your org. - **[agent test results](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_test_results.md)**
Get the results of a completed agent test run. - **[agent test resume](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_test_resume.md)**
Resume an agent test that you previously started in your org so you can view the test results. - **[agent test run](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_test_run.md)**
Start an agent test in your org. - **[agent test run-eval (Beta)](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_test_run-eval.md)**
Run rich evaluation tests against an Agentforce agent. - **[agent trace delete](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_trace_delete.md)**
Delete trace files from an agent preview session. - **[agent trace list](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_trace_list.md)**
List the available trace files that were recorded during all agent preview sessions. - **[agent trace read](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_trace_read.md)**
Read trace files from an agent preview session. - **[agent validate authoring-bundle](https://developer.salesforce.com/docs/platform/salesforce-cli-reference/guide/cli_reference_agent_validate_authoring-bundle.md)**
Validate an authoring bundle to ensure its Agent Script file compiles successfully and can be used to publish an agent.