Skip to main content
TrueFoundry Agents are available on SaaS only.
Build agents natively on TrueFoundry. You bring the intent — TrueFoundry handles everything else.

Bring Your Own Model

Connect any LLM available through TrueFoundry’s AI Gateway. Switch models without rewriting your agent.

MCP Server Integration

Plug in any MCP server to give your agent tools — file access, web search, APIs, databases, and more.

Sandbox Access

Agents run in a secure execution environment. Code execution, file operations, and external calls are sandboxed by default.

ReAct Agent Framework

Agents follow a reason-then-act loop out of the box. A built-in chat interface lets you interact with them immediately.
TrueFoundry manages the platform problems so you don’t have to: context window management, tool call orchestration, conversation history, system prompt handling, and multi-turn state. You focus on building and shipping.

​
Creating a New Agent

On the Agent Registry page, click Create New Agent and select Build Agent on TrueFoundry.
Create New Agent button on the Agent Registry page
Create New Agent dialog with Build Agent on TrueFoundry highlighted
This opens the Agent Playground where you build and test your agent.
1

Select a model

Choose any model available through AI Gateway.
2

Write your instructions

Add a system prompt that defines the agent’s behavior, persona, and constraints.
3

Connect MCP Servers

Click the + next to MCP Servers to open the tool selection dialog. Search for MCP servers, browse available tools, and select the ones your agent needs.
4

Run and iterate

Use the chat interface to test the agent. Adjust the prompt, switch models, or add more tools until the agent behaves as expected.
Agent Playground with model selection, system prompt, and MCP servers
Tools and MCP Servers selection dialog

​
Saving the Agent

Once you’re satisfied with the agent’s behavior, click Save Agent in the top-right corner. The dropdown gives you two options:
  • Save New Version — Update an existing agent with your changes.
  • Save New Agent — Create a brand-new agent from the current configuration.
Save dropdown with Save New Version and Save New Agent options

​
Agent Configuration

To edit an agent’s configuration after creation, click Manage on the Agent Registry page.
Agent Registry with Manage button highlighted on a TrueFoundry agent
The agent form contains the following fields:
FieldDescription
NameA unique name for the agent within your organization.
DescriptionA short description of what the agent does.
TagsOptional tags for categorization and search.
CollaboratorsTeam members or groups with Agent Manager (edit) or Agent Access (use) permissions.
Agent edit form showing name, description, and collaborator access control
For details on prompt management and versioning, see Prompt Management. For MCP server configuration, refer to Prompt Playground — MCP Servers.

​
Sharing and Using Agents

Once published, every agent appears on the Agent Registry page. Agents you have access to show Try and Manage actions.

​
Try an Agent

Click Try on any agent in the registry to open a standalone chat page.
Agent Registry with Try button highlighted on a TrueFoundry agent
This is a full conversational interface with chat history — ready for end-users to interact with immediately.
Standalone agent chat page for interacting with a published agent

​
Integrate with Code

Every agent on TrueFoundry is API-accessible. The API contract is currently under active development and will be documented in the coming weeks.

​
Monitoring

Every TrueFoundry agent execution is traced end-to-end. Traces capture each step of the agent’s reasoning loop — LLM calls, tool invocations, sandbox executions — along with cost, token usage, and latency. Navigate to AI Monitoring > Request Traces and filter by span type AgentResponse to inspect individual agent runs.
Request Traces showing agent execution spans, cost, and token usage