liforma docs

Add Tools

Give your avatar characters controlled external capabilities.

What are tools?

Tools are controlled external capabilities an agent can invoke during a session — query a database, check inventory, book an appointment, advance a quest.

How they work

  1. Tools are defined on the experience configuration in Studio
  2. They are wired inside opaque launch (private runtime bootstrap)
  3. The agent decides when to call a tool during conversation
  4. Results may update structured experience state in the runtime

Example

"tools": [{
  "toolId": "tool_check_score",
  "name": "checkScore",
  "description": "Look up the learner's current score"
}]

Tool schemas follow a structured format editable by creators and understandable by LLMs. Host apps do not register tools through the browser SDK today — configure them on the experience, then observe conversation via message / conversationUpdate events.