Agents

Agent type	Where the Agent runs	Who owns the model loop
Managed Agent	GroundForge runtime	GroundForge
External Agent	Your Python process	Your application

Agent type

Where the Agent runs

Who owns the model loop

Managed Agent

GroundForge runtime

GroundForge

External Agent

Your Python process

Your application

Managed Agent

A managed Agent is configured in the GroundForge platform. GroundForge sends the request to the configured model and invokes only capabilities attached through the Agent’s governed setup.

Example

modelcontextprotocol/quickstart-resources

Use the official Weather MCP as the capability source for a managed weather Agent.

Complete Weather MCP Example so GroundForge knows get_alerts and get_forecast.

In Agents, create a managed Agent and choose its model and model credential.

Attach the Weather MCP through an MCP-targeted Gateway.

Publish the Agent and attach a Channel if users should reach it through messaging.

Send a request and open its Trace.

A managed weather request may look like:

User asks for a forecast
→ Agent selects get_forecast
→ Gateway checks the rule
→ Weather MCP runs or waits for Review
→ Agent writes the response
→ GroundForge records the Trace

External Agent

An external Agent stays in your application. The GroundForge SDK registers it, reports its tools, receives Channel jobs, applies Gateway decisions before a tool runs, and sends Trace events back to GroundForge.

Example

groundforgeai/demo

Run the LangChain weather Agent with automatic input handling or explicit adapters.

Initialize GroundForge after constructing the Agent:

import os
from groundforge_langchain import init as init_groundforge

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 example does not assume custom caller metadata. The SDK receives the normalized Channel input and passes it to the Agent.

Overview

Concepts

Examples

Platform

SDK

CLI

REST APIs

Operations

Reference

Managed Agent

Example

modelcontextprotocol/quickstart-resources

External Agent

Example

groundforgeai/demo

Example paths

​Managed Agent

​Example

modelcontextprotocol/quickstart-resources

​External Agent

​Example

groundforgeai/demo

​Example paths

Managed Agent

Example

External Agent

Example

Example paths