Skip to main content
Updated Sep 25, 2026

Send Message to Agent

Use this action when you want one workflow or agent action to hand work to another agent and reuse that agent's reply.

Best for​

  • Reusing a specialist agent from multiple workflows
  • Building agent-to-agent handoffs
  • Running a second agent against a prepared piece of text

Main fields​

FieldWhat it does
AgentSelects the agent that should receive the message
TextThe message to send to that agent
PurposeOptional label for what this step is for, shown in logs

What later steps can use​

The target agent's reply messages are available at:

  • step(N).messages

Tips​

  • Use this when you want another agent's full behavior, not just raw LLM output.
  • Keep the text clear and self-contained so the second agent has the right context.
  • Avoid circular designs where agents keep sending work back to each other.