get_app

Get the fully initialized FastAPI application instance. If the app has not been created yet, this method initializes it with all routes, middleware, health checks, and security headers — the same configuration that serve() would create.

This is primarily used with deployment adapters like Mangum (AWS Lambda) or when embedding the agent in a larger FastAPI application.

Parameters

None.

Returns

FastAPI — The configured FastAPI application instance with all agent endpoints registered.

Examples

AWS Lambda with Mangum

1
from mangum import Mangum
2
from signalwire import AgentBase
3
4
agent = AgentBase(name="lambda-agent")
5
agent.set_prompt_text("You are a helpful assistant.")
6
7
app = agent.get_app()
8
handler = Mangum(app)

Embed in existing FastAPI app

1
from fastapi import FastAPI
2
from signalwire import AgentBase
3
4
main_app = FastAPI()
5
agent = AgentBase(name="assistant", route="/agent")
6
7
main_app.mount("/ai", agent.get_app())