Behaviour for AI-powered editor operations.

Defines the contract for AI text generation, summarization, rewriting, and translation. Implement this behaviour in your application to connect PhiaUI editor AI components to your preferred LLM provider (OpenAI, Anthropic, etc.).

Usage

Define a module that uses this behaviour:

defmodule MyApp.AiProvider do
  use PhiaUi.Editor.AiBridge

  @impl true
  def generate(prompt, context, opts) do
    # Call your LLM API
    {:ok, "Generated text..."}
  end

  @impl true
  def summarize(text, opts) do
    {:ok, "Summary of the text..."}
  end
end

All callbacks have default implementations that return {:error, :not_configured}, so you only need to implement the ones you use.

Configuration

Store your provider module in application config:

config :phia_ui, :ai_bridge, MyApp.AiProvider

Then retrieve it at runtime:

bridge = Application.get_env(:phia_ui, :ai_bridge, PhiaUi.Editor.AiBridge.Noop)