Home of Agents Action icon

Home of Agents Action

Interact with the Home of Agents chat platform. Send/edit/pin/delete messages, ask the user a question, send a message and wait for the reply, fetch chat metadata, manage assistants and files. Usable as an AI agent tool. (n8n-nodes-bgos v1.17.0)

Actions21

Peer Agent → Send to Peer With Anchor

AI-generated

Summary

Posts a placeholder assistant message in the originating chat, then sends the provided text to a peer assistant in a side conversation anchored to that message. Waits for the peer’s reply unless Turn State is Final, and returns the anchor message ID together with the send result.

Inputs

  • Caller Assistant ID (required) — Positive numeric ID of the assistant making the peer call.
  • Target Assistant ID (required) — Positive numeric ID of the peer assistant to message.
  • Originating Chat ID (required) — Positive numeric ID of the chat where the placeholder and anchored side conversation appear; commonly supplied by the Home of Agents Trigger.
  • Anchor Message Text — Placeholder posted in the originating chat. Defaults to “Coordinating with peer agent…” when blank.
  • Text (required) — Message body sent to the peer; whitespace-only text is rejected.
  • Turn State — Sets the peer conversation handoff: Expecting Reply yields the turn, More Coming keeps it with the caller, and Final closes the conversation. Defaults to Expecting Reply.
  • Timeout (Seconds) — Reply wait duration from 1 to 50 seconds; defaults to 45. Waiting is skipped for Final. Longer exchanges can use a separate side-thread polling approach.
  • Idempotency Key — Optional key passed with the send request to prevent duplicate side-thread messages on retries.

Output shape

A single output item containing the input JSON merged with the peer operation result, including anchorMessageId and the send result fields (typically status, sideThreadChatId, messageId, and reply when a reply is returned).

The operation posts the anchor before sending to the peer. For non-Final turn states it waits for a reply up to the configured timeout; Final closes the conversation and does not wait. With Continue On Fail enabled, errors produce an item with success: false and an error message.

Examples

Example 1: Ask a peer to check a detail while keeping the conversation visible in the originating chat.

Set caller and target assistant IDs, originating chat ID, and the peer message. Optionally customize the placeholder and timeout. Use Final to close the side conversation without waiting for a reply.

Links

Discussion