Dialog integration (PulseAIDialogBridge)

The bridge PulseAIDialogBridge connects agents to the dialogs of Pulse Dialog. Enable it next to PulseAI and PulseDialog. It needs no setup: every agent that takes part in a dialog (an actor of the session’s participants with a UPulseAIAgentComponent) is handled on the server.

What agents hear

AI event When Payload
Pulse.AI.Event.Dialog.Started A dialog session with the agent as participant started FPulseAIDialogEventPayload: session, initiator, its pawn, role of the agent
Pulse.AI.Event.Dialog.Finished The session ended: completed, cancelled or broken off the same

They arrive like every AI event: in the agent’s StateTree (On Event transitions) and as OnAgentEvent.

Standing still: In Dialog

Add a state for conversations to the agent’s StateTree (schema Pulse AI) and enter it on the event Pulse.AI.Event.Dialog.Started, for example as a transition of the root state with a high priority. Its task In Dialog (category Pulse AI|Dialog) stops the current move, looks at the player who started the dialog and succeeds when the dialog ended; then the tree goes back to patrolling.

Root                               on event Pulse.AI.Event.Dialog.Started → Talk
├─ Talk          In Dialog         → on succeeded: Patrol
├─ Combat        ...
└─ Patrol        Patrol
Parameter Default Description
bStopMovement true Stops the current move when the state starts
bFaceInitiator true Looks at the pawn of the player who started the dialog (focus priority Gameplay)

Breaking off

While a dialog runs, the bridge breaks it off (result Cancelled) when an agent of it

  • becomes as aware as AbortAwareness (default Alert: a target is known), or
  • gets one of AbortEvents (default Pulse.AI.Event.Alarm and Pulse.AI.Event.Damaged).

An agent that is alert already when the dialog starts breaks it off right away. Settings: Project Settings > Pulse > AI Dialog Bridge (bEnabled, bAbortOnAwareness, AbortAwareness, AbortEvents).

Dialog tasks for agents

Two tasks for dialog StateTrees (schema Pulse Dialog, category Pulse|Dialog|AI) act on the agent of a participant, by Role (empty: the main speaker), on the server:

Task What it does
Set AI Profile Gives the agent another profile (Profile, bRestart): a guard that you convinced becomes a companion
Send AI Event Sends EventTag to the agent with the payload above, so its tree can follow, attack or flee from the player

Both succeed at once and fail when the participant has no agent.


This site uses Just the Docs, a documentation theme for Jekyll.