Skip to main content
Fleet provides AI agent tools for device management, health monitoring, and diagnostic workflows. Reference these tools in using @ mentions to enable automated device troubleshooting and information retrieval.

​
Available tools

Look up device

Retrieves device information for a user including hostname, serial number, platform, and online status. Use this tool to identify which device to target for further operations.Tool name: @Look up device with FleetCommon use cases:
  • Find user’s device before running diagnostics
  • Verify device ownership
  • Get device identifiers for troubleshooting
  • Check if device is online
Example rule:

Fleet device lookup rule

Checks comprehensive device health metrics including battery status, disk encryption, MDM enrollment, OS updates, and uptime. Returns detailed health information for security and compliance validation.Tool name: @Check device health with FleetCommon use cases:
  • Verify security compliance before access approval
  • Diagnose device health issues
  • Check disk encryption status
  • Validate MDM enrollment
Example rule:

Fleet device health check rule

Executes predefined diagnostic queries on user devices to gather specific system information. Supports multiple query types for troubleshooting and analysis.Tool name: @Run query with FleetAvailable query types:
  • System information
  • OS version details
  • Logged in users
  • Running processes
  • Network interfaces
  • Disk space usage
  • Recent items
Common use cases:
  • Advanced device troubleshooting
  • Custom system information gathering
  • Security investigation queries
  • Performance diagnostics
Example rule:

Fleet performance diagnostics rule

Retrieves the list of available saved queries configured in Fleet. Use this to discover which diagnostic queries are available for troubleshooting.Tool name: @List saved queries with FleetCommon use cases:
  • Discover available diagnostic queries
  • Reference query names in troubleshooting
  • Guide users on diagnostic capabilities

​
Setup

1

Install Fleet integration

Follow the Fleet setup guide to connect your Fleet instance to Ravenna.
2

Configure agent

Navigate to your agent’s settings and ensure Fleet tools appear in the Tools section under Capabilities.
3

Create rules

Write that reference Fleet tools using @ mentions.
4

Test tools

Test your rules in a controlled environment to verify tools work as expected.

​
Best practices

  • Always use @Look up device with Fleet before running queries to ensure you have the correct device
  • Combine multiple tools in a single rule for comprehensive diagnostics
  • Provide clear instructions to users based on tool results
  • Check device online status before running queries
  • Consider security compliance checks for access request workflows
Learn more about configuring agents and writing effective rules