LangChain Agent Example

groundforgeai/demo

The simple_agent_service.py example creates a LangChain Agent with a safe demo tool: get_weather(city).

1. Create the external Agent in GroundForge

select the intended Organization and Workspace;
create an External Agent;
create a Service Account for the Agent process;
issue an Agent-targeted credential;
keep the stable external Agent ID, Organization ID, and Workspace ID.

Screenshot placeholder
Add /images/examples/external-agent-create.png showing the External Agent form and runtime identity.

2. Clone and install

git clone https://github.com/groundforgeai/demo.git
cd demo

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install --upgrade langchain langchain-openai
python -m pip install ./groundforge_langchain-0.2.13-py3-none-any.whl

Use the SDK wheel supplied with your GroundForge release.

3. Set the connection values

export GROUNDFORGE_ENDPOINT="https://platform.groundforge.ai"
export GROUNDFORGE_API_KEY="<agent-service-account-credential>"
export GROUNDFORGE_AGENT_ID="<stable-external-agent-id>"
export GROUNDFORGE_TENANT_ID="<organization-id>"
export GROUNDFORGE_WORKSPACE_ID="<workspace-id>"
export OPENAI_API_KEY="<openai-api-key>"

The demo does not require custom caller metadata. GroundForge sends the normalized Channel input, and automatic mode converts it into the Agent’s message input.

4. Run the Agent

python simple_agent_service.py

The example uses:

params={"channelInputMode": "auto"}

Keep the process running. In GroundForge, confirm that the Agent is connected and Discovery lists get_weather(city).

gforge agents discovery <groundforge-agent-resource-id> -o yaml

Screenshot placeholder
Add /images/examples/langchain-agent-connected.png showing connection state and get_weather in Discovery.

5. Attach a Channel

Twilio WhatsApp	Mailgun email	Slack	JSON webhook

Choose Twilio WhatsApp, Mailgun, Slack, or a JSON webhook. Attach the Channel to the Agent and publish the Agent before configuring the provider callback.

6. Send a request

What is the weather in Ottawa?

GroundForge sends the normalized request to the running Agent. The Agent selects get_weather(city="Ottawa"), the Gateway checks the rule, and the final response returns through the Channel.

7. Govern and trace the tool

Set get_weather to Observe, Review, or Block and send the same question again. Open the Trace to compare the paths. Continue with LangChain Agent with Adapters, Govern the Weather Capability, and Request Tracing.

Overview

Concepts

Examples

Platform

SDK

CLI

REST APIs

Operations

Reference

LangChain Agent Example

groundforgeai/demo

1. Create the external Agent in GroundForge

2. Clone and install

3. Set the connection values

4. Run the Agent

5. Attach a Channel

6. Send a request

7. Govern and trace the tool

groundforgeai/demo

​1. Create the external Agent in GroundForge

​2. Clone and install

​3. Set the connection values

​4. Run the Agent

​5. Attach a Channel

​6. Send a request

​7. Govern and trace the tool

1. Create the external Agent in GroundForge

2. Clone and install

3. Set the connection values

4. Run the Agent

5. Attach a Channel

6. Send a request

7. Govern and trace the tool