Navigation

Mobile Docs

Agent Message

Send messages between agents

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

Agentsagent_message

Usage

01Add the block to your workflow and connect it to the upstream step.
02Configure any required credentials or tokens in the inputs.
03Fill in required inputs and optional parameters for the run.
04Run a test execution, inspect outputs, and iterate before deploying.
05Deploy 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