Skip to main content

🧰 Functions

🚀 What Are Functions?​

Functions are like plugins for Sage WebUI. They help you extend its capabilities—whether it’s adding support for new AI model providers like Anthropic or Vertex AI, tweaking how messages are processed, or introducing custom buttons to the interface for better usability.

Unlike external tools that may require complex integrations, Functions are built-in and run within the Sage WebUI environment. That means they are fast, modular, and don’t rely on external dependencies.

Think of Functions as modular building blocks that let you enhance how the WebUI works, tailored exactly to what you need. They’re lightweight, highly customizable, and written in pure Python, so you have the freedom to create anything—from new AI-powered workflows to integrations with anything you use, like Google Search or Home Assistant.

🏗️ Types of Functions​

There are three types of Functions in Sage WebUI, each with a specific purpose. Let’s break them down and explain exactly what they do:

1. Pipe Function – Create Custom "Agents/Models" ​

A Pipe Function is how you create custom agents/models or integrations, which then appear in the interface as if they were standalone models.

What does it do?

  • Pipes let you define complex workflows. For instance, you could create a Pipe that sends data to Model A and Model B, processes their outputs, and combines the results into one finalized answer.
  • Pipes don’t even have to use AI! They can be setups for search APIs, weather data, or even systems like Home Assistant. Basically, anything you’d like to interact with can become part of Sage WebUI.

Use case example:
Imagine you want to query Google Search directly from Sage WebUI. You can create a Pipe Function that:

  1. Takes your message as the search query.
  2. Sends the query to Google Search’s API.
  3. Processes the response and returns it to you inside the WebUI like a normal "model" response.

When enabled, Pipe Functions show up as their own selectable model. Use Pipes whenever you need custom functionality that works like a model in the interface.

For a detailed guide, see Pipe Functions.

2. Filter Function – Modify Inputs and Outputs​

A Filter Function is like a tool for tweaking data before it gets sent to the AI or after it comes back.

What does it do?
Filters act as "hooks" in the workflow and have two main parts:

  • Inlet: Adjust the input that is sent to the model. For example, adding additional instructions, keywords, or formatting tweaks.
  • Outlet: Modify the output that you receive from the model. For instance, cleaning up the response, adjusting tone, or formatting data into a specific style.

Use case example:
Suppose you’re working on a project that needs precise formatting. You can use a Filter to ensure:

  1. Your input is always transformed into the required format.
  2. The output from the model is cleaned up before being displayed.

Filters are linked to specific models or can be enabled for all models globally, depending on your needs.

Check out the full guide for more examples and instructions: Filter Functions.

3. Action Function – Add Custom Buttons​

An Action Function is used to add custom buttons to the chat interface.

What does it do?
Actions allow you to define interactive shortcuts that trigger specific functionality directly from the chat. These buttons appear underneath individual chat messages, giving you convenient, one-click access to the actions you define.

Use case example:
Let’s say you often need to summarize long messages or generate specific outputs like translations. You can create an Action Function to:

  1. Add a “Summarize” button under every incoming message.
  2. When clicked, it triggers your custom function to process that message and return the summary.

Buttons provide a clean and user-friendly way to interact with extended functionality you define.

Learn how to set them up in the Action Functions Guide.

🛠️ How to Use Functions​

Here's how to put Functions to work in Sage WebUI:

1. Install Functions​

You can install Functions via the Sage WebUI interface or by importing them manually. You can find community-created functions on the Sage WebUI Community Site.

⚠️ Be cautious. Only install Functions from trusted sources. Running unknown code poses security risks.

2. Enable Functions​

Functions must be explicitly enabled after installation:

  • When you enable a Pipe Function, it becomes available as its own model in the interface.
  • For Filter and Action Functions, enabling them isn’t enough—you also need to assign them to specific models or enable them globally for all models.

3. Assign Filters or Actions to Models​

  • Navigate to Workspace => Models and assign your Filter or Action to the relevant model there.
  • Alternatively, enable Functions for all models globally by going to Workspace => Functions, selecting the "..." menu, and toggling the Global switch.

Quick Summary​

  • Pipes appear as standalone models you can interact with.
  • Filters modify inputs/outputs for smoother AI interactions.
  • Actions add clickable buttons to individual chat messages.

Once you’ve followed the setup process, Functions will seamlessly enhance your workflows.

✅ Why Use Functions?​

Functions are designed for anyone who wants to unlock new possibilities with Sage WebUI:

  • Extend: Add new models or integrate with non-AI tools like APIs, databases, or smart devices.
  • Optimize: Tweak inputs and outputs to fit your use case perfectly.
  • Simplify: Add buttons or shortcuts to make the interface intuitive and efficient.

Whether you’re customizing workflows for specific projects, integrating external data, or just making Sage WebUI easier to use, Functions are the key to taking control of your instance.

📝 Final Notes:​

  1. Always install Functions from trusted sources only.
  2. Make sure you understand the difference between Pipe, Filter, and Action Functions to use them effectively.
  3. Explore the official guides:

By leveraging Functions, you’ll bring entirely new capabilities to your Sage WebUI setup. Start experimenting today! 🚀