Slug Agent

Starter Kit - Ships with your template. You own it - modify freely.

Overview

The Slug Agent generates unique URL-safe slugs using multiple generation strategies. Perfect for creating short links, unique identifiers, or custom URLs for your application. Key Features:

Multiple generation strategies (nanoid, UUID, base62, timestamp)
Configurable length and custom alphabets
Optional prefix support
Fast edge-native generation

Location: agents/system/slug/

Quick Start

Generate a basic slug using the default nanoid strategy:

flow:
  - name: generate-slug
    agent: slug
    input: {}

Output:

{
  "success": true,
  "slug": "xK9mPq2",
  "strategy": "nanoid"
}

Input Schema

Field	Type	Required	Default	Description
`strategy`	`string`	No	`nanoid`	Slug generation strategy. Must be one of: `nanoid`, `uuid`, `base62`, `timestamp`
`length`	`integer`	No	`7`	Length of generated slug. Minimum: 4, Maximum: 32
`alphabet`	`string`	No	-	Custom alphabet for nanoid/base62 generation
`prefix`	`string`	No	-	Prefix to prepend to the generated slug

Output Schema

Field	Type	Description
`success`	`boolean`	Whether slug generation succeeded
`slug`	`string`	The generated URL-safe slug
`strategy`	`string`	The strategy that was used for generation

Configuration

The agent supports these configuration options:

config:
  schema:
    type: object
    properties:
      defaultLength:
        type: integer
        default: 7
      defaultAlphabet:
        type: string
        default: "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ"

Strategies

nanoid (Default)

Generates compact, URL-safe IDs using a custom alphabet. Fast and collision-resistant. Characteristics:

Length: 7 characters (configurable)
Alphabet: 0-9, a-z, A-Z (62 characters)
Collision probability: ~1 billion years to have 1% probability of collision

Example:

flow:
  - name: generate
    agent: slug
    input:
      strategy: nanoid
      length: 8

Output: xK9mPq2A

uuid

Generates standard UUID v4 identifiers. Best for systems requiring universally unique identifiers. Characteristics:

Length: 36 characters (fixed)
Format: xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx
Collision probability: Virtually impossible

Example:

flow:
  - name: generate
    agent: slug
    input:
      strategy: uuid

Output: 550e8400-e29b-41d4-a716-446655440000

base62

Generates numeric IDs encoded in base62. Useful for sequential or counter-based systems. Characteristics:

Length: Configurable
Alphabet: 0-9, a-z, A-Z
Compact numeric representation

Example:

flow:
  - name: generate
    agent: slug
    input:
      strategy: base62
      length: 10

timestamp

Generates slugs based on current timestamp. Useful for time-ordered identifiers. Characteristics:

Length: Configurable
Format: Base62-encoded timestamp
Naturally sortable by creation time

Example:

flow:
  - name: generate
    agent: slug
    input:
      strategy: timestamp
      length: 12

Examples

Basic Slug Generation

Generate a simple 7-character slug:

flow:
  - name: basic-slug
    agent: slug
    input: {}

Output:

{
  "success": true,
  "slug": "xK9mPq2",
  "strategy": "nanoid"
}

Prefixed Slug

Generate a slug with a custom prefix:

flow:
  - name: prefixed-slug
    agent: slug
    input:
      prefix: "m_"
      length: 8

Output:

{
  "success": true,
  "slug": "m_a8Kp3xQ2",
  "strategy": "nanoid"
}

UUID Generation

Generate a standard UUID:

flow:
  - name: uuid-slug
    agent: slug
    input:
      strategy: uuid

Output:

{
  "success": true,
  "slug": "550e8400-e29b-41d4-a716-446655440000",
  "strategy": "uuid"
}

Custom Length

Generate a longer slug for increased uniqueness:

flow:
  - name: long-slug
    agent: slug
    input:
      strategy: nanoid
      length: 16

Custom Alphabet

Generate a slug with a custom character set:

flow:
  - name: custom-slug
    agent: slug
    input:
      strategy: nanoid
      length: 10
      alphabet: "0123456789ABCDEF"  # Hexadecimal only

URL Shortener Pattern

Combine slug generation with storage:

flow:
  - name: generate-short-id
    agent: slug
    input:
      strategy: nanoid
      length: 6

  - name: store-mapping
    operation: storage
    config:
      type: kv
      action: put
      key: "url:${generate-short-id.output.slug}"
      value: ${input.longUrl}

output:
  shortUrl: "https://yourdomain.com/${generate-short-id.output.slug}"
  slug: ${generate-short-id.output.slug}

Unique Content ID Pattern

Generate a prefixed content identifier:

flow:
  - name: create-content-id
    agent: slug
    input:
      prefix: "post_"
      strategy: nanoid
      length: 12

output:
  contentId: ${create-content-id.output.slug}
  timestamp: ${Date.now()}

Redirects Agent

Manage URL redirects and short links

Starter Kit Overview

Explore all starter kit agents

Conductor

Getting Started

Core Concepts

Building

Components

Operations Reference

Plugins

Starter Kit

Playbooks

Reference

Overview

Quick Start

Input Schema

Output Schema

Configuration

Strategies

nanoid (Default)

uuid

base62

timestamp

Examples

Basic Slug Generation

Prefixed Slug

UUID Generation

Custom Length

Custom Alphabet

URL Shortener Pattern

Unique Content ID Pattern

Redirects Agent

Starter Kit Overview

​Overview

​Quick Start

​Input Schema

​Output Schema

​Configuration

​Strategies

​nanoid (Default)

​uuid

​base62

​timestamp

​Examples

​Basic Slug Generation

​Prefixed Slug

​UUID Generation

​Custom Length

​Custom Alphabet

​URL Shortener Pattern

​Unique Content ID Pattern

​Related Documentation

Redirects Agent

Starter Kit Overview

Overview

Quick Start

Input Schema

Output Schema

Configuration

Strategies

nanoid (Default)

uuid

base62

timestamp

Examples

Basic Slug Generation

Prefixed Slug

UUID Generation

Custom Length

Custom Alphabet

URL Shortener Pattern

Unique Content ID Pattern

Related Documentation