# load_async_subagents

> **Function** in `deepagents_code`

📖 [View in docs](https://reference.langchain.com/python/deepagents-code/agent/load_async_subagents)

Load async subagent definitions from `config.toml`.

Reads the `[async_subagents]` section where each sub-table defines a remote
LangGraph deployment:

```toml
[async_subagents.researcher]
description = "Research agent"
url = "https://my-deployment.langsmith.dev"
graph_id = "agent"
```

## Signature

```python
load_async_subagents(
    config_path: Path | None = None,
) -> list[AsyncSubAgent]
```

## Parameters

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `config_path` | `Path \| None` | No | Path to config file. Passing a path also excludes managed policy from this read, so production callers must pass `None`.  Defaults to `~/.deepagents/config.toml`. (default: `None`) |

## Returns

`list[AsyncSubAgent]`

List of `AsyncSubAgent` specs (empty if section is absent or invalid).

---

[View source on GitHub](https://github.com/langchain-ai/deepagents/blob/caaa7e7c12d214afa5cf0a1afed8eb6232aa6f7b/libs/code/deepagents_code/agent.py#L1152)