Blocks

Agent Message

Send messages between agents

Enables direct communication between agents in a workflow. Supports request-response patterns, broadcasts, and async messaging.

Back to Catalog
Agentsagent_message

Block Preview

Agent Message

Send messages between agents

Usage

  1. Add the block to your workflow and connect it to the upstream step.
  2. Configure any required credentials or tokens in the inputs.
  3. Fill in required inputs and optional parameters for the run.
  4. Run a test execution, inspect outputs, and iterate before deploying.
  5. Deploy the agent_message block with monitoring enabled in production.

Inputs (UI)

Message Type

dropdown

Layout: half

Options: Request, Response, Broadcast, Event

Target Agent

short-input

Placeholder: Agent name or ID

Layout: half

Condition: messageType = ["request","response"]

Channel

short-input

Placeholder: Broadcast channel name

Layout: half

Condition: messageType = ["broadcast","event"]

Message Content

long-input

Placeholder: Message content or JSON data...

Layout: full

Content Type

dropdown

Layout: half

Options: Text, JSON, Task, Result

Priority

dropdown

Layout: half

Options: Low, Normal, High, Urgent

Wait for Response

switch

Block execution until response received

Layout: half

Condition: messageType = "request"

Timeout (seconds)

short-input

Placeholder: 30

Layout: half

Condition: waitForResponse = true

Metadata

code

Additional metadata to include with the message

Placeholder: { "correlationId": "...", "tags": [] }

Layout: full

Inputs (API)

messageType

string

Required

targetAgent

string

Optional

channel

string

Optional

content

string

Required

contentType

string

Optional

priority

string

Optional

waitForResponse

boolean

Optional

timeout

number

Optional

metadata

json

Optional

Outputs

Primary response type:

{
  "messageId": "string",
  "status": "string",
  "response": "json",
  "sentAt": "string",
  "deliveredAt": "string",
  "responseReceivedAt": "string"
}

Tool Access

agent_message
Agent Message | NowFlow Blocks