Source: docs/integration/overview.md

Forgium Agent — Public API overview

Forgium Agent is a conversational-agent service. Your application can send a

user message to the Public API and receive an agent response.

What you can build

Choose the path that matches the host application:

| Need | Use |

|---|---|

| A web, mobile, or backend application needs a synchronous agent reply | `POST /v1/channels/http/messages` |

| The agent needs approved live data or actions from the host application | Self-service business capabilities |

The HTTP channel currently accepts text messages.

Access boundary

Before integrating, ask the Forgium administrator for this access bundle for

the target environment:

FORGIUM_AGENT_BASE_URL=https://<public-api-host>
FORGIUM_AGENT_API_KEY=mg_xxx

Use the key only with the Public API (/v1/*). If it is missing or rejected,

ask the administrator for help. Do not request access to Forgium's internal

services.

Recommended reading order

1. Getting started — configure access and send the first message.
2. Authentication — API-key rules.
3. Choose an integration path:

- HTTP channel for a synchronous request/response flow.

- Business capabilities for live host-application data or actions.

1. Environments — keep development, staging, and production isolated.

An autonomous implementation agent should additionally follow

skill/micro-agent-integrator/SKILL.md.