# load_async_subagents

> **Function** in `deepagents_cli`

📖 [View in docs](https://reference.langchain.com/python/deepagents-cli/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.  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/b710a69b12e49479045eaa54dfb709326473500b/libs/cli/deepagents_cli/agent.py#L192)