Agent Builder Moving to Trueforge & Agent APIs Deprecated — v0.172

In v0.172, the TrueFoundry agent builder moves to the Trueforge portal and the older Agent APIs are deprecated. Migrate to Trueforge APIs by 15th Oct, 2026.

Applicable to: Users who build or invoke agents with the TrueFoundry agent builder (the previous Agents sidebar section: Playground, Registry, and Sessions). If you do not use the agent builder, this change does not affect you.

What Is Changing

The agent builder is moving out of the main TrueFoundry sidebar Agents section into a dedicated Trueforge portal. Open it from the sidebar under TRUEFORGE → Build Agents.

Before: agent builder lived under Agents (Playground, Registry, Sessions) in the main sidebar

After: open the agent builder from TRUEFORGE → Build Agents

Clicking Build Agents opens the Trueforge portal — the managed agent builder experience:

Trueforge portal — the managed agent builder

Trueforge is powered by our open-source agent harness (truefoundry/trueforge). TrueFoundry provides a managed version of that harness in the platform.

Self-hosted gateway planes

Trueforge runs on the control plane and talks to your default gateway to discover and use the models and MCP servers available to you. If you self-host the gateway plane, Trueforge will not work unless the control plane can reach that gateway plane.

If you self-host the gateway plane and the control plane cannot communicate with it, Trueforge will not work. Please contact us to get the connection set up if it is not already in place.

Existing agents

Agents you built earlier with the agent builder are migrated automatically to Trueforge. Open Build Agents to find and continue working with them there.

APIs

If you invoke agents via APIs, the older APIs continue to work until 15th October, 2026. We recommend migrating to the new Trueforge APIs as soon as possible.

Why This Change

The agent builder is moving onto Trueforge so you get a dedicated portal for building and running agents, backed by the same open-source harness you can run yourself, with a managed experience on TrueFoundry.

What You Need to Do

1. Use Build Agents in the sidebar

   Go to TRUEFORGE → Build Agents instead of the previous Agents sidebar section (Playground, Registry, Sessions). Your existing agents appear in Trueforge after migration — no recreate step is required for agents built in the old builder.

2. Check connectivity if you self-host the gateway plane

   Confirm that your control plane can reach your self-hosted gateway plane. If it cannot, Trueforge will not be able to list models or MCP servers — contact us to set the connection up.

3. Migrate to the new Trueforge APIs

   Older agent APIs continue to work until 15th October, 2026. Migrate to the new Trueforge APIs as soon as possible.

References

• Trueforge (open source)
• Use an agent — new APIs

---

If you have questions about the migration or run into anything unexpected, reach out to [e-mail] — we’re happy to help.