The first step in setting up Open Agent Platform is to deploy and configure your agents. To help with this, we’re releasing two pre-built agents, customized specifically for Open Agent Platform:

Deploying Agents

To use these agents in your instance, you should:

  1. Clone the repositories
  2. Follow the instructions in the READMEs
  3. Deploy the agents to LangGraph Platform, or run langgraph dev to run the agents locally.

Configuration

Once deployed or running locally, you can connect them to your instance of Open Agent Platform by setting the configuration environment variables. The configuration object is as follows:

{
  "id": "The project ID of the deployment. For locally running LangGraph servers, this can be any UUID Version 4.",
  "tenantId": "The tenant ID of your LangSmith account. For locally running LangGraph servers, this can be any UUID Version 4.",
  "deploymentUrl": "The API URL to your deployment.",
  "name": "A custom name for your deployment",
  "isDefault": "Whether this deployment is the default deployment. Should only be set to true for one deployment.",
  "defaultGraphId": "The graph ID of the default graph for the entire OAP instance. We recommend this is set to the graph ID of a graph which supports RAG & MCP tools. This must be set in the same deployment which isDefault is set to true on. Optional, but required in at least one deployment.",
}

If you are running agents locally via langgraph dev, the id (project ID), and tenantId should be any valid UUID version 4, such as those generated by uuid.uuid4(). Ensure each graph has a unique id, and all graphs share the same tenantId.

Finding Project & Tenant IDs

To easily find your project & tenant IDs for agents deployed to LangGraph Platform, you can make a GET request to the /info endpoint of your deployment URL. Then, copy the project_id value into id, and tenant_id into tenantId.

Setting Environment Variables

After constructing the JSON objects with these values for each of the deployments you want to include in your Open Agent Platform instance, you should stringify them into a single, flat array, then set them under the NEXT_PUBLIC_DEPLOYMENTS environment variable inside the apps/web/ directory.

The following is an example of what this variable would look like for a single, local deployment:

NEXT_PUBLIC_DEPLOYMENTS=[{"id":"bf63dc89-1de7-4a65-8336-af9ecda479d6","deploymentUrl":"http://localhost:2024","tenantId":"42d732b3-1324-4226-9fe9-513044dceb58","name":"Local deployment","isDefault":true,"defaultGraphId":"agent"}]