AI

Overview

Chat with an AI assistant directly inside Directus. Create content, manage your schema, trigger automations, and explore your data through natural conversation.

Directus AI Chat is an embedded conversational assistant that helps you interact with your Directus instance through natural language.

AI Chat is currently in beta. Features and tools may change as we refine the experience based on feedback.
AI Chat requires an API key from a supported provider. Administrators configure API keys for OpenAI, Anthropic, Google, or an OpenAI-compatible endpoint in Settings → AI.

What can AI Chat do?

  • Content Management: Create, update, and organize items across your collections
  • Schema Operations: Explore your data model, add new fields and collections
  • Flow Automation: Create new Flows and trigger them manually
  • Data Exploration: Query your data and understand your schema structure

Supported Models

OpenAI

ModelModel IDContext Window Size
GPT-4o Minigpt-4o-mini128k tokens
GPT-4.1 Nanogpt-4.1-nano1M tokens
GPT-4.1 Minigpt-4.1-mini1M tokens
GPT-4.1gpt-4.11M tokens
GPT-5 Nanogpt-5-nano400k tokens
GPT-5 Minigpt-5-mini400k tokens
GPT-5gpt-5400k tokens
GPT-5.2gpt-5.2400k tokens
GPT-5.2 Chatgpt-5.2-chat-latest128k tokens
GPT-5.2 Progpt-5.2-pro400k tokens

Anthropic

ModelModel IDContext Window Size
Claude Haiku 4.5claude-haiku-4-5200k tokens
Claude Sonnet 4.5claude-sonnet-4-5200k tokens
Claude Opus 4.5claude-opus-4-5200k tokens

Google

ModelModel IDContext Window Size
Gemini 2.5 Flashgemini-2.5-flash1M tokens
Gemini 2.5 Progemini-2.5-pro1M tokens
Gemini 3 Flash Previewgemini-3-flash-preview1M tokens
Gemini 3 Pro Previewgemini-3-pro-preview1M tokens

OpenAI-Compatible

Use any OpenAI-compatible API endpoint including self-hosted models (Ollama, LM Studio), Azure OpenAI, Mistral, and more. Configure custom models in Settings → AI.

Have feedback or feature requests? Submit on our roadmap.

Key Features

  • Tool Approval: All tools require approval by default. Configure per-tool settings.
  • Uses Your Permissions: The AI operates with your existing Directus role and access policies.
  • Streaming Responses: Responses stream in real-time. Stop or retry at any time.
Conversations are stored in your browser only. They are not saved to the server or shared between devices. Closing your browser or clearing localStorage will delete your conversation history.

Get Started

Admin Setup

Configure API keys and customize the AI assistant behavior.

User Guide

Learn how to use AI Chat effectively in your daily workflow.

Available Tools

Reference of all tools the AI can use to interact with Directus.

Tips & Best Practices

Get the most out of AI Chat with practical tips and example prompts.

Security

Access control, data protection, and security considerations.

Get once-a-month release notes & real‑world code tips...no fluff. 🐰