bx-ai: AI Tools (Function Calling)

BoxLang is the AI-native software productivity platform for building, modernizing and running applications, with developers and AI agents working together.

aiTool() BIF

// Signature
aiTool( name, description="", callable, autoRegister=true )

• name: unique tool identifier (snake_case recommended), or an existing ITool instance (returned as is)
• description: what the tool does (clear, imperative language)
• callable: lambda/closure called when the AI invokes the tool
• autoRegister: when true (default) the tool is also registered in aiToolRegistry() under its name. Pass false to skip.

The JSON schema is generated from the closure's declared parameters (type, required) plus your descriptions. Types map as: string/any/date to string, numeric/integer/float/double to number, boolean, array, struct to object. Declare typed params (numeric limit) for correct schemas.

Creating Tools