AI Assistant 2026.1 Help

Add ACP agents

AI Assistant supports the Agent Client Protocol (ACP), allowing you to connect external AI agents. You can install an ACP-compatible agent and use it in the AI Chat without the JetBrains AI service subscription.

  1. Open the AI Chat tool window.

  2. Click Add ACP Agent.

    Add ACP Agent
  3. On the Agents page, select the agent that you want to install and click Install.

    the Agents settings page

    During installation, the IDE automatically:

    • Downloads the required agent files.

    • Downloads and manages a Node.js or Python runtime if required. If a compatible runtime is already available, the IDE reuses it instead.

    • Prepares the agent for use.

  4. Click OK to apply changes.

As a result, the selected agent is installed and becomes available for use in AI Chat.

Alternatively, you can manually add custom ACP-compatible agents:

  1. Open the AI Chat tool window.

  2. Click the button in the upper-right corner of the AI Chat tool window and select Add Custom Agent.

    Add a custom agent
  3. In the acp.json file, provide the agent configuration details.

As a result, the custom agent becomes available in AI Chat.

For more information about configuring ACP-compatible agents, refer to Agent Client Protocol (ACP).

19 March 2026