coldbox-ai-integrationlisted
Install: claude install-skill ColdBox/skills
# AI Integration (BoxLang AI / bx-ai)
## When to Use This Skill
Use this skill when adding AI features to a ColdBox/BoxLang application: chatbots, content generation, code assistance, semantic search (RAG), autonomous agents, or AI-enriched handlers and services.
> Full SDK docs: https://ai.ortusbooks.com/
## Setup
### Install the Module
```bash
box install bx-ai
```
### ModuleSettings (config/ColdBox.cfc)
```javascript
moduleSettings = {
"bx-ai" : {
// Default provider: openai, claude, gemini, ollama, etc.
defaultProvider : "openai",
providers : {
openai : {
apiKey : getSystemSetting( "OPENAI_API_KEY", "" ),
model : "gpt-4o"
},
claude : {
apiKey : getSystemSetting( "ANTHROPIC_API_KEY", "" ),
model : "claude-opus-4-5"
},
ollama : {
baseUrl : "http://localhost:11434",
model : "llama3"
}
}
}
};
```
## Built-In Functions (BIFs) Reference
All BIFs are available globally in BoxLang after installing `bx-ai`:
| BIF | Purpose | Returns |
|-----|---------|---------|
| `aiChat( prompt, options )` | One-shot chat | String |
| `aiChatAsync( prompt, options )` | Non-blocking chat | Future |
| `aiChatRequest()` | Build structured request | AiChatRequest |
| `aiChatStream( prompt, callback )` | Real-time streaming | void |
| `aiService()` | Get AI service instance | Servi