Alomana Documentation

Alomana is a space-scoped platform for composing and running Agents. Agents combine a model, instructions, reusable skills, tools, Files knowledge, and authenticated connections to answer questions, generate artifacts, and automate work.

Core concepts

• Spaces are workspace boundaries for data, agents, connections, permissions, and usage.
• Agents are reusable resources assembled from prompts, tools, skills, Files scopes, and connections.
• Connectors and Files provide credential-managed access to external systems and searchable workspace knowledge.

Client app

Your interface

Alomana Agent

Reason, retrieve, act

connections

Connected apps

Slack

Drive

SharePoint

Postgres

Knowledge base

Files, documents, and searchable content

Authentication

Use a bearer token for an interactive user or a scoped API key for a service integration. Include the selected workspace on every space-scoped request:

Authorization: Bearer <oidc-token>
X-Space-Slug: acme

For API-key calls, replace the first header with X-API-Key: sk-....

API-first quickstart

List the agents visible in a workspace, create or select an Agent, then stream a run:

curl "$CENTRAL_HUB_URL/api/v1/agents-v2/agents/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Space-Slug: acme"

curl -N -X POST "$CENTRAL_HUB_URL/api/v1/agents-v2/agents/42/run-stream/" \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Space-Slug: acme" \
  -H "Content-Type: application/json" \
  -d '{"thread_id":"quickstart-1","message":"Hello, agent!"}'

For a useful agent, create a Files scope and connections first, then include their IDs in the Agent create payload. The Agents section covers the complete workflow and generated API reference.