Skip to main content
This guide walks through creating a draft router, configuring its first routing graph, saving it, and calling it through the chat completions API.

​
Step 1: Navigate to Routers

  1. Log in to Bud AI Foundry.
  2. Open Router from the Bud admin navigation.
  3. Click + Router.
Image

​
Step 2: Define Router Info

  1. Enter a clear name, such as support-routing-router.
  2. Add a description that explains the routing goal.
  3. Keep the default router icon or choose an icon for easier scanning.
  4. Click Next.
Image

​
Step 3: Select a Project

  1. Search for the project that should own the router.
  2. Select the project row.
  3. Click Create Draft.
Image The router is created as a draft with an empty dag_config.

​
Step 4: Open the Router Editor

  1. Click View Router from the success screen, or open the router card from the Routers list.
  2. The detail page loads the router’s configuration and available data sources.
  3. The editor also fetches actions, so action labels, parameters, and categories match the backend catalog.

​
Step 5: Add Routing Actions

Start with a simple graph:
  1. Add a Signal action to evaluate request metadata.
  2. Add a Decision action for rule evaluation.
  3. Add an Algorithm action to choose an endpoint.
  4. Connect the graph using allowed lanes:
    • Trigger → Signal
    • Trigger → Decision
    • Decision → Algorithm
Signals and projections are inputs to decisions. They do not fan out to other actions; reference their computed values from decision rules instead.

​
Step 6: Configure Parameters

Click each action and fill the required parameters. Depending on the action metadata, fields may reference:
  • Clusters
  • Models
  • Projects
  • Providers
  • Credentials
  • Endpoints
  • Weighted or ordered endpoint lists
  • Content rules or string lists
The editor validates required fields before saving unsaved action changes.

​
Step 7: Save and Activate

Click Save. The UI maps editor steps into dag_config.steps, sets entry_step, preserves parameters and outputs, and updates the router with status active.

​
Step 8: Use the Router

From the Routers list, open the router menu and choose Use Router. Copy the generated cURL, Python, or JavaScript snippet.
Once the request is accepted, Bud evaluates the router graph and routes the request according to your configured decisions and algorithms.