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(defaultPulse.AI.Event.AlarmandPulse.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.