Tips & Best Practices

Follow these tips to work effectively with AI Chat and get better results from your conversations.

Be Specific About Collections and Fields

The more specific you are, the better results you'll get.

Less effective:

"Add a new post"

More effective:

"Create a new article in the articles collection with title 'Getting Started with Directus', status 'draft', and assign it to the 'Tutorials' category"

Complex Tasks

Break complex requests into smaller, more manageable steps:

1. "First, show me all products without descriptions"
2. "Now update product X with this description: ..."
3. "Next, do the same for product Y..."
4. "Finally, verify the products were updated correctly"

Start Fresh for New Topics

Long conversations can lose context. When switching to a different task, clear the conversation and start fresh.

Signs you should start a new conversation:

• The AI seems confused about your schema
• Responses are becoming less relevant
• You're working on an unrelated task

Configure Tool Approvals

• Read-only tools like Schema can safely be set to Always Allowed
• Keep write operations on Needs Approval until you're confident
• Disable tools you don't need to reduce token usage

See Tool Behavior for more details.

Manage Costs

AI Chat requires API keys from OpenAI or Anthropic — you cannot use a ChatGPT Plus or Claude Pro subscription. API access is billed per token, so costs scale with usage. Be mindful of this, especially with larger models.

Example Prompts by Use Case

Content Management

Show me all published articles from this month

Create a new blog post titled "AI in Content Management" with status draft

Update all products in the "Summer Sale" category to have a 20% discount tag

Find articles without a featured image

Schema Operations

What fields does the products collection have?

Add a "featured" boolean field to the articles collection

Create a relationship between products and categories (many-to-many)

Show me how the pages collection is structured

Flow Automation

List all active flows

Create a flow that sends an email when a new order is placed

Trigger the "Generate Report" flow for all products

Data Exploration

How many users signed up last week?

Show me the 10 most recent orders

What's the relationship between articles and authors?

Find all items with status "pending review"

Common Gotchas

Permissions Apply

The AI operates with your user permissions. If you're receiving permissions errors in AI Chat, it's likely the user account doesn't have the necessary permissions to perform the action.

Deletions Require Extra Care

The AI is instructed to ask for confirmation before deleting items. However, LLMs don't always follow instructions perfectly — keep destructive tools on "Ask" approval mode if you want guaranteed confirmation before deletions.

Related Data May Be Affected

When deleting items that have relationships, consider cascade behavior:

• Deleting an author may affect related articles
• Deleting a category may orphan products

The LLM may not always warn you about potential impacts.

When AI Chat Works Best

Great for:

• Exploring and understanding your schema
• Quick content operations (create, update, query)
• Setting up new collections and fields
• Triggering manual flows

Consider other approaches for:

• Very large bulk operations (use direct API or import / export through the Data Studio)
• Complex data migrations (use scripts or dedicated tools)
• Sensitive operations on production data (test in staging first)

Next Steps