Skip to main content
Beta: Agents is in beta and isn’t available in every workspace. To try it, contact the Pipedream team. Agent credentials can’t obtain tokens or access apps and tools yet.
Adding an agent doesn’t create or run one in Conduit. It gives an agent you already operate, such as a backend service or hosted assistant, a profile in your workspace, so Conduit knows which application is calling. The agent’s code, model and hosting stay where they are. The profile holds a client ID, credentials and access settings. Workspace admins and owners view and manage agents, including their credentials and access settings; other people can’t. API clients can’t manage agents or add people to groups an agent’s Delegation selects; see who can change agent access.

Add an agent

  1. As a workspace admin, open Agents and select Create agent.
  2. Enter a name and optional description.
  3. Open the agent to add credentials and configure its access.
Agents start disabled, with no tools and nobody they may act on behalf of. Set those in Agent access.

Credentials

An agent holds two credentials at a time, secrets and public keys together, so one stays in use while you deploy its replacement. A secret is shown once; a public key keeps its private key with you. Create a key pair with EC P-256 (recommended) or RSA 2048+, and keep private.pem in your secrets manager:
Paste public.pem or a JWK into Add public key. A pasted private key is rejected; treat it as exposed. The key ID shown under its label is the JWK’s kid or the key’s thumbprint. To rotate, add a replacement, deploy it, then revoke the old credential.

Administration

Agent management is admin-only. People with the Member or Viewer role cannot view agents, create credentials, change access, or enable or disable them. API clients cannot manage agents. Credentials belong to the agent. If an admin leaves or loses their admin role, the credentials stay active until revoked or the agent is deleted. Rotate any credential they should no longer hold.

Disable, delete and audit

Use an agent’s switch to disable it. Deleting an agent removes its credentials. The audit log records every change under Config → Agent.