` with the ID returned when you created the agent:
```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from managed_deepagents import Client
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"))
```
```ts theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { Client } from "@langchain/managed-deepagents";
const client = new Client({
apiKey: process.env.LANGSMITH_API_KEY,
});
const agentId = "";
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);
```
```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl --request PATCH \
--url "$DEEPAGENTS_BASE_URL/agents/?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
}
}
}'
```
To remove raw managed files during an update, send `deleted_paths`, an array of relative file paths (for example, `["docs/old-notes.md"]`). To remove a structured section such as all skills or subagents, send the field with an empty list.
### Add raw managed files
Use top-level `files` for content that does not map cleanly to `instructions`, `tools`, `skills`, or `subagents`:
```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from managed_deepagents import Client
with Client() as client:
agent = client.agents.update(
"",
files={
"docs/research-style.md": "Prefer primary sources and note uncertainty.",
"data/glossary.md": {"content": "# Glossary\n\nDefine domain terms here."},
},
include_files=True,
)
```
```ts theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { Client } from "@langchain/managed-deepagents";
const client = new Client({
apiKey: process.env.LANGSMITH_API_KEY,
});
const agent = await client.agents.update(
"",
{
files: {
"docs/research-style.md": "Prefer primary sources and note uncertainty.",
"data/glossary.md": { content: "# Glossary\n\nDefine domain terms here." },
},
},
{ includeFiles: true },
);
```
```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl --request PATCH \
--url "$DEEPAGENTS_BASE_URL/agents/?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."
}
}
}'
```
### Check agent health
After create or update, check the agent's backend and tool health with the SDK or API:
```python theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
from managed_deepagents import Client
with Client() as client:
health = client.agents.health("")
print(health)
```
```ts theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
import { Client } from "@langchain/managed-deepagents";
const client = new Client({
apiKey: process.env.LANGSMITH_API_KEY,
});
const health = await client.agents.health("");
console.log(health);
```
```bash theme={"theme":{"light":"catppuccin-latte","dark":"catppuccin-mocha"}}
curl --url "$DEEPAGENTS_BASE_URL/agents//health" \
--header "X-Api-Key: $LANGSMITH_API_KEY"
```
The result uses the same `mcp_check` shape shown in the [deploy output](#deploy-the-project).
### Manage the agent lifecycle with the API
Use the agent management routes for lifecycle automation:
| Task | Route |
| --------------- | --------------------------------------------------------------------------------------------------- |
| Create an agent | [`POST /v1/deepagents/agents`](/langsmith/managed-deep-agents-api/agents/create-agent) |
| List agents | [`GET /v1/deepagents/agents`](/langsmith/managed-deep-agents-api/agents/list-agents) |
| Get an agent | [`GET /v1/deepagents/agents/{agent_id}`](/langsmith/managed-deep-agents-api/agents/get-agent) |
| Update an agent | [`PATCH /v1/deepagents/agents/{agent_id}`](/langsmith/managed-deep-agents-api/agents/update-agent) |
| Delete an agent | [`DELETE /v1/deepagents/agents/{agent_id}`](/langsmith/managed-deep-agents-api/agents/delete-agent) |
## Next steps
After you create or deploy an agent, [run it](/langsmith/managed-deep-agents-invoke) by creating a thread and streaming a run.
***
[Connect these docs](/use-these-docs) to Claude, VSCode, and more via MCP for real-time answers.
[Edit this page on GitHub](https://github.com/langchain-ai/docs/edit/main/src/langsmith/managed-deep-agents-deploy.mdx) or [file an issue](https://github.com/langchain-ai/docs/issues/new/choose).