investigate Step

The investigate step lets the agent research across multiple systems to understand an issue. The LLM can choose which read actions to call, while the platform executes them under policy.

Syntax

- investigate:
    goal: "Determine why the device is offline"
    using:
      - devices.get_status
      - network.check_connectivity
    timeout: 30
    findings:
      offline:
        - goto: connectivity_troubleshoot
      firmware_outdated:
        - goto: firmware_update
    fallback:
      - escalate: support
    name: "Diagnose Issue"

Properties

Property	Type	Required	Description
goal	string	Yes	What to find out
using	string[]	Yes	Available READ actions
timeout	number	No	Seconds before giving up (default 30)
findings	object	Yes	Routes based on discovery
fallback	target	No	If no clear finding
name	string	No	Human readable step name

Notes

• Use read actions only
• Keep goals clear and specific
• Always provide a fallback