Multi-Interface Serving

The serve() function runs multiple interfaces at the same time, with automatic restart on failure and graceful shutdown on Ctrl+C.

Quick Example

import asyncio

from definable.agent import Agent
from definable.agent.interface import (
    TelegramInterface,
    DiscordInterface,
    serve,
)
from definable.model import OpenAIChat

agent = Agent(
  model=OpenAIChat(id="gpt-4o"),
  instructions="You are a helpful multi-platform bot.",
)

telegram = TelegramInterface(
  agent=agent,
  bot_token="telegram-token",
)

discord = DiscordInterface(
  agent=agent,
  bot_token="discord-token",
)

asyncio.run(serve(telegram, discord, name="my-bot"))

serve() Function

async def serve(
    *interfaces: BaseInterface,
    name: str | None = None,
    identity_resolver: IdentityResolver | None = None,
) -> None

BaseInterface

required

One or more interface instances to run concurrently.

str

default:"None"

Display name for logging. When None, uses a generated name.

IdentityResolver

default:"None"

Shared identity resolver propagated to all interfaces. See Identity Resolution.

Behavior

Concurrent execution — each interface runs as an independent asyncio task
Automatic restart — if an interface crashes, it restarts with exponential backoff (1s → 2s → 4s → … → 60s max)
Stability threshold — if an interface runs for 60+ seconds without crashing, the backoff resets to 1s
Graceful shutdown — Ctrl+C stops all interfaces and waits for clean shutdown

Agent.serve()

Agent.serve() creates an AgentRuntime that runs interfaces alongside webhooks, cron triggers, and an HTTP server:

agent = Agent(
  model=OpenAIChat(id="gpt-4o"),
  instructions="You are a helpful bot.",
)

agent.serve(telegram, discord, port=8000)

agent.serve() is a blocking sync call. Use agent.aserve() for async contexts.

For the full runtime documentation including webhooks, cron jobs, event triggers, authentication, and dev mode, see Agent Runtime.

With Identity Resolution

For cross-platform memory continuity, pass a shared identity resolver:

from definable.agent.interface import SQLiteIdentityResolver, serve

resolver = SQLiteIdentityResolver(db_path="./identity.db")

await serve(
    telegram,
    discord,
    name="my-bot",
    identity_resolver=resolver,
)

This ensures that a user linked across platforms shares a single memory store and conversation history.

Get Started

Basics

Capabilities

Advanced

Multi-Interface Serving

Quick Example

serve() Function

Behavior

Agent.serve()

With Identity Resolution

​Quick Example

​serve() Function

​Behavior

​Agent.serve()

​With Identity Resolution

Quick Example

serve() Function

Behavior

Agent.serve()

With Identity Resolution