BoxLang AI 3.2.0 发布：图像生成、网络搜索、流畅音频、代理注册与MCP可观测性

// 链式生成并保存
aiImage( "日落时分的未来城市景观" )
    .saveToFile( "/images/cityscape.png" )

// 通过参数和提供商实现完全控制
response = aiImage(
    "山水湖泊的水彩画",
    { n: 2, size: "1024x1024", quality: "hd" },
    { provider: "openai" }
)

// 直接嵌入到 HTML 输出中
dataURI = response.toDataURI()

agent = aiAgent( tools: [ "generateImage@bxai" ] )

// 同步搜索
results = aiWebSearch( "最新的 BoxLang AI 更新", { provider: "brave", maxResults: 8 } )

// 异步 —— 返回 BoxFuture
future = aiWebSearchAsync( "BoxLang 发布亮点", { provider: "tavily" } )
results = future.get()

agent = aiAgent(
    name: "ResearchAgent",
    tools: [ "webSearch@bxai" ]
)

response = agent.run( "查找并总结最近 BoxLang AI 的发布亮点" )

// 传统语法 —— 仍然有效
audio = aiSpeak( "Hello!", { voice: "nova" }, { provider: "openai" } )

// 流畅构建器 —— 更具表现力且自文档化
audio = aiSpeak()
    .of( "Hello, world!" )
    .voice( "nova" )
    .provider( "openai" )
    .asMP3()
    .speak()

// 性别快捷键
audio = aiSpeak()
    .of( "Welcome aboard!" )
    .male()
    .speed( 1.2 )
    .speak()

// 格式快捷键
audio = aiSpeak()
    .of( "System alert." )
    .asWav()
    .outputFile( "/audio/alert.wav" )
    .speak()

// 从文件
text = aiTranscribe()
    .file( "/audio/meeting.mp3" )
    .withWordTimestamps()
    .asVerboseJSON()
    .transcribe()

// 从 URL
text = aiTranscribe()
    .url( "https://example.com/audio.mp3" )
    .language( "es" )
    .transcribe()

// 直接将音频翻译成英语
english = aiTranscribe()
    .file( "/audio/french.mp3" )
    .translate()

english = aiTranslate()
    .file( "/audio/german.mp3" )
    .asText()
    .translate()

// 在创建时自动注册
agent = aiAgent(
    name: "support-agent",
    description: "客户支持代理",
    register: true,
    module: "my-app"
)

// 或手动注册
aiAgentRegistry().register( agent, "my-app" )

// 发现正在运行的内容
agents = aiAgentRegistry().listAgents()
info   = aiAgentRegistry().getAgentInfo( "support-agent@my-app" )

// 解析字符串键和实际实例的混合数组
resolved = aiAgentRegistry().resolveAgents( [
    "support-agent@my-app",
    anotherAgentInstance
] )

// 清理
aiAgentRegistry().unregister( "support-agent@my-app" )
aiAgentRegistry().unregisterByModule( "my-app" )

server = MCPServer( "my-tools", "提供自定义工具" )
    .registerTool( myTool )

server.pause()

if ( server.isPaused() ) {
    println( "服务器已暂停 —— 拒绝所有非 ping 请求" )
}

server.resume()

client = MCP( "http://localhost:3000" )

tools  = client.listTools()
result = client.callTool( "search", { query: "BoxLang" } )

// 检查正在发生什么
stats   = client.getStats()   // 按操作、按工具、按 URI 细分
summary = client.getSummary() // totalCalls, successRate, avgResponseTime

// 需要时重置
client.resetStats()

// 带有数字和布尔参数的工具
// LLM 发送 { "quantity": 3, "applyDiscount": true } —— 无需类型转换
calculateTotal = aiTool(
    name: "calculateTotal",
    description: "计算订单总额，可选折扣",
    tool: ( numeric price, numeric quantity, boolean applyDiscount = false ) -> {
        total = price * quantity
        if ( applyDiscount ) total *= 0.9
        return { summary: "订单总额已计算", total: total }
    }
)

// 带有数组参数的工具
// LLM 发送 { "tags": ["boxlang", "ai", "tools"] } —— 原生数组
tagContent = aiTool(
    name: "tagContent",
    description: "为内容项应用标签列表",
    tool: ( string contentId, array tags ) -> {
        // tags 以真实的 BoxLang 数组到达
        return {
            summary : "标签已应用到 #contentId#",
            applied : tags.len(),
            tags    : tags
        }
    }
)

// 带有结构参数的工具
// LLM 发送 { "filter": { "status": "active", "minAge": 18 } } —— 原生结构
queryUsers = aiTool(
    name: "queryUsers",
    description: "按过滤条件查询用户",
    tool: ( struct filter, numeric limit = 10 ) -> {
        results = userService.query( filter, limit )
        return {
            summary : "找到 #results.len()# 个用户",
            count   : results.len(),
            data    : results
        }
    }
)

agent = aiAgent(
    tools: [ calculateTotal, tagContent, queryUsers ]
)

{
  "modules": {
    "bxai": {
      "settings": {
        "image": {
          "defaultProvider": "openai",
          "defaultApiKey": "",
          "defaultModel": "gpt-image-1",
          "defaultSize": "1024x1024",
          "defaultQuality": "standard",
          "defaultStyle": "vivid",
          "defaultInstructions": ""
        }
      }
    }
  }
}

# CommandBox
box install bx-ai

# OS
install-bx-module bx-ai