add-custom-tool

To add custom tools to Kotlin agents, you implement a ToolHandler with canHandle, score, and suspend handle methods, then register the tool with the AgentFramework to extend agent capabilities.

Implement deterministic scoring strategies and fast pattern matching using keyword, regex, or combined matching within the score method to ensure correct tool arbitration among multiple candidates.

Write unit tests for your ToolHandler using runBlocking to validate safe async handling, deterministic scoring, and safe error reporting when integrating custom tools with the AgentFramework.

Yes, you can extend KAgentic agents by creating custom tool implementations for external API calls, DateTime lookups, weather queries, file reading, and computation within AgentFramework-driven workflows.

Tool selection failures often occur when scoring strategies are non-deterministic or pattern matching is too slow; ensuring deterministic scoring and fast pattern matching in canHandle and score resolves this.