Service Mode

Service mode lets an external Agent process requests from GroundForge Channels. The Agent opens an outbound authenticated connection, so your application does not need a public inbound endpoint.

init_groundforge(
    agent=agent,
    endpoint="https://platform.groundforge.ai",
    api_key=os.environ["GROUNDFORGE_API_KEY"],
    agent_id=os.environ["GROUNDFORGE_AGENT_ID"],
    tenant_id=os.environ["GROUNDFORGE_TENANT_ID"],
    workspace_id=os.environ["GROUNDFORGE_WORKSPACE_ID"],
    params={"channelInputMode": "auto"},
    serve=True,
)

The process then:

authenticates as the external Agent;
registers the Agent and its current tools;
opens the job connection;
receives requests for attached Channels;
converts the Channel message into Agent input;
invokes the Agent;
returns the result for Channel delivery;
sends Trace spans and completion status.

Keep the process running while Channels are active. The SDK reconnects after recoverable connection failures. Verify that the Agent appears in the correct Workspace, discovery lists the expected tools, a Channel request is claimed, one Trace is created, and the response is delivered. See Inputs when the Agent expects a custom input shape.

Example

Run LangChain Agent Example with serve=True, attach a Channel, and keep the Python process running while you send the test request.

Overview

Concepts

Examples

Platform

SDK

CLI

REST APIs

Operations

Reference

Example

​Example

Example