> ## 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 Jamf Pro agent tools in Ravenna rules to retrieve macOS computer info, view profiles, and troubleshoot Apple devices during conversations.

Jamf Pro provides AI agent tools for macOS 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="Get computer information" defaultOpen>
    Retrieves detailed information about a Mac computer managed by Jamf Pro. Returns hardware details, software inventory, configuration profiles, and management status.

    **Tool name:** `@Get computer info with Jamf Pro`

    **Common use cases:**

    * Look up Mac device specifications
    * Verify management status
    * Check installed software and profiles
    * Troubleshoot Mac-specific issues
    * Validate device compliance

    **Example rule:**

    <Prompt description="Jamf troubleshooting rule">
      When a user reports issues with their Mac, use @Get computer info
      with Jamf Pro to retrieve device details. Check the management
      status, OS version, and installed profiles. Provide troubleshooting
      steps based on the configuration you find.
    </Prompt>
  </Accordion>
</AccordionGroup>

***

## Setup

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

  <Step title="Configure agent">
    Navigate to your agent's settings and ensure Jamf Pro 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 Jamf Pro 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 computer information retrieval to validate device compliance before access approvals
* Check management status to ensure devices are properly enrolled
* Provide Mac-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>