Python SDK

from managed_deepagents import Client

with Client() as client:
    agent = 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\n"
                    "Extract 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."
                ),
            }
        ],
        include_files=True,
    )

agent_id = agent["id"]
print(f"Agent ID: {agent_id}")

该调用返回创建的代理。传递 include_files=True 也可返回托管文件树。

TypeScript SDK

const client = new Client();

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}`);

该调用返回创建的代理。传递 { includeFiles: true } 也可返回托管文件树。

cURL

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."
      }
    ]
  }'

Python SDK

from managed_deepagents import Client

agent_id = "<agent_id>"

with Client() as client:
    agent = client.agents.update(
        agent_id,
        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,
            },
        },
        include_files=True,
    )

print(agent.get("revision"))

TypeScript SDK

const client = new Client();

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

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
      }
    }
  }'

Python SDK

from managed_deepagents import Client

with Client() as client:
    agent = 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."},
        },
        include_files=True,
    )

TypeScript SDK

const client = new Client();

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

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."
      }
    }
  }'

Python SDK

from managed_deepagents import Client

with Client() as client:
    health = client.agents.health("<agent_id>")

print(health)

TypeScript SDK

const client = new Client();

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

// JSON.stringify (not console.log(health)) so nested objects print in full:
// console.log uses util.inspect with depth 2, which collapses deeper values to
// "[Object]" — e.g. the entries inside mcp_check.servers.
console.log(JSON.stringify(health, null, 2));

cURL

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