API App

The FastAPI app lives at naas_abi_core.apps.api.api and lazily loads engine/runtime routes.

Related pages: Engine, Agents, Configuration, MCP-Server.

Start

uv run python -m naas_abi_core.apps.api.api

Default host/port: 0.0.0.0:9879.

Route loading model

• API starts with static routes (/, /docs, /redoc, auth).
• Runtime routes are loaded lazily by calling get_app().
• For each module agent, agent.New().as_api(...) is registered under /agents.

Auth model

• Protected endpoints use bearer token validation against ABI_API_KEY.
• Token can be passed in Authorization: Bearer <token>.
• Query parameter token is also supported (?token=...).

Main agent endpoints

• POST /agents/<agent_name>/completion
• POST /agents/<agent_name>/stream-completion

Payload shape:

{
  "prompt": "Your question",
  "thread_id": "1"
}