Features Command

Overview

The lua features command provides an interactive interface for managing your AI agent’s capabilities: Knowledge Search (rag), Web Search (webSearch), and Inquiry Forms (inquiry). For what each feature does and how it fits with resources and the Admin Dashboard, see Features.

Prefer a UI? The same toggles and per-agent context editing are available in the Admin Dashboard — see Features → Admin Dashboard. The CLI and dashboard call the same API, so changes in one surface immediately in the other.

lua features

Centralized control over agent features with instant enable/disable and context customization!

Non-Interactive Mode

# List all features
lua features list

# Enable a feature
lua features enable --feature-name rag

# Disable a feature
lua features disable --feature-name rag

# View feature details
lua features view --feature-name webSearch

Option	Description
`--feature-name <name>`	Feature name (`rag`, `webSearch`, `inquiry`)

Action	Description	Required Options
`list`	List all features with status	None
`enable`	Enable a feature	`--feature-name`
`disable`	Disable a feature	`--feature-name`
`view`	View feature details and context	`--feature-name`

View Features

See all available features and their status

Enable/Disable

Activate or deactivate features instantly

Update Context

Customize feature instructions

Batch Updates

Update status and context together

Available Features

Knowledge Search (`rag`)

RAG-based knowledge base search for retrieving information from your documentation. Capabilities:

Semantic search across knowledge base
Category-based search (FAQ, policies, instructions)
Document retrieval with citations
Contextual information retrieval

Best for: Information agents, documentation assistants, customer support

Web Search (`webSearch`)

Real-time internet search capability for accessing current information, with source links attached to the response. Search runs one of two ways depending on your agent’s model:

Native search — models with a built-in, cited web search path (OpenAI, Anthropic, Google/Gemini, xAI, and Zhipu AI’s GLM models) use the provider’s own search tool.
Assisted search — every other model falls back to Lua’s own web-search tool.

Either way, responses come back with the same source-citation format, so your agent’s behavior doesn’t change based on which model it’s using.

Important: The Web Search feature is not a web scraper. It cannot navigate to or read specific URLs directly, and it does not scrape content from individual or bulk pages.

Capabilities:

Search the web in real-time
Retrieve up-to-date information and current events
Return synthesized answers with source citations

Best for: Research agents, information lookup, real-time data needs How to Enable:

Enabled by default for new agents, like the other built-in features. Native search can add latency and per-search cost on some models, so disable it if your agent doesn’t need it.
Can be toggled on or off by running lua features enable --feature-name webSearch or lua features disable --feature-name webSearch in the CLI.

Inquiry Forms (`inquiry`)

Define conversational forms so the agent can collect structured answers from users. Submissions are visible in the Admin Dashboard. Inquiry forms are general-purpose (leads, intake, feedback, or support-style flows)—they replaced the older standalone “support tickets” feature. Capabilities:

Generate inquiry forms from your form definitions
Collect and track submissions
Add comments and manage follow-up in the dashboard

Best for: Sales, lead capture, support intake, or any workflow that needs structured data from conversations

Quick Start

Run Command

lua features

View Features

See all available features with their current status:

Available features:

1. ✅ Knowledge Search (RAG)
   Name: rag
   Status: Active

2. ❌ WebSearch
   Name: webSearch
   Status: Inactive

3. ❌ Create Inquiry forms
   Name: inquiry
   Status: Inactive

Manage Features

Select what you want to do:

View feature details
Manage a feature (enable/disable/update)
Refresh list

View Feature Details
Manage a Feature
Refresh List

See complete information about a feature

? What would you like to do? View feature details
? Select feature: ✅ Knowledge Search (RAG)

============================================================
Feature: Knowledge Search (RAG)
============================================================

Name: rag
Status: ✅ Active

Context/Instructions:
Search the knowledge base for information.
Use categories: FAQ, policies, instructions.
Always cite sources when providing information.

Press Enter to continue...

Use for: Understanding what a feature does before enabling

Enable, disable, or update a feature

? What would you like to do? Manage a feature
? Select feature: ❌ WebSearch

? What would you like to do with "WebSearch"?
  › Activate feature
    Update context/instructions
    Update both status and context
    Back to main menu

Use for: Changing feature settings

Reload features from server

? What would you like to do? Refresh list
🔄 Refreshing features...
✅ Features refreshed successfully

Use for: Getting latest feature status after external changes

Managing Features

Enable a Feature

Select Manage

$ lua features
? What would you like to do? Manage a feature

Choose Feature

? Select feature: ❌ WebSearch

Activate

? What would you like to do? Activate feature

⚠️  This will enable "WebSearch" for your agent.

? Are you sure? Yes

🔄 Updating feature...
✅ Feature "WebSearch" activated successfully

Disable a Feature

Select Feature

$ lua features
? What would you like to do? Manage a feature
? Select feature: ✅ Knowledge Search (RAG)

Deactivate

? What would you like to do? Deactivate feature

⚠️  This will disable "Knowledge Search (RAG)" for your agent.

? Are you sure? Yes

🔄 Updating feature...
✅ Feature "Knowledge Search (RAG)" deactivated successfully

Update Feature Context

Customize how your agent uses a feature by editing its instructions.

Select Feature

$ lua features
? What would you like to do? Manage a feature
? Select feature: ✅ Knowledge Search (RAG)

Update Context

? What would you like to do? Update context/instructions

Opening editor to modify feature context...

Your system editor opens with the current context:

Search the knowledge base for information.
Use categories: FAQ, policies, instructions.
Always cite sources when providing information.

Edit and Save

Modify the instructions:

Search the knowledge base for product information.

Categories available:
- FAQ: Common customer questions
- policies: Company policies and procedures
- instructions: How-to guides and documentation

Guidelines:
- Always cite sources with document names
- If information is not found, say so clearly
- Suggest related topics when helpful
- Keep responses concise but complete

Save and exit your editor.

Confirm

? Do you want to save these changes? Yes

🔄 Updating feature context...
✅ Context updated successfully

Batch Update (Status + Context)

Update both feature status and context in one operation.

Select Feature

$ lua features
? What would you like to do? Manage a feature
? Select feature: ❌ Create Inquiry forms

Choose Batch Update

? What would you like to do? Update both status and context

? New status for "Create Inquiry forms":
  › Enable
    Disable

Edit Context

Your editor opens for context editing…Save your changes.

Review and Confirm

Summary of changes:
- Status: Inactive → Active
- Context: Updated

? Do you want to apply these changes? Yes

🔄 Updating feature...
✅ Feature "Create Inquiry forms" updated successfully

Use Cases

Customer Support Agent

Enable features for internal knowledge and optional intake:

$ lua features

# Enable Knowledge Search
→ Manage: ❌ Knowledge Search → Activate
✅ RAG enabled

# Optional: inquiry forms for structured support intake (visible in Admin Dashboard)
→ Manage: ❌ Inquiry Forms → Activate
✅ Inquiry forms enabled

# Disable Web Search if you only want org-approved sources
→ Manage: ✅ WebSearch → Deactivate
✅ WebSearch disabled

# Result: Agent focused on your knowledge base (and optional forms)

Features Active:

✅ Knowledge Search - Access help docs and policies
✅ Inquiry Forms (optional) - Structured intake or follow-up
❌ Web Search - Not needed for internal-only support

Sales Agent

Configure for lead generation and product information:

$ lua features

# Enable Inquiry Forms for lead capture
→ Manage: ❌ Inquiry Forms → Activate
→ Update context: "Collect contact info, company size, budget"
✅ Inquiry forms enabled

# Enable Knowledge Search for product info
→ Manage: ❌ Knowledge Search → Activate
✅ RAG enabled

# Enable Web Search for competitive research
→ Manage: ❌ Web Search → Activate
✅ WebSearch enabled

# Result: Lead capture + product knowledge + market research

Features Active:

✅ Inquiry Forms - Lead generation
✅ Knowledge Search - Product information
✅ Web Search - Market research

Information Agent

Optimize for information retrieval:

$ lua features

# Enable RAG as primary source
→ Manage: ❌ Knowledge Search → Activate
→ Update context: "Primary information source. Always check here first."
✅ RAG enabled

# Enable Web Search as backup
→ Manage: ❌ Web Search → Activate
→ Update context: "Use only when RAG doesn't have the answer."
✅ WebSearch enabled

# Disable inquiry if you only need read-only answers
→ Manage: ✅ Inquiry Forms → Deactivate
✅ Focused on information retrieval only

Features Active:

✅ Knowledge Search - Primary source
✅ Web Search - Supplementary data
❌ Inquiry Forms - No data collection needed

Customizing Feature Context

Writing Effective Context

Good feature context should include:

Clear Purpose

Explain what the feature is for:

✅ Good:
"Use this feature to search our internal knowledge base
for product documentation, FAQs, and policies."

❌ Bad:
"Search stuff."

When to Use

Specify appropriate situations:

✅ Good:
"Use inquiry forms when:
- You need structured lead or intake data
- The user agrees to submit a form
- Follow-up will happen in the Admin Dashboard

Do NOT use inquiry forms for:
- Simple FAQs already in the knowledge base
- One-off questions that RAG can answer"

❌ Bad:
"Use forms sometimes."

Guidelines and Rules

Set boundaries and expectations:

✅ Good:
"When using web search:
1. Use for current events and real-time data
2. Verify information with multiple sources
3. Cite sources in your response
4. If search fails, inform user honestly
5. Don't rely on search for company-specific info"

❌ Bad:
"Search the web when needed."

Examples

Provide concrete examples:

✅ Good:
"Example inquiry form fields:
- Name (required)
- Email (required)
- Company name
- Company size (1-10, 11-50, 51-200, 201+)
- Budget range
- Timeline for decision
- Additional notes"

❌ Bad:
"Collect customer information."

Context Templates

Knowledge Search Template

Search the internal knowledge base for information.

Categories available:
- FAQ: Frequently asked questions
- policies: Company policies and procedures
- instructions: Step-by-step guides
- products: Product documentation

Search best practices:
1. Try specific queries first
2. Use category filters when possible
3. Always cite the document source
4. If not found, try broader terms
5. Suggest related topics when helpful

When information is not found:
- Say so clearly and honestly
- Offer to escalate if needed
- Suggest alternative resources

Web Search Template

Use web search for real-time, current information.

Appropriate for:
- Current events and news
- Real-time data (stock prices, weather)
- Recent industry updates
- Public information not in knowledge base

Not appropriate for:
- Company-specific information (use RAG)
- Customer data or internal systems
- Proprietary information
- Historical company information

Always:
- Verify information quality
- Cite sources with URLs
- Cross-reference when possible
- Note the date of information

Inquiry Forms Template

Create inquiry forms to collect lead information.

Standard fields to include:
- Full name (required)
- Email address (required)
- Phone number (optional)
- Company name
- Company size
- Industry
- Budget range
- Timeline
- Specific needs/requirements

Qualification questions:
- What problem are you trying to solve?
- Have you used similar solutions?
- What's your timeline for implementation?
- Who else is involved in the decision?

After form submission:
- Thank the prospect
- Set expectations for response time
- Offer immediate resources if available

Complete Workflows

Initial Agent Setup

# 1. Configure features for your agent type
lua features

# 2. Enable necessary features
→ Activate relevant features

# 3. Customize each feature's context
→ Update context for each enabled feature

# 4. Test with chat
lua chat
# Test each feature's behavior

# 5. Iterate based on results
lua features
→ Adjust context as needed

Feature Testing Workflow

# 1. Enable test feature
lua features
→ Activate feature
→ Add initial context

# 2. Test in sandbox
lua chat
# Try using the feature

# 3. Review and refine
# Based on test results

# 4. Update context
lua features
→ Update context with improvements

# 5. Test again
lua chat
# Verify improvements

# 6. Deploy when satisfied
lua push skill
lua deploy

Feature Optimization

# 1. Review current features
lua features
→ View all features and their usage

# 2. Disable unused features
→ Deactivate features not being used
# Improves performance and reduces complexity

# 3. Optimize active features
→ Update context for better behavior
→ Add examples and guidelines

# 4. Test optimization
lua chat
# Verify improvements

# 5. Monitor results
# Check conversations in admin dashboard
lua admin

Integration with Other Commands

Features + Persona

Coordinate features with persona:

# 1. Enable features
lua features
→ Enable: rag, inquiry

# 2. Update persona to mention capabilities
lua persona sandbox
# Add: "I can search our knowledge base and collect details via inquiry forms"

# 3. Test together
lua chat

# 4. Deploy both
lua push persona
lua push skill

Features + Skills

Build skills that use platform features:

# 1. Enable features you need (e.g. RAG + inquiry)
lua features
→ Activate: rag

# 2. Add or extend tools in your skill project
vim src/tools/MyTool.ts

# 3. Test
lua test

# 4. Deploy
lua push skill

Features + Environment

Different features per environment:

# Development: Enable all features for testing
lua features
→ Activate: All features

# Production: Enable only needed features
lua features
→ Activate: rag, inquiry
→ Deactivate: webSearch

Best Practices

Start Minimal

Enable only features you need:

# ✅ Good: Start with essentials
lua features
→ Enable: rag only (add webSearch or inquiry when needed)

# Test and add more as needed

# ❌ Bad: Enable everything "just in case"
→ Enable: All features
# Adds complexity and potential confusion

Write Clear Context

Detailed instructions improve results:

# ✅ Good: Detailed context
"Use inquiry forms for technical escalations.
Include: problem summary, steps to reproduce,
customer impact, and priority level."

# ❌ Bad: Vague context
"Use forms for problems."

Test After Changes

Always test feature changes:

lua features
→ Update context

lua chat
# Immediately test the changes

# Verify behavior matches expectations

Document Your Setup

Keep notes on feature configuration:

# In README.md or docs
## Active Features

- Knowledge Search (rag): Internal docs only
- Web Search: Disabled (use internal knowledge)
- Inquiry Forms: Disabled (not collecting structured data)

Review Regularly

Audit features periodically:

# Monthly review
lua features
→ Check active features
→ Disable unused features
→ Update context based on learnings
→ Test improvements

Troubleshooting

Features not loading

Error: “Failed to fetch features”Solutions:

Verify authentication:
lua auth key
Check lua.skill.yaml has agentId:
agent: agentId: agent_abc123

Test API connection:

lua admin
# If admin works, features should too

Context not saving

Problem: Editor opens but changes don’t saveSolutions:

Make sure you save in editor (:wq for vim)
Confirm when prompted after editing
Check for error messages

Try again with refresh:

lua features
→ Refresh list
→ Try update again

Feature not appearing in agent

Problem: Enabled feature not available in chatSolutions:

Verify feature is active:
lua features # Check status shows ✅
Refresh agent session:
lua chat # Start new chat session
Check feature context is not empty
Redeploy if needed:
lua push skill lua deploy

Cannot enable feature

Error: “Feature update failed”Solutions:

Check agentId is correct
Verify API key has permissions
Ensure feature name is valid
Check network connection
Try refreshing features list first

Editor not opening

Problem: Context update doesn’t open editorSolutions:

Set EDITOR environment variable:

export EDITOR=vim
# or nano, code, etc.

Add to shell config (~/.bashrc or ~/.zshrc):

echo 'export EDITOR=vim' >> ~/.bashrc
source ~/.bashrc

Try different editor:
export EDITOR=nano lua features

Requirements

Authentication: Valid API key (lua auth configure)
Project: Must be in skill directory with lua.skill.yaml
Agent ID: Configuration must contain agent.agentId
Permissions: API key must have agent management permissions

lua persona

Configure agent personality to work with features

lua chat

Test features in conversation

lua admin

View feature usage in admin dashboard

lua push skill

Deploy skills that use features

Next Steps

Features overview

What each feature does (rag, webSearch, inquiry)

Test Features

Use lua chat to test feature behavior

Build Skills

Create tools that leverage features

Configure Persona

Update persona to mention capabilities

Admin Dashboard

Monitor feature usage

​Overview

​Non-Interactive Mode

View Features

Enable/Disable

Update Context

Batch Updates

​Available Features

​Knowledge Search (rag)

​Web Search (webSearch)

​Inquiry Forms (inquiry)

​Quick Start

​Main Menu Actions

​Managing Features

​Enable a Feature

​Disable a Feature

​Update Feature Context

​Batch Update (Status + Context)

​Use Cases

​Customer Support Agent

​Sales Agent

​Information Agent

​Customizing Feature Context

​Writing Effective Context

​Context Templates

​Knowledge Search Template

​Web Search Template

​Inquiry Forms Template

​Complete Workflows

​Initial Agent Setup

​Feature Testing Workflow

​Feature Optimization

​Integration with Other Commands

​Features + Persona

​Features + Skills

​Features + Environment

​Best Practices

​Troubleshooting

​Requirements

​Related Commands

lua persona

lua chat

lua admin

lua push skill

​Next Steps

Features overview

Test Features

Build Skills

Configure Persona

Admin Dashboard

Overview

Non-Interactive Mode

Available Features

Knowledge Search (`rag`)

Web Search (`webSearch`)

Inquiry Forms (`inquiry`)

Quick Start

Main Menu Actions

Managing Features

Enable a Feature

Disable a Feature

Update Feature Context

Batch Update (Status + Context)

Use Cases

Customer Support Agent

Sales Agent

Information Agent

Customizing Feature Context

Writing Effective Context

Context Templates

Knowledge Search Template

Web Search Template

Inquiry Forms Template

Complete Workflows

Initial Agent Setup

Feature Testing Workflow

Feature Optimization

Integration with Other Commands

Features + Persona

Features + Skills

Features + Environment

Best Practices

Troubleshooting

Requirements

Related Commands

Next Steps