LiveKit docs › Hooks › useAgent

---

# useAgent

> ℹ️ **Note**
> 
> This feature is under active development and may change based on developer feedback and real-world usage.

useAgent encapculates all agent state, normalizing some quirks around how LiveKit Agents work.

## Import

```typescript
import { useAgent } from "@livekit/components-react";

```

## Properties

- **`session`** _(SessionStub)_ (optional): 

## Returns

```typescript
UseAgentReturn;

```

---

This document was rendered at 2026-06-07T11:32:06.591Z.
For the latest version of this document, see [https://docs.livekit.io/reference/components/react/hook/useagent.md](https://docs.livekit.io/reference/components/react/hook/useagent.md).

To explore all LiveKit documentation, see [llms.txt](https://docs.livekit.io/llms.txt).