> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ravenna.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Tools

> Use Iru (Kandji) agent tools in Ravenna rules to find devices, run remote actions, and troubleshoot Apple endpoints during ticket handling.

Iru provides AI agent tools for device management and information retrieval. Reference these tools in <Tooltip headline="Agent rules" tip="Natural language instructions defining agent behavior" cta="Learn about agent rules" href="/documentation/automate/agents/configure#rules">agent rules</Tooltip> using @ mentions to enable automated device troubleshooting and diagnostics.

***

## Available tools

<AccordionGroup>
  <Accordion title="Find Devices" defaultOpen>
    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 Iru`

    **Input 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:**

    <Prompt description="Iru device lookup 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.
    </Prompt>
  </Accordion>
</AccordionGroup>

***

## Setup

<Steps>
  <Step title="Install Iru integration">
    Follow the [Iru setup guide](/integrations/iru/setup) to connect your Iru instance to Ravenna.
  </Step>

  <Step title="Configure agent">
    Navigate to your agent's settings and ensure Iru tools appear in the Tools section under Capabilities.
  </Step>

  <Step title="Create rules">
    Write <Tooltip headline="Agent rules" tip="Natural language instructions defining agent behavior" cta="Learn about agent rules" href="/documentation/automate/agents/configure#rules">rules</Tooltip> that reference Iru tools using @ mentions.
  </Step>

  <Step title="Test tools">
    Test your rules in a controlled environment to verify tools work as expected.
  </Step>
</Steps>

***

## 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

<Callout icon="link" color="#6B7280">
  Learn more about [configuring agents](/documentation/automate/agents/configure) and writing effective rules
</Callout>