Action Execution (Tools)

Actions are the core of Voxide. By registering a function, you give the AI "hands" to manipulate your web application.

#The Anatomy of an Action

Every action requires a unique name, a clear description (which the AI reads), parameter definitions, and a handler function.

ai.register({
  toggleTheme: {
    description: "Switch the website theme between dark and light mode.",
    params: { mode: { type: "string", required: true } },
    handler: ({ mode }) => {
      setTheme(mode);
      return { status: "success" };
    }
  }
});