Skip to main content
Use Agents to create project-specific agents with their own instructions and capabilities.

Steps

  1. Open Agents.
  2. Create a new agent.
  3. Name the agent.
  4. Add instructions that describe the agent’s role and boundaries.
  5. Connect the tools, skills, prompts, or knowledge available to the agent.
  6. Turn on Require approval if the agent should ask before using tools. This is separate from security_enabled.
  7. Save the agent.

Verify

  1. Confirm the agent appears in Agents.
  2. Open Chat.
  3. Select the agent.
  4. Send a short test message.

Add approval for tool use

Use Human approval for agent tools when an agent can change code, call integrations, deploy, or take other actions that should be reviewed first. Do not use security_enabled for tool approval. security_enabled controls default security guardrails for the agent document; it is not runtime HITL approval and does not pause tool calls.