# FeatherCloud AI Agent

> Configure and customize your AI chatbot assistant

## Identity

| Field | Value |
| --- | --- |
| Route | `/admin/featherpanel-ai-agent` |
| Area | admin |
| Audience | Panel administrators (requires admin permissions) |
| Component | `FeatherAiAgentPage` |
| Source | `src/app/(app)/admin/featherpanel-ai-agent/page.tsx` |
| Dynamic | no |

| Title i18n key | `admin.featherai_agent.title` |
| Description i18n key | `admin.featherai_agent.subtitle` |
| Permission | `admin.statistics.view` |
| Nav group | `content` |
| Sidebar label | AI Agent |

## Summary (for AI)

**FeatherCloud AI Agent** Configure and customize your AI chatbot assistant Sidebar label: “AI Agent”. Requires permission `admin.statistics.view`. Key UI: Please wait while we fetch your configuration...; Enable or disable the AI chatbot feature for all users; Select the AI provider to use for chatbot responses; Controls randomness (0.0 = focused, 1.0 = creative); Maximum tokens in responses (1-8192); Previous messages in context (1-50).

## How to guide users

1. Open Admin sidebar.
2. Open **AI Agent**, then **FeatherCloud AI Agent**.
3. Direct URL: `/admin/featherpanel-ai-agent`.
4. User needs permission `admin.statistics.view` (or `admin.root`).

## Sections on this page

- Chatbot Configuration

## Notable UI actions / labels

- Please wait while we fetch your configuration...
- Enable or disable the AI chatbot feature for all users
- Select the AI provider to use for chatbot responses
- Controls randomness (0.0 = focused, 1.0 = creative)
- Maximum tokens in responses (1-8192)
- Previous messages in context (1-50)
- Custom system prompt to prepend to all messages (max 1000 characters)
- User context prompt to append to all messages (max 1000 characters)
- Unable to load chatbot settings. Please try again later.

## Widget slugs

- [`admin-ai-agent`](../widgets/admin-ai-agent.md)

## Related APIs / hooks

- `/api/admin/settings/chatbot/system-prompt`

Hooks: `usePluginWidgets`