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

# IT

> Set up IT in Ravenna: a single help desk channel, software access requests with real provisioning, and a device lifecycle that survives onboarding and offboarding.

IT is the desk most organizations launch first. It has the highest share of requests that are repetitive, documented, and safely automatable, which is the combination the agent handles best.

## What IT owns in Ravenna

> [card] [Help desk](https://docs.ravenna.ai/guides/playbooks/it/help-desk.md)
>
> One channel, three forms, knowledge, and an agent with gated tools.

> [card] [Access provisioning](https://docs.ravenna.ai/guides/how-to/setting-up-access-provisioning.md)
>
> Access requests that route to the right approver and provision themselves.

> [card] [Device lifecycle](https://docs.ravenna.ai/guides/playbooks/it/device-lifecycle.md)
>
> Hardware requests, device questions answered from your MDM, and clean returns.

Start with the help desk. The other two both assume it exists.

## Suggested shape

One workspace called **IT**, one request channel, `#ask-it`, and a private triage channel for the responders. Everything else, the old `it@` inbox, DMs, the Portal, points at that same channel rather than creating new ones.

Add categories that match how you would want to report later: Access, Hardware, Software, Network, Accounts. Keep the list under ten.

Joiner and leaver work usually arrives differently. People Ops owns the parent ticket and creates a child ticket in the IT workspace, which fires the workflow IT owns. Give that its own channel so lifecycle work does not compete with the help desk.

Learn more about [the employee lifecycle handoff](https://docs.ravenna.ai/guides/playbooks/hr/employee-lifecycle.md)

Learn more about [choosing between channels, views, and categories](https://docs.ravenna.ai/guides/best-practices/channels-views-categories.md)

## Integrations worth connecting early

| Integration | What it unlocks |
| - | - |
| [Okta](https://docs.ravenna.ai/integrations/okta/overview), [Microsoft Entra ID](https://docs.ravenna.ai/integrations/microsoft-entra/overview), or [Google Workspace](https://docs.ravenna.ai/integrations/google-workspace/overview) | User and group sync, and automated provisioning for access requests |
| [Jamf](https://docs.ravenna.ai/integrations/jamf/overview), [Fleet](https://docs.ravenna.ai/integrations/fleet/overview), or [Intune](https://docs.ravenna.ai/integrations/intune/overview) | Device lookups, compliance checks, and remote actions from workflows |
| [Omnissa](https://docs.ravenna.ai/integrations/omnissa/overview) | Device lookups and compliance status on the ticket |
| [Jira](https://docs.ravenna.ai/integrations/jira/overview) or [Linear](https://docs.ravenna.ai/integrations/linear/overview) | Hand engineering work off without losing the ticket |
| [PagerDuty](https://docs.ravenna.ai/integrations/pagerduty/overview) or [incident.io](https://docs.ravenna.ai/integrations/incident-io/overview) | Route escalations to whoever is actually on call |

You do not need all of these on day one. An identity provider is the one that changes the most, because it turns access requests from a conversation into a provisioning action.

## Where IT desks stall

> [accordion] Splitting into topic channels too early
>
> `#ask-it-hardware` and `#ask-it-access` before you have volume creates dead channels. Use views.

> [accordion] Automating provisioning before defining approvals
>
> Decide who signs off first, then wire the grant.

> [accordion] Leaving the agent read-only
>
> Answering questions is table stakes. Look at [tool execution policies](https://docs.ravenna.ai/documentation/automate/agents/configure.md#tool-execution-policies) once the answers are landing.

## Next

> [card] [IT help desk](https://docs.ravenna.ai/guides/playbooks/it/help-desk.md)
>
> The flagship desk, end to end.

> [card] [Access provisioning](https://docs.ravenna.ai/guides/how-to/setting-up-access-provisioning.md)
>
> Requests that provision themselves.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.