Skip to main content
Updated Aug 11, 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.
On this page