Skip to main content
Iru provides AI agent tools for device management and information retrieval. Reference these tools in using @ mentions to enable automated device troubleshooting and diagnostics.

​
Available tools

Find Devices

Search for devices in Kandji using various criteria such as serial number, MAC address, device name, model, platform, or user name. The tool automatically includes the requesting user’s email as a fallback search parameter and may return multiple devices matching the criteria.Tool name: @Find Devices with IruInput fields:
  • Serial number (optional)
  • MAC address (optional, format: 00:0c:29:05:43:b6)
  • Device name (optional)
  • Model (optional, e.g., “MacBook Air”, “iPhone 15”)
  • Platform (optional: Mac, iPad, iPhone, AppleTV, Android, Windows)
  • User name (optional, e.g., “Art Vandelay”)
Output data:
  • Array of matching devices with device ID, name, serial number, model, platform, OS version, last check-in, user information, asset tag, blueprint, management status, and tags
Common use cases:
  • Find all devices assigned to a user
  • Look up a specific device by serial number
  • Search for devices by model or platform
  • Locate devices by user name
  • Identify devices for troubleshooting or compliance checks
Example rule:
When a user asks about their assigned devices or device information,
use @Find Devices with Iru to search for their devices. If they mention
a specific serial number or device name, include that in the search.
Provide a summary of the devices found including model, OS version,
and last check-in time.

​
Setup

1

Install Iru integration

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

Configure agent

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

Create rules

Write that reference Iru tools using @ mentions.
4

Test tools

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

​
Best practices

  • Use device information retrieval to validate device compliance before access approvals
  • Check management status to ensure devices are properly enrolled
  • Provide device-specific troubleshooting based on device configuration
  • Consider OS version compatibility when providing guidance
  • Verify configuration profiles are properly applied
Learn more about configuring agents and writing effective rules