Deploy a Managed Deep Agent

import { Client } from "@langchain/managed-deepagents";

const client = new Client({
  apiKey: process.env.LANGSMITH_API_KEY,
});

const agent = await client.agents.create(
  {
    name: "research-assistant",
    description: "Research assistant that can search the web and summarize sources.",
    model: "openai:gpt-5.5",
    backend: { type: "state" },
    instructions:
      "You are a careful research assistant. Search for sources, keep notes, and return concise answers with citations.",
    tools: {
      tools: [
        {
          name: "read_url_content",
          mcp_server_url: "https://example.com/mcp",
          mcp_server_name: "my-tools",
        },
      ],
      interrupt_config: {
        "https://example.com/mcp::read_url_content": true,
      },
    },
    skills: [
      {
        name: "summarize",
        description: "Summarize long source documents.",
        instructions:
          "# Summarize\n\nExtract the main claims, supporting evidence, and open questions.",
      },
    ],
    subagents: [
      {
        name: "source-checker",
        description: "Verify facts and source quality.",
        model_id: "openai:gpt-5.5",
        instructions:
          "Check whether cited sources support the draft answer. Return a concise risk assessment.",
      },
    ],
  },
  { includeFiles: true },
);

console.log(`Agent ID: ${agent.id}`);

curl --request POST \
  --url "$DEEPAGENTS_BASE_URL/agents" \
  --header "X-Api-Key: $LANGSMITH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "name": "research-assistant",
    "description": "Research assistant that can search the web and summarize sources.",
    "runtime": {
      "model": {
        "model_id": "openai:gpt-5.5"
      }
    },
    "backend": {
      "type": "state"
    },
    "instructions": "You are a careful research assistant. Search for sources, keep notes, and return concise answers with citations.",
    "tools": {
      "tools": [
        {
          "name": "read_url_content",
          "mcp_server_url": "https://example.com/mcp",
          "mcp_server_name": "my-tools"
        }
      ],
      "interrupt_config": {
        "https://example.com/mcp::read_url_content": true
      }
    },
    "skills": [
      {
        "name": "summarize",
        "description": "Summarize long source documents.",
        "instructions": "# Summarize\n\nExtract the main claims, supporting evidence, and open questions."
      }
    ],
    "subagents": [
      {
        "name": "source-checker",
        "description": "Verify facts and source quality.",
        "model_id": "openai:gpt-5.5",
        "instructions": "Check whether cited sources support the draft answer. Return a concise risk assessment."
      }
    ]
  }'

import { Client } from "@langchain/managed-deepagents";

const client = new Client({
  apiKey: process.env.LANGSMITH_API_KEY,
});

const agentId = "<agent_id>";

const agent = await client.agents.update(
  agentId,
  {
    description: "Research assistant with stricter citation rules.",
    instructions:
      "You are a careful research assistant. Search for sources, keep notes, and cite every factual claim.",
    tools: {
      tools: [
        {
          name: "read_url_content",
          mcp_server_url: "https://example.com/mcp",
          mcp_server_name: "my-tools",
        },
      ],
      interrupt_config: {
        "https://example.com/mcp::read_url_content": true,
      },
    },
  },
  { includeFiles: true },
);

console.log(agent.revision);

curl --request PATCH \
  --url "$DEEPAGENTS_BASE_URL/agents/<agent_id>?include_files=true" \
  --header "X-Api-Key: $LANGSMITH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "description": "Research assistant with stricter citation rules.",
    "instructions": "You are a careful research assistant. Search for sources, keep notes, and cite every factual claim.",
    "tools": {
      "tools": [
        {
          "name": "read_url_content",
          "mcp_server_url": "https://example.com/mcp",
          "mcp_server_name": "my-tools"
        }
      ],
      "interrupt_config": {
        "https://example.com/mcp::read_url_content": true
      }
    }
  }'

import { Client } from "@langchain/managed-deepagents";

const client = new Client({
  apiKey: process.env.LANGSMITH_API_KEY,
});

const agent = await client.agents.update(
  "<agent_id>",
  {
    files: {
      "docs/research-style.md": "Prefer primary sources and note uncertainty.",
      "data/glossary.md": { content: "# Glossary\n\nDefine domain terms here." },
    },
  },
  { includeFiles: true },
);

curl --request PATCH \
  --url "$DEEPAGENTS_BASE_URL/agents/<agent_id>?include_files=true" \
  --header "X-Api-Key: $LANGSMITH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "files": {
      "docs/research-style.md": {
        "content": "Prefer primary sources and note uncertainty."
      },
      "data/glossary.md": {
        "content": "# Glossary\n\nDefine domain terms here."
      }
    }
  }'

import { Client } from "@langchain/managed-deepagents";

const client = new Client({
  apiKey: process.env.LANGSMITH_API_KEY,
});

const health = await client.agents.health("<agent_id>");

console.log(health);

curl --url "$DEEPAGENTS_BASE_URL/agents/<agent_id>/health" \
  --header "X-Api-Key: $LANGSMITH_API_KEY"