start_server_and_get_agent

start_server_and_get_agent(
  *,
  assistant_id: str,
  model_name: str | None

interrupt_shell_only

sandbox_snapshot_name

interpreter_ptc_acknowledge_unsafe

rubric_max_iterations

Parameters

Name	Type	Description
`assistant_id`*	`str`	Agent identifier.
`model_name`	`str \| None`	Default:`None` Model spec string.
`model_params`	`dict[str, Any] \| None`	Default:`None`
`auto_approve`	`bool`	Default:`False`
`interrupt_shell_only`	`bool`	Default:`False`
`shell_allow_list`	`list[str] \| None`	Default:`None`
`sandbox_type`	`str`	Default:`'none'`
`sandbox_id`	`str \| None`	Default:`None`
`sandbox_snapshot_name`	`str \| None`	Default:`None`
`sandbox_setup`	`str \| None`	Default:`None`
`enable_shell`	`bool`	Default:`True`
`enable_ask_user`	`bool`	Default:`False`
`enable_interpreter`	`bool \| None`	Default:`None`
`interpreter_ptc`	`str \| list[str] \| None`	Default:`None`
`interpreter_ptc_acknowledge_unsafe`	`bool`	Default:`False`
`rubric_model`	`str \| None`	Default:`None`
`rubric_max_iterations`	`int`	Default:`3`
`mcp_config_path`	`str \| None`	Default:`None`
`no_mcp`	`bool`	Default:`False`
`trust_project_mcp`	`bool \| None`	Default:`None`
`interactive`	`bool`	Default:`True`
`host`	`str`	Default:`'127.0.0.1'`
`port`	`int`	Default:`_EPHEMERAL_PORT`

Start a LangGraph server and return a connected remote agent client.

Auto-approve all tools.

Validate shell commands via middleware instead of HITL.

Restrictive shell allow-list for ShellAllowListMiddleware.

Existing sandbox ID to reuse.

Snapshot (langsmith) or blueprint (runloop) name.

Path to setup script for the sandbox.

Enable shell execution tools.

Enable ask_user tool.

Enable the JS interpreter (js_eval) middleware on the main agent. None uses the sandbox-aware default.

Override for settings.interpreter_ptc (PTC allowlist).

Explicit acknowledgement for interpreter_ptc="all" outside of auto_approve.

Grader model spec; None reuses the main model.

Grader iterations per rubric attempt.

Trust project MCP servers.

Whether the agent is interactive.

Server port. Defaults to _EPHEMERAL_PORT (0), letting the server pick a free ephemeral port instead of the well-known langgraph dev port 2024.