[User] 在 Laddr 项目中，`DatabaseService.get_session` 有什么功能？

[Assistant]
`DatabaseService.get_session` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Context manager for database sessions.
**函数签名**：
```python
def get_session(self) -> Generator[Session, None, None]:
```
**参数**：
- `self` (Any)

**返回值**：`Generator[Session, None, None]`


[User] 请解释 Laddr 中 `_generate_readme` 的作用。

[Assistant]
`_generate_readme` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/init.py`。
**功能描述**：
Generate project README.
**函数签名**：
```python
def _generate_readme(project_path: Path, project_name: str) -> None:
```
**参数**：
- `project_path` (Path)
- `project_name` (str)

**返回值**：`None`


[User] 在 Laddr 中，`InMemoryCache.delete` 方法在哪个文件里？

[Assistant] `InMemoryCache.delete` 位于 `lib/laddr/src/laddr/core/cache.py`。


[User] 如何在 Laddr 中使用 `print_panel` 函数？

[Assistant]
`print_panel` 位于 `lib/laddr/src/laddr/cli/utils/logger.py`，使用方法如下：
```python
print_panel(title=..., content=..., style=...)
```
**参数说明**：
- `title`: str - Panel title
- `content`: str
- `style`: str

**功能简述**：Print a styled panel. Args: title: Panel title content: Panel content style: Panel border style (default: cyan)...


[User] 在 Laddr 项目中，`_get_span_type` 有什么功能？

[Assistant]
`_get_span_type` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/api/main.py`。
**功能描述**：
Determine span type for UI rendering.
**函数签名**：
```python
def _get_span_type(event_type: str, payload: dict) -> str:
```
**参数**：
- `event_type` (str)
- `payload` (dict)

**返回值**：`str`


[User] 请解释 Laddr 中 `ResponseMessage` 的作用。

[Assistant]
`ResponseMessage` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/message_bus.py`。
**功能描述**：
Response from an agent after processing a task.
**函数签名**：
```python
class ResponseMessage:
```


[User] 请解释 Laddr 中 `print_success` 的作用。

[Assistant]
`print_success` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/logger.py`。
**功能描述**：
Print a success message. Args: message: Main success message details: Optional additional details
**函数签名**：
```python
def print_success(message: str, details: str | None = None) -> None:
```
**参数**：
- `message` (str): Main success message
- `details` (str | None)

**返回值**：`None`


[User] 在 Laddr 中，`InvalidConfigError.__init__` 方法在哪个文件里？

[Assistant] `InvalidConfigError.__init__` 位于 `lib/laddr/src/laddr/cli/utils/errors.py`。


[User] 请解释 Laddr 中 `ToolRegistry.list` 的作用。

[Assistant]
`ToolRegistry.list` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/tooling.py`。
**功能描述**：
List all registered tools (excludes aliases).
**函数签名**：
```python
def list(self) -> list[Tool]:
```
**参数**：
- `self` (Any)

**返回值**：`list[Tool]`


[User] 在 Laddr 中，`DatabaseService.get_token_usage` 方法在哪个文件里？

[Assistant] `DatabaseService.get_token_usage` 位于 `lib/laddr/src/laddr/core/database.py`。


[User] 在 Laddr 项目中，`Agent._trace` 有什么功能？

[Assistant]
`Agent._trace` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/agent_runtime.py`。
**功能描述**：
Append a trace if enabled and not masked.
**函数签名**：
```python
def _trace(self, job_id: str, agent_name: str, event_type: str, payload: dict) -> None:
```
**参数**：
- `self` (Any)
- `job_id` (str)
- `agent_name` (str)
- `event_type` (str)
- `payload` (dict)

**返回值**：`None`


[User] Laddr 的 `LLMBackend` 是做什么的？

[Assistant]
`LLMBackend` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Protocol for LLM backends.
**函数签名**：
```python
class LLMBackend(Protocol):
```


[User] 在 Laddr 项目中，`init` 有什么功能？

[Assistant]
`init` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/init.py`。
**功能描述**：
Initialize a new Laddr project. Creates project structure with: - Configuration files (laddr.yml, .env) - Docker setup (docker-compose.yml, Dockerfile) - Default researcher agent - Example tools and pipeline Users import from laddr package: from laddr import Agent, AgentRunner, run_agent, actor, tool Examples: laddr init myproject laddr init myproject --path /path/to/dir laddr init  # Interactive mode
**函数签名**：
```python
def init(project_name: str | None, path: str):
```
**参数**：
- `project_name` (str | None)
- `path` (str)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `DatabaseService.memory_put` 函数？

[Assistant]
`DatabaseService.memory_put` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.memory_put(agent_name=..., key=..., value=..., job_id=...)
```
**参数说明**：
- `agent_name`: str
- `key`: str
- `value`: Any
- `job_id`: str | None

**功能简述**：Store a memory entry....


[User] Laddr 的 `run_dev_alias` 是做什么的？

[Assistant]
`run_dev_alias` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/run.py`。
**功能描述**：
Alias for 'laddr run dev'.
**函数签名**：
```python
def run_dev_alias():
```
**返回值**：`None`


[User] 如何在 Laddr 中使用 `S3Storage.__init__` 函数？

[Assistant]
`S3Storage.__init__` 位于 `lib/laddr/src/laddr/core/storage.py`，使用方法如下：
```python
S3Storage.__init__(endpoint=..., access_key=..., secret_key=..., secure=..., region=...)
```
**参数说明**：
- `endpoint`: str - S3 endpoint (e.g., "s3.amazonaws.com" or "minio:9000")
- `access_key`: str
- `secret_key`: str
- `secure`: bool

**功能简述**：Initialize S3-compatible storage. Args: endpoint: S3 endpoint (e.g., "s3.amazonaws.com" or "minio:9000") access_key: Access key (AWS Access Key ID or MinIO access key) secret_key: Secret key (AWS Secr...


[User] 如何在 Laddr 中使用 `grok` 函数？

[Assistant]
`grok` 位于 `lib/laddr/src/laddr/llms.py`，使用方法如下：
```python
grok(model=..., temperature=...)
```
**参数说明**：
- `model`: str | None - Model name (default: grok-beta)
- `temperature`: float | None

**功能简述**：Create a xAI Grok LLM backend instance. Args: model: Model name (default: grok-beta) temperature: Generation temperature Example: llm = grok(model="grok-beta", temperature=0.7)...


[User] 在 Laddr 项目中，`ToolRegistry.list_all_names` 有什么功能？

[Assistant]
`ToolRegistry.list_all_names` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/tooling.py`。
**功能描述**：
List all names including aliases (for debugging).
**函数签名**：
```python
def list_all_names(self) -> list[str]:
```
**参数**：
- `self` (Any)

**返回值**：`list[str]`


[User] 在 Laddr 项目中，`InMemoryCache.clear` 有什么功能？

[Assistant]
`InMemoryCache.clear` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/cache.py`。
**功能描述**：
Clear all cache entries.
**函数签名**：
```python
def clear(self) -> None:
```
**参数**：
- `self` (Any)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `InMemoryCache.__init__` 函数？

[Assistant]
`InMemoryCache.__init__` 位于 `lib/laddr/src/laddr/core/cache.py`，使用方法如下：
**参数说明**：


[User] Laddr 的 `cli` 是做什么的？

[Assistant]
`cli` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/main.py`。
**功能描述**：
Laddr - Transparent, Docker-native agent framework.
**函数签名**：
```python
def cli():
```
**返回值**：`None`


[User] Laddr 的 `BackendFactory.create_llm_backend` 是做什么的？

[Assistant]
`BackendFactory.create_llm_backend` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Create LLM backend based on config. If `override` is provided it takes precedence over the global `LaddrConfig.llm_backend`. `model_override` can be provided to select a different model for an agent.
**函数签名**：
```python
def create_llm_backend(self, override: str | None = None, model_override: str | None = None, agent_name: str | None = None) -> LLMBackend:
```
**参数**：
- `self` (Any)
- `override` (str | None)
- `model_override` (str | None)
- `agent_name` (str | None)

**返回值**：`LLMBackend`


[User] 如何在 Laddr 中使用 `CacheBackend.set` 函数？

[Assistant]
`CacheBackend.set` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
CacheBackend.set(key=..., value=..., ttl=...)
```
**参数说明**：
- `key`: str
- `value`: Any
- `ttl`: int | None


[User] 如何在 Laddr 中使用 `DatabaseService.save_result` 函数？

[Assistant]
`DatabaseService.save_result` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.save_result(job_id=..., outputs=..., status=...)
```
**参数说明**：
- `job_id`: str
- `outputs`: dict
- `status`: str

**功能简述**：Save job result....


[User] Laddr 的 `DatabaseService.save_prompt_result` 是做什么的？

[Assistant]
`DatabaseService.save_prompt_result` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Save prompt execution result.
**函数签名**：
```python
def save_prompt_result(self, prompt_id: str, outputs: dict, status: str = "completed") -> None:
```
**参数**：
- `self` (Any)
- `prompt_id` (str)
- `outputs` (dict)
- `status` (str)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `ProjectConfigSchema.load_from_file` 函数？

[Assistant]
`ProjectConfigSchema.load_from_file` 位于 `lib/laddr/src/laddr/cli/utils/config.py`，使用方法如下：
```python
ProjectConfigSchema.load_from_file(cls=..., path=...)
```
**参数说明**：
- `cls`: Any
- `path`: Path - Path to laddr.yml

**功能简述**：Load project config from YAML file. Args: path: Path to laddr.yml Returns: Parsed project configuration Raises: InvalidConfigError: If config is invalid...


[User] 在 Laddr 中，`replay_job` 函数在哪个文件里？

[Assistant] `replay_job` 位于 `lib/laddr/src/laddr/cli/commands/run.py`。


[User] 如何在 Laddr 中使用 `AgentMemory.list` 函数？

[Assistant]
`AgentMemory.list` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
**参数说明**：

**功能简述**：List all memory entries....


[User] 如何在 Laddr 中使用 `S3Storage._get_client` 函数？

[Assistant]
`S3Storage._get_client` 位于 `lib/laddr/src/laddr/core/storage.py`，使用方法如下：
**参数说明**：

**功能简述**：Get synchronous S3-compatible client....


[User] 如何在 Laddr 中使用 `DatabaseService.get_session` 函数？

[Assistant]
`DatabaseService.get_session` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
**参数说明**：

**功能简述**：Context manager for database sessions....


[User] 请解释 Laddr 中 `TemplateRenderer.render_template` 的作用。

[Assistant]
`TemplateRenderer.render_template` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/cli/utils/templates.py`。
**功能描述**：
Render a template with context. Args: template_name: Template filename context: Template context variables Returns: Rendered template content Raises: FileGenerationError: If template rendering fails
**函数签名**：
```python
def render_template(self, template_name: str, context: dict[str, Any]) -> str:
```
**参数**：
- `self` (Any)
- `template_name` (str): Template filename
- `context` (dict[str, Any])

**返回值**：`str`


[User] 在 Laddr 中，`add` 函数在哪个文件里？

[Assistant] `add` 位于 `lib/laddr/src/laddr/cli/commands/add.py`。


[User] 如何在 Laddr 中使用 `scale` 函数？

[Assistant]
`scale` 位于 `lib/laddr/src/laddr/cli/commands/management.py`，使用方法如下：
```python
scale(agent_name=..., replicas=...)
```
**参数说明**：
- `agent_name`: str
- `replicas`: int

**功能简述**：Scale an agent worker to N replicas. Examples: laddr scale researcher 3 laddr scale summarizer 0  # Stop all replicas...


[User] 如何在 Laddr 中使用 `Tool.invoke` 函数？

[Assistant]
`Tool.invoke` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
**参数说明**：

**功能简述**：Invoke the tool with validated inputs. Returns tool execution result....


[User] 如何在 Laddr 中使用 `DatabaseService.append_trace` 函数？

[Assistant]
`DatabaseService.append_trace` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.append_trace(job_id=..., agent_name=..., event_type=..., payload=...)
```
**参数说明**：
- `job_id`: str
- `agent_name`: str
- `event_type`: str
- `payload`: dict

**功能简述**：Append a trace event....


[User] 如何在 Laddr 中使用 `tool` 函数？

[Assistant]
`tool` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
```python
tool(name=..., description=...)
```
**参数说明**：
- `name`: str | None
- `description`: str | None

**功能简述**：Decorator to mark a function as an agent tool. Usage: @tool(name="web_search", description="Search the web") def search(query: str) -> dict: return {"results": [...]} Or with Pydantic input model: cla...


[User] 在 Laddr 中，`AgentInfo` 类在哪个文件里？

[Assistant] `AgentInfo` 位于 `lib/laddr/src/laddr/api/main.py`。


[User] 请解释 Laddr 中 `TemplateRenderer._pascal_case` 的作用。

[Assistant]
`TemplateRenderer._pascal_case` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/cli/utils/templates.py`。
**功能描述**：
Convert string to PascalCase.
**函数签名**：
```python
def _pascal_case(value: str) -> str:
```
**参数**：
- `value` (str)

**返回值**：`str`


[User] 如何在 Laddr 中使用 `BackendFactory.__init__` 函数？

[Assistant]
`BackendFactory.__init__` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
BackendFactory.__init__(config=...)
```
**参数说明**：
- `config`: LaddrConfig


[User] 如何在 Laddr 中使用 `list_prompts` 函数？

[Assistant]
`list_prompts` 位于 `lib/laddr/src/laddr/cli/commands/prompt.py`，使用方法如下：
```python
list_prompts(limit=...)
```
**参数说明**：
- `limit`: int

**功能简述**：List recent prompt executions....


[User] 请解释 Laddr 中 `ToolRegistry.has` 的作用。

[Assistant]
`ToolRegistry.has` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/tooling.py`。
**功能描述**：
Check if a tool exists (checks both canonical names and aliases).
**函数签名**：
```python
def has(self, name: str) -> bool:
```
**参数**：
- `self` (Any)
- `name` (str)

**返回值**：`bool`


[User] 在 Laddr 中，`compose_up` 函数在哪个文件里？

[Assistant] `compose_up` 位于 `lib/laddr/src/laddr/cli/utils/docker.py`。


[User] 如何在 Laddr 中使用 `HTTPLLM.__init__` 函数？

[Assistant]
`HTTPLLM.__init__` 位于 `lib/laddr/src/laddr/core/llm.py`，使用方法如下：
```python
HTTPLLM.__init__(endpoint=...)
```
**参数说明**：
- `endpoint`: str


[User] Laddr 的 `DatabaseService.list_jobs` 是做什么的？

[Assistant]
`DatabaseService.list_jobs` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
List recent jobs.
**函数签名**：
```python
def list_jobs(self, limit: int = 50) -> list[dict]:
```
**参数**：
- `self` (Any)
- `limit` (int)

**返回值**：`list[dict]`


[User] 如何在 Laddr 中使用 `AgentRunner.__init__` 函数？

[Assistant]
`AgentRunner.__init__` 位于 `lib/laddr/src/laddr/core/runtime_entry.py`，使用方法如下：
```python
AgentRunner.__init__(agent=..., env_config=...)
```
**参数说明**：
- `agent`: Agent | None - Agent instance (created if None)
- `env_config`: LaddrConfig | None

**功能简述**：Initialize runner. Args: agent: Agent instance (created if None) env_config: Environment configuration...


[User] 如何在 Laddr 中使用 `ToolRegistry.list_names` 函数？

[Assistant]
`ToolRegistry.list_names` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
**参数说明**：

**功能简述**：List all canonical tool names (excludes aliases)....


[User] 在 Laddr 项目中，`DatabaseService.get_token_usage` 有什么功能？

[Assistant]
`DatabaseService.get_token_usage` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Aggregate token usage for a job from llm_usage traces.
**函数签名**：
```python
def get_token_usage(self, job_id: str) -> dict:
```
**参数**：
- `self` (Any)
- `job_id` (str)

**返回值**：`dict`


[User] 在 Laddr 项目中，`ToolRegistry` 有什么功能？

[Assistant]
`ToolRegistry` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/tooling.py`。
**功能描述**：
Registry for managing available tools. Supports registration, lookup, and listing of tools.
**函数签名**：
```python
class ToolRegistry:
```


[User] 如何在 Laddr 中使用 `DatabaseBackend.get_result` 函数？

[Assistant]
`DatabaseBackend.get_result` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
DatabaseBackend.get_result(job_id=...)
```
**参数说明**：
- `job_id`: str


[User] 在 Laddr 项目中，`AgentInfo` 有什么功能？

[Assistant]
`AgentInfo` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/api/main.py`。
**功能描述**：
Agent information.
**函数签名**：
```python
class AgentInfo(BaseModel):
```


[User] 请解释 Laddr 中 `clear_tool_overrides` 的作用。

[Assistant]
`clear_tool_overrides` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/core/system_tools.py`。
**功能描述**：
Clear all tool overrides. Useful for testing.
**函数签名**：
```python
def clear_tool_overrides():
```
**返回值**：`None`


[User] 如何在 Laddr 中使用 `ParallelDelegationTool.__init__` 函数？

[Assistant]
`ParallelDelegationTool.__init__` 位于 `lib/laddr/src/laddr/core/system_tools.py`，使用方法如下：
```python
ParallelDelegationTool.__init__(message_bus=..., artifact_storage=..., agent=...)
```
**参数说明**：
- `message_bus`: Any - Message queue backend for inter-agent communication
- `artifact_storage`: Any
- `agent`: Any

**功能简述**：Initialize parallel delegation tool. Args: message_bus: Message queue backend for inter-agent communication artifact_storage: Optional storage backend for large payloads agent: Optional agent instance...


[User] 如何在 Laddr 中使用 `DatabaseService.create_job` 函数？

[Assistant]
`DatabaseService.create_job` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.create_job(job_id=..., pipeline=..., inputs=...)
```
**参数说明**：
- `job_id`: str | None
- `pipeline`: str
- `inputs`: dict

**功能简述**：Create a new job record, or reuse existing if job_id already exists (for sequential chains)....


[User] Laddr 的 `PromptExecution` 是做什么的？

[Assistant]
`PromptExecution` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Prompt execution record (new terminology for pipeline/job).
**函数签名**：
```python
class PromptExecution(Base):
```


[User] 在 Laddr 中，`list_prompts` 函数在哪个文件里？

[Assistant] `list_prompts` 位于 `lib/laddr/src/laddr/cli/commands/prompt.py`。


[User] 如何在 Laddr 中使用 `stop` 函数？

[Assistant]
`stop` 位于 `lib/laddr/src/laddr/cli/commands/management.py`，使用方法如下：
```python
stop(volumes=...)
```
**参数说明**：
- `volumes`: bool

**功能简述**：Stop all Laddr services. Examples: laddr stop laddr stop --volumes  # Also remove data volumes...


[User] 在 Laddr 中，`AgentMemory.get` 方法在哪个文件里？

[Assistant] `AgentMemory.get` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`。


[User] 在 Laddr 中，`run_local` 函数在哪个文件里？

[Assistant] `run_local` 位于 `lib/laddr/src/laddr/cli/main.py`。


[User] 在 Laddr 中，`Memory` 类在哪个文件里？

[Assistant] `Memory` 位于 `lib/laddr/src/laddr/core/database.py`。


[User] 在 Laddr 项目中，`S3Storage` 有什么功能？

[Assistant]
`S3Storage` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/storage.py`。
**功能描述**：
S3-compatible storage backend for AWS S3 and MinIO. This class uses the minio Python package which is fully compatible with: - AWS S3 (cloud) - MinIO (self-hosted) - Any S3-compatible storage service For AWS S3: endpoint: "s3.amazonaws.com" or "s3.<region>.amazonaws.com" access_key: AWS Access Key ID secret_key: AWS Secret Access Key secure: True (use HTTPS) For MinIO: endpoint: "localhost:9000" or "minio:9000" access_key: MinIO access key (default: minioadmin) secret_key: MinIO secret key secure: False (or True for HTTPS)
**函数签名**：
```python
class S3Storage:
```


[User] Laddr 的 `_generate_core_modules` 是做什么的？

[Assistant]
`_generate_core_modules` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/init.py`。
**功能描述**：
V3.0: Users import from laddr package, no need to generate core files. This function is kept for backward compatibility but does nothing. Users should use: from laddr import Agent, AgentRunner, run_agent
**函数签名**：
```python
def _generate_core_modules(project_path: Path) -> None:
```
**参数**：
- `project_path` (Path)

**返回值**：`None`


[User] 请解释 Laddr 中 `GrokLLM` 的作用。

[Assistant]
`GrokLLM` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/llm.py`。
**功能描述**：
xAI Grok LLM backend - uses native HTTP API.
**函数签名**：
```python
class GrokLLM:
```


[User] 如何在 Laddr 中使用 `TemplateRenderer._snake_case` 函数？

[Assistant]
`TemplateRenderer._snake_case` 位于 `lib/laddr/src/laddr/cli/utils/templates.py`，使用方法如下：
```python
TemplateRenderer._snake_case(value=...)
```
**参数说明**：
- `value`: str

**功能简述**：Convert string to snake_case....


[User] 在 Laddr 中，`build_image` 函数在哪个文件里？

[Assistant] `build_image` 位于 `lib/laddr/src/laddr/cli/utils/docker.py`。


[User] 如何在 Laddr 中使用 `DatabaseService.get_prompt_result` 函数？

[Assistant]
`DatabaseService.get_prompt_result` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.get_prompt_result(prompt_id=...)
```
**参数说明**：
- `prompt_id`: str

**功能简述**：Get prompt execution result....


[User] 在 Laddr 项目中，`infra` 有什么功能？

[Assistant]
`infra` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/infra.py`。
**功能描述**：
Show infrastructure configuration and status.
**函数签名**：
```python
def infra(show_config: bool):
```
**参数**：
- `show_config` (bool)

**返回值**：`None`


[User] 在 Laddr 中，`stop` 函数在哪个文件里？

[Assistant] `stop` 位于 `lib/laddr/src/laddr/cli/commands/management.py`。


[User] Laddr 的 `Job` 是做什么的？

[Assistant]
`Job` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Job execution record (legacy terminology).
**函数签名**：
```python
class Job(Base):
```


[User] 在 Laddr 项目中，`Tool` 有什么功能？

[Assistant]
`Tool` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/tooling.py`。
**功能描述**：
Tool metadata and callable. Represents a single tool that can be invoked by agents.
**函数签名**：
```python
class Tool:
```


[User] 如何在 Laddr 中使用 `DatabaseService.create_tables` 函数？

[Assistant]
`DatabaseService.create_tables` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
**参数说明**：

**功能简述**：Create all database tables if they don't exist....


[User] Laddr 的 `main` 是做什么的？

[Assistant]
`main` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/main.py`。
**功能描述**：
Main entry point with error handling.
**函数签名**：
```python
def main():
```
**返回值**：`None`


[User] 如何在 Laddr 中使用 `WorkerRunner.__init__` 函数？

[Assistant]
`WorkerRunner.__init__` 位于 `lib/laddr/src/laddr/core/runtime_entry.py`，使用方法如下：
```python
WorkerRunner.__init__(agent=..., database_url=..., redis_url=..., storage_endpoint=..., storage_access_key=...)
```
**参数说明**：
- `agent`: Agent
- `database_url`: str | None
- `redis_url`: str | None
- `storage_endpoint`: str | None


[User] 如何在 Laddr 中使用 `create_system_tools` 函数？

[Assistant]
`create_system_tools` 位于 `lib/laddr/src/laddr/core/system_tools.py`，使用方法如下：
```python
create_system_tools(message_bus=..., storage_backend=..., agent=...)
```
**参数说明**：
- `message_bus`: Any - Message queue backend
- `storage_backend`: Any
- `agent`: Any

**功能简述**：Create system tools for task delegation and artifact management. This function checks for user-provided overrides before registering the default implementations. Users can use @override_system_tool de...


[User] 在 Laddr 中，`ProjectDetails` 类在哪个文件里？

[Assistant] `ProjectDetails` 位于 `lib/laddr/src/laddr/cli/utils/config.py`。


[User] Laddr 的 `DatabaseService.update_prompt_status` 是做什么的？

[Assistant]
`DatabaseService.update_prompt_status` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Update prompt execution status only; set completed_at for terminal states.
**函数签名**：
```python
def update_prompt_status(self, prompt_id: str, status: str) -> None:
```
**参数**：
- `self` (Any)
- `prompt_id` (str)
- `status` (str)

**返回值**：`None`


[User] Laddr 的 `GroqLLM` 是做什么的？

[Assistant]
`GroqLLM` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/llm.py`。
**功能描述**：
Groq LLM backend (ultra-fast inference).
**函数签名**：
```python
class GroqLLM:
```


[User] 在 Laddr 中，`AgentChatRequest` 类在哪个文件里？

[Assistant] `AgentChatRequest` 位于 `lib/laddr/src/laddr/api/main.py`。


[User] Laddr 的 `Trace` 是做什么的？

[Assistant]
`Trace` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Trace event for observability with hierarchical span support.
**函数签名**：
```python
class Trace(Base):
```


[User] 在 Laddr 中，`InMemoryCache.__init__` 方法在哪个文件里？

[Assistant] `InMemoryCache.__init__` 位于 `lib/laddr/src/laddr/core/cache.py`。


[User] Laddr 的 `AgentRunner.replay` 是做什么的？

[Assistant]
`AgentRunner.replay` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/runtime_entry.py`。
**功能描述**：
Replay a previous job. Args: job_id: Job ID to replay reexecute: If True, re-execute the job; if False, return stored result Returns: Job result
**函数签名**：
```python
def replay(
self,
job_id: str,
reexecute: bool = False
) -> dict:
```
**参数**：
- `self` (Any)
- `job_id` (str): Job ID to replay
- `reexecute` (bool)

**返回值**：`dict`


[User] 在 Laddr 项目中，`Agent` 有什么功能？

[Assistant]
`Agent` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/__init__.py`。
**功能描述**：
Factory for user-friendly Agent(...) syntax. Creates a CoreAgent instance under the hood using AgentConfig and LaddrConfig. Unrecognized parameters like max_retries/timeout are currently accepted for forward-compatibility but not used directly.
**函数签名**：
```python
def Agent(
*,
name: str,
role: str,
goal: str,
```
**返回值**：`None`


[User] 如何在 Laddr 中使用 `KafkaBus.__init__` 函数？

[Assistant]
`KafkaBus.__init__` 位于 `lib/laddr/src/laddr/core/message_bus.py`，使用方法如下：
```python
KafkaBus.__init__(bootstrap_servers=...)
```
**参数说明**：
- `bootstrap_servers`: str


[User] 如何在 Laddr 中使用 `decorator` 函数？

[Assistant]
`decorator` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
```python
decorator(func=...)
```
**参数说明**：
- `func`: Callable


[User] 如何在 Laddr 中使用 `GrokLLM.__init__` 函数？

[Assistant]
`GrokLLM.__init__` 位于 `lib/laddr/src/laddr/core/llm.py`，使用方法如下：
```python
GrokLLM.__init__(api_key=..., model=...)
```
**参数说明**：
- `api_key`: str | None
- `model`: str | None


[User] 如何在 Laddr 中使用 `infra` 函数？

[Assistant]
`infra` 位于 `lib/laddr/src/laddr/cli/commands/infra.py`，使用方法如下：
```python
infra(show_config=...)
```
**参数说明**：
- `show_config`: bool

**功能简述**：Show infrastructure configuration and status....


[User] 如何在 Laddr 中使用 `add_agent` 函数？

[Assistant]
`add_agent` 位于 `lib/laddr/src/laddr/cli/commands/add.py`，使用方法如下：
```python
add_agent(agent_name=..., role=..., goal=..., backstory=..., llm_provider=...)
```
**参数说明**：
- `agent_name`: str
- `role`: str | None
- `goal`: str | None
- `backstory`: str | None
- `llm_provider`: str

**功能简述**：Add a new agent to the project. Examples: laddr add agent summarizer laddr add agent analyst --role "Data Analyst" --goal "Analyze data"...


[User] 如何在 Laddr 中使用 `DatabaseBackend.list_agents` 函数？

[Assistant]
`DatabaseBackend.list_agents` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
**参数说明**：


[User] Laddr 的 `RedisCache` 是做什么的？

[Assistant]
`RedisCache` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/cache.py`。
**功能描述**：
Redis-based cache for production. Uses Redis with TTL support.
**函数签名**：
```python
class RedisCache:
```


[User] 在 Laddr 项目中，`_print_management_commands` 有什么功能？

[Assistant]
`_print_management_commands` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/run.py`。
**功能描述**：
Print management command help in minimalistic style.
**函数签名**：
```python
def _print_management_commands() -> None:
```
**返回值**：`None`


[User] 在 Laddr 中，`ServiceNotReadyError.__init__` 方法在哪个文件里？

[Assistant] `ServiceNotReadyError.__init__` 位于 `lib/laddr/src/laddr/cli/utils/errors.py`。


[User] 在 Laddr 中，`_LLMWithDefaults` 类在哪个文件里？

[Assistant] `_LLMWithDefaults` 位于 `lib/laddr/src/laddr/llms.py`。


[User] 请解释 Laddr 中 `DatabaseBackend` 的作用。

[Assistant]
`DatabaseBackend` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Protocol for database backends.
**函数签名**：
```python
class DatabaseBackend(Protocol):
```


[User] 如何在 Laddr 中使用 `Agent.plan` 函数？

[Assistant]
`Agent.plan` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
```python
Agent.plan(task=...)
```
**参数说明**：
- `task`: dict - Task inputs

**功能简述**：Create execution plan for a task. Default implementation: simple single-step plan. Subclasses should override for custom planning logic. Args: task: Task inputs Returns: List of steps, where each step...


[User] 在 Laddr 项目中，`run_local` 有什么功能？

[Assistant]
`run_local` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/main.py`。
**功能描述**：
Run an agent once locally using in-memory components (no Redis/DB).
**函数签名**：
```python
def run_local(agent: str, input_json: str):
```
**参数**：
- `agent` (str)
- `input_json` (str)

**返回值**：`None`


[User] 在 Laddr 中，`infra` 函数在哪个文件里？

[Assistant] `infra` 位于 `lib/laddr/src/laddr/cli/commands/infra.py`。


[User] 请解释 Laddr 中 `Agent._build_autonomous_user_prompt` 的作用。

[Assistant]
`Agent._build_autonomous_user_prompt` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/agent_runtime.py`。
**功能描述**：
Build user prompt with task and history.
**函数签名**：
```python
def _build_autonomous_user_prompt(
self,
task_description: str,
history: list[dict],
iteration: int
```
**参数**：
- `self` (Any)
- `task_description` (str)
- `history` (list[dict])
- `iteration` (int)

**返回值**：`str`


[User] 请解释 Laddr 中 `ProjectNotFoundError` 的作用。

[Assistant]
`ProjectNotFoundError` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/errors.py`。
**功能描述**：
Raised when not in an Laddr project directory.
**函数签名**：
```python
class ProjectNotFoundError(LaddrError):
```


[User] 如何在 Laddr 中使用 `TaskDelegationTool.__init__` 函数？

[Assistant]
`TaskDelegationTool.__init__` 位于 `lib/laddr/src/laddr/core/system_tools.py`，使用方法如下：
```python
TaskDelegationTool.__init__(message_bus=..., artifact_storage=..., agent=...)
```
**参数说明**：
- `message_bus`: Any - Message queue backend for inter-agent communication
- `artifact_storage`: Any
- `agent`: Any

**功能简述**：Initialize task delegation tool. Args: message_bus: Message queue backend for inter-agent communication artifact_storage: Optional storage backend for large payloads agent: Optional agent instance for...


[User] 在 Laddr 项目中，`wait_for_service` 有什么功能？

[Assistant]
`wait_for_service` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/docker.py`。
**功能描述**：
Wait for a service to be healthy. Args: service: Service name timeout: Maximum seconds to wait check_interval: Seconds between checks Returns: True if service is healthy, False otherwise
**函数签名**：
```python
def wait_for_service(
service: str,
timeout: int = 30,
check_interval: int = 2,
) -> bool:
```
**参数**：
- `service` (str): Service name
- `timeout` (int)
- `check_interval` (int)

**返回值**：`bool`


[User] 如何在 Laddr 中使用 `run_agent_cmd` 函数？

[Assistant]
`run_agent_cmd` 位于 `lib/laddr/src/laddr/cli/commands/run.py`，使用方法如下：
```python
run_agent_cmd(agent_name=..., inputs_json=...)
```
**参数说明**：
- `agent_name`: str
- `inputs_json`: str

**功能简述**：Run a single agent locally using AgentRunner....


[User] 如何在 Laddr 中使用 `DatabaseService.create_prompt` 函数？

[Assistant]
`DatabaseService.create_prompt` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.create_prompt(prompt_id=..., prompt_name=..., inputs=...)
```
**参数说明**：
- `prompt_id`: str | None
- `prompt_name`: str
- `inputs`: dict

**功能简述**：Create a new prompt execution record....


[User] 如何在 Laddr 中使用 `InMemoryCache.set` 函数？

[Assistant]
`InMemoryCache.set` 位于 `lib/laddr/src/laddr/core/cache.py`，使用方法如下：
```python
InMemoryCache.set(key=..., value=..., ttl=...)
```
**参数说明**：
- `key`: str
- `value`: Any
- `ttl`: int | None

**功能简述**：Set value in cache with optional TTL (seconds)....


[User] 如何在 Laddr 中使用 `CacheBackend.get` 函数？

[Assistant]
`CacheBackend.get` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
CacheBackend.get(key=...)
```
**参数说明**：
- `key`: str


[User] Laddr 的 `discover_tools` 是做什么的？

[Assistant]
`discover_tools` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/core/tooling.py`。
**功能描述**：
Auto-discover tools for an agent from agents.<agent_name>.tools package. Scans for: 1. Functions decorated with @tool 2. Functions named 'run' (fallback) Args: agent_name: Name of the agent (e.g., "researcher") Returns: ToolRegistry with discovered tools
**函数签名**：
```python
def discover_tools(agent_name: str) -> ToolRegistry:
```
**参数**：
- `agent_name` (str): Name of the agent (e.g., "researcher")

**返回值**：`ToolRegistry`


[User] 在 Laddr 中，`AgentRunner._stop_inline_workers` 方法在哪个文件里？

[Assistant] `AgentRunner._stop_inline_workers` 位于 `lib/laddr/src/laddr/core/runtime_entry.py`。


[User] 如何在 Laddr 中使用 `run_local` 函数？

[Assistant]
`run_local` 位于 `lib/laddr/src/laddr/cli/main.py`，使用方法如下：
```python
run_local(agent=..., input_json=...)
```
**参数说明**：
- `agent`: str
- `input_json`: str

**功能简述**：Run an agent once locally using in-memory components (no Redis/DB)....


[User] 如何在 Laddr 中使用 `InMemoryCache.get` 函数？

[Assistant]
`InMemoryCache.get` 位于 `lib/laddr/src/laddr/core/cache.py`，使用方法如下：
```python
InMemoryCache.get(key=...)
```
**参数说明**：
- `key`: str

**功能简述**：Get value from cache....


[User] 如何在 Laddr 中使用 `print_success` 函数？

[Assistant]
`print_success` 位于 `lib/laddr/src/laddr/cli/utils/logger.py`，使用方法如下：
```python
print_success(message=..., details=...)
```
**参数说明**：
- `message`: str - Main success message
- `details`: str | None

**功能简述**：Print a success message. Args: message: Main success message details: Optional additional details...


[User] Laddr 的 `DatabaseService` 是做什么的？

[Assistant]
`DatabaseService` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
High-level database API. Provides methods for job management, tracing, memory, and agent registry. Supports both Postgres and SQLite.
**函数签名**：
```python
class DatabaseService:
```


[User] Laddr 的 `FileGenerationError` 是做什么的？

[Assistant]
`FileGenerationError` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/errors.py`。
**功能描述**：
Raised when file generation fails.
**函数签名**：
```python
class FileGenerationError(LaddrError):
```


[User] 请解释 Laddr 中 `NestedProjectError` 的作用。

[Assistant]
`NestedProjectError` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/errors.py`。
**功能描述**：
Raised when trying to create a nested project.
**函数签名**：
```python
class NestedProjectError(LaddrError):
```


[User] 在 Laddr 中，`_create_tool_file` 函数在哪个文件里？

[Assistant] `_create_tool_file` 位于 `lib/laddr/src/laddr/cli/commands/add.py`。


[User] Laddr 的 `InMemoryCache.get` 是做什么的？

[Assistant]
`InMemoryCache.get` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/cache.py`。
**功能描述**：
Get value from cache.
**函数签名**：
```python
def get(self, key: str) -> Any:
```
**参数**：
- `self` (Any)
- `key` (str)

**返回值**：`Any`


[User] 在 Laddr 项目中，`add_worker_to_compose` 有什么功能？

[Assistant]
`add_worker_to_compose` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/docker.py`。
**功能描述**：
Add worker service to docker-compose.yml. Args: project_path: Path to project root agent_name: Name of the agent
**函数签名**：
```python
def add_worker_to_compose(project_path: Path, agent_name: str) -> None:
```
**参数**：
- `project_path` (Path): Path to project root
- `agent_name` (str)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `InMemoryStorage.__init__` 函数？

[Assistant]
`InMemoryStorage.__init__` 位于 `lib/laddr/src/laddr/core/storage.py`，使用方法如下：
**参数说明**：

**功能简述**：Initialize in-memory storage....


[User] 在 Laddr 中，`HTTPLLM.__init__` 方法在哪个文件里？

[Assistant] `HTTPLLM.__init__` 位于 `lib/laddr/src/laddr/core/llm.py`。


[User] Laddr 的 `LaddrConfig` 是做什么的？

[Assistant]
`LaddrConfig` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Environment-based configuration for Laddr runtime. Supports pluggable backends for all infrastructure: - queue_backend: "redis" (default) | "memory" - db_backend: "postgres" (default) | "sqlite" - llm_backend: "noop" (default) | "openai" | "anthropic" | "gemini" - cache_backend: "inmemory" (default) | "redis"
**函数签名**：
```python
class LaddrConfig(BaseSettings):
```


[User] 在 Laddr 中，`print_header` 函数在哪个文件里？

[Assistant] `print_header` 位于 `lib/laddr/src/laddr/cli/utils/logger.py`。


[User] 请解释 Laddr 中 `MCPToolRegistry` 的作用。

[Assistant]
`MCPToolRegistry` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/mcp_client.py`。
**功能描述**：
Placeholder - MCP feature disabled for this release.
**函数签名**：
```python
class MCPToolRegistry:
```


[User] 如何在 Laddr 中使用 `TaskMessage.from_dict` 函数？

[Assistant]
`TaskMessage.from_dict` 位于 `lib/laddr/src/laddr/core/message_bus.py`，使用方法如下：
```python
TaskMessage.from_dict(cls=..., data=...)
```
**参数说明**：
- `cls`: Any
- `data`: dict


[User] 在 Laddr 中，`compose_ps` 函数在哪个文件里？

[Assistant] `compose_ps` 位于 `lib/laddr/src/laddr/cli/utils/docker.py`。


[User] 如何在 Laddr 中使用 `get_logger` 函数？

[Assistant]
`get_logger` 位于 `lib/laddr/src/laddr/cli/utils/logger.py`，使用方法如下：
```python
get_logger(name=..., level=...)
```
**参数说明**：
- `name`: str - Logger name (usually __name__)
- `level`: int

**功能简述**：Get a configured logger with rich handler. Args: name: Logger name (usually __name__) level: Log level (default: INFO) Returns: Configured logger instance...


[User] 如何在 Laddr 中使用 `Agent._format_history_for_synthesis` 函数？

[Assistant]
`Agent._format_history_for_synthesis` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
```python
Agent._format_history_for_synthesis(history=...)
```
**参数说明**：
- `history`: list[dict]

**功能简述**：Format execution history for final answer synthesis....


[User] 如何在 Laddr 中使用 `RedisBus.__init__` 函数？

[Assistant]
`RedisBus.__init__` 位于 `lib/laddr/src/laddr/core/message_bus.py`，使用方法如下：
```python
RedisBus.__init__(redis_url=...)
```
**参数说明**：
- `redis_url`: str


[User] 请解释 Laddr 中 `ReplayJobRequest` 的作用。

[Assistant]
`ReplayJobRequest` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/api/main.py`。
**功能描述**：
Request to replay a job.
**函数签名**：
```python
class ReplayJobRequest(BaseModel):
```


[User] 如何在 Laddr 中使用 `ToolRegistry.has` 函数？

[Assistant]
`ToolRegistry.has` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
```python
ToolRegistry.has(name=...)
```
**参数说明**：
- `name`: str

**功能简述**：Check if a tool exists (checks both canonical names and aliases)....


[User] 在 Laddr 中，`scale` 函数在哪个文件里？

[Assistant] `scale` 位于 `lib/laddr/src/laddr/cli/commands/management.py`。


[User] 请解释 Laddr 中 `KafkaBus` 的作用。

[Assistant]
`KafkaBus` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/message_bus.py`。
**功能描述**：
Kafka-based message bus (experimental / enterprise option). Uses topics per agent: laddr.tasks.<agent_name> Responses published to: laddr.responses Agent registry is memory-only in this minimal implementation.
**函数签名**：
```python
class KafkaBus:
```


[User] 如何在 Laddr 中使用 `DatabaseService.update_prompt_status` 函数？

[Assistant]
`DatabaseService.update_prompt_status` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.update_prompt_status(prompt_id=..., status=...)
```
**参数说明**：
- `prompt_id`: str
- `status`: str

**功能简述**：Update prompt execution status only; set completed_at for terminal states....


[User] 请解释 Laddr 中 `DatabaseService.get_result` 的作用。

[Assistant]
`DatabaseService.get_result` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Get job result.
**函数签名**：
```python
def get_result(self, job_id: str) -> dict | None:
```
**参数**：
- `self` (Any)
- `job_id` (str)

**返回值**：`dict | None`


[User] Laddr 的 `add_agent` 是做什么的？

[Assistant]
`add_agent` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/add.py`。
**功能描述**：
Add a new agent to the project. Examples: laddr add agent summarizer laddr add agent analyst --role "Data Analyst" --goal "Analyze data"
**函数签名**：
```python
def add_agent(
agent_name: str,
role: str | None,
goal: str | None,
backstory: str | None,
```
**参数**：
- `agent_name` (str)
- `role` (str | None)
- `goal` (str | None)
- `backstory` (str | None)
- `llm_provider` (str)

**返回值**：`None`


[User] 在 Laddr 项目中，`grok` 有什么功能？

[Assistant]
`grok` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/llms.py`。
**功能描述**：
Create a xAI Grok LLM backend instance. Args: model: Model name (default: grok-beta) temperature: Generation temperature Example: llm = grok(model="grok-beta", temperature=0.7)
**函数签名**：
```python
def grok(model: str | None = None, temperature: float | None = None) -> _LLMWithDefaults:
```
**参数**：
- `model` (str | None): Model name (default: grok-beta)
- `temperature` (float | None)

**返回值**：`_LLMWithDefaults`


[User] 请解释 Laddr 中 `add_tool` 的作用。

[Assistant]
`add_tool` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/add.py`。
**功能描述**：
Add a new tool to an agent. Examples: laddr add tool calculator laddr add tool scraper --agent researcher
**函数签名**：
```python
def add_tool(
tool_name: str,
agent: str | None,
description: str | None,
):
```
**参数**：
- `tool_name` (str)
- `agent` (str | None)
- `description` (str | None)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `DatabaseBackend.memory_put` 函数？

[Assistant]
`DatabaseBackend.memory_put` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
DatabaseBackend.memory_put(agent_name=..., key=..., value=..., job_id=...)
```
**参数说明**：
- `agent_name`: str
- `key`: str
- `value`: Any
- `job_id`: str | None


[User] 在 Laddr 中，`S3Storage.__init__` 方法在哪个文件里？

[Assistant] `S3Storage.__init__` 位于 `lib/laddr/src/laddr/core/storage.py`。


[User] 在 Laddr 项目中，`TemplateRenderer._snake_case` 有什么功能？

[Assistant]
`TemplateRenderer._snake_case` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/cli/utils/templates.py`。
**功能描述**：
Convert string to snake_case.
**函数签名**：
```python
def _snake_case(value: str) -> str:
```
**参数**：
- `value` (str)

**返回值**：`str`


[User] 如何在 Laddr 中使用 `InMemoryCache.clear` 函数？

[Assistant]
`InMemoryCache.clear` 位于 `lib/laddr/src/laddr/core/cache.py`，使用方法如下：
**参数说明**：

**功能简述**：Clear all cache entries....


[User] 请解释 Laddr 中 `replay_job` 的作用。

[Assistant]
`replay_job` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/run.py`。
**功能描述**：
Replay a previous job by job ID. Examples: laddr run replay abc123-456-def laddr run replay abc123-456-def --reexecute
**函数签名**：
```python
def replay_job(job_id: str, reexecute: bool):
```
**参数**：
- `job_id` (str)
- `reexecute` (bool)

**返回值**：`None`


[User] Laddr 的 `Agent._build_autonomous_system_prompt` 是做什么的？

[Assistant]
`Agent._build_autonomous_system_prompt` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/agent_runtime.py`。
**功能描述**：
Build system prompt for autonomous agent.
**函数签名**：
```python
def _build_autonomous_system_prompt(
self,
available_tools: list[str],
available_agents: list[dict],
can_delegate: bool,
```
**参数**：
- `self` (Any)
- `available_tools` (list[str])
- `available_agents` (list[dict])
- `can_delegate` (bool)

**返回值**：`str`


[User] 如何在 Laddr 中使用 `GeminiLLM.__init__` 函数？

[Assistant]
`GeminiLLM.__init__` 位于 `lib/laddr/src/laddr/core/llm.py`，使用方法如下：
```python
GeminiLLM.__init__(api_key=..., model=...)
```
**参数说明**：
- `api_key`: str | None
- `model`: str | None


[User] Laddr 的 `write_file` 是做什么的？

[Assistant]
`write_file` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/templates.py`。
**功能描述**：
Write content to a file. Args: path: File path content: File content create_dirs: Create parent directories if needed (default: True) Raises: FileGenerationError: If write fails
**函数签名**：
```python
def write_file(path: Path, content: str, create_dirs: bool = True) -> None:
```
**参数**：
- `path` (Path): File path
- `content` (str)
- `create_dirs` (bool)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `BackendFactory.create_storage_backend` 函数？

[Assistant]
`BackendFactory.create_storage_backend` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
**参数说明**：

**功能简述**：Create S3-compatible storage backend (AWS S3, MinIO, or compatible). Supports backward compatibility with old minio_* field names....


[User] 在 Laddr 项目中，`TemplateRenderer.render_to_file` 有什么功能？

[Assistant]
`TemplateRenderer.render_to_file` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/cli/utils/templates.py`。
**功能描述**：
Render a template and write to file. Args: template_name: Template filename output_path: Output file path context: Template context variables create_dirs: Create parent directories if needed (default: True) Raises: FileGenerationError: If rendering or writing fails
**函数签名**：
```python
def render_to_file(
self,
template_name: str,
output_path: Path,
context: dict[str, Any],
```
**参数**：
- `self` (Any)
- `template_name` (str): Template filename
- `output_path` (Path)
- `context` (dict[str, Any])
- `create_dirs` (bool)

**返回值**：`None`


[User] 请解释 Laddr 中 `_generate_docker_setup` 的作用。

[Assistant]
`_generate_docker_setup` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/init.py`。
**功能描述**：
Generate Docker configuration.
**函数签名**：
```python
def _generate_docker_setup(project_path: Path) -> None:
```
**参数**：
- `project_path` (Path)

**返回值**：`None`


[User] 请解释 Laddr 中 `RedisBus` 的作用。

[Assistant]
`RedisBus` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/message_bus.py`。
**功能描述**：
Redis-based message bus for production use. Uses Redis Streams for task queues and pub/sub for responses. Agents are registered in a hash with metadata and heartbeats.
**函数签名**：
```python
class RedisBus:
```


[User] 在 Laddr 项目中，`check_docker` 有什么功能？

[Assistant]
`check_docker` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/docker.py`。
**功能描述**：
Check if Docker is installed and running. Returns: True if Docker is available Raises: DockerNotFoundError: If Docker is not found or not running
**函数签名**：
```python
def check_docker() -> bool:
```
**返回值**：`bool`


[User] 在 Laddr 中，`MCPToolRegistry.__init__` 方法在哪个文件里？

[Assistant] `MCPToolRegistry.__init__` 位于 `lib/laddr/src/laddr/core/mcp_client.py`。


[User] 在 Laddr 项目中，`InMemoryCache.set` 有什么功能？

[Assistant]
`InMemoryCache.set` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/cache.py`。
**功能描述**：
Set value in cache with optional TTL (seconds).
**函数签名**：
```python
def set(self, key: str, value: Any, ttl: int | None = None) -> None:
```
**参数**：
- `self` (Any)
- `key` (str)
- `value` (Any)
- `ttl` (int | None)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `DatabaseService.list_jobs` 函数？

[Assistant]
`DatabaseService.list_jobs` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.list_jobs(limit=...)
```
**参数说明**：
- `limit`: int

**功能简述**：List recent jobs....


[User] 如何在 Laddr 中使用 `CacheBackend.delete` 函数？

[Assistant]
`CacheBackend.delete` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
CacheBackend.delete(key=...)
```
**参数说明**：
- `key`: str


[User] 在 Laddr 项目中，`compose_down` 有什么功能？

[Assistant]
`compose_down` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/docker.py`。
**功能描述**：
Stop Docker Compose services. Args: remove_volumes: Remove named volumes (default: False) Raises: DockerComposeError: If compose down fails
**函数签名**：
```python
def compose_down(remove_volumes: bool = False) -> None:
```
**参数**：
- `remove_volumes` (bool): Remove named volumes (default: False)

**返回值**：`None`


[User] 在 Laddr 项目中，`compose_ps` 有什么功能？

[Assistant]
`compose_ps` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/docker.py`。
**功能描述**：
Get status of Docker Compose services. Args: services: Optional list of specific services to check Returns: Status output as string Raises: DockerComposeError: If compose ps fails
**函数签名**：
```python
def compose_ps(services: list[str] | None = None) -> str:
```
**参数**：
- `services` (list[str] | None): Optional list of specific services to check

**返回值**：`str`


[User] Laddr 的 `BackendFactory.create_database_backend` 是做什么的？

[Assistant]
`BackendFactory.create_database_backend` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Create database backend based on config.
**函数签名**：
```python
def create_database_backend(self) -> DatabaseBackend:
```
**参数**：
- `self` (Any)

**返回值**：`DatabaseBackend`


[User] 如何在 Laddr 中使用 `DatabaseService.save_prompt_result` 函数？

[Assistant]
`DatabaseService.save_prompt_result` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.save_prompt_result(prompt_id=..., outputs=..., status=...)
```
**参数说明**：
- `prompt_id`: str
- `outputs`: dict
- `status`: str

**功能简述**：Save prompt execution result....


[User] 在 Laddr 中，`MemoryBus.__init__` 方法在哪个文件里？

[Assistant] `MemoryBus.__init__` 位于 `lib/laddr/src/laddr/core/message_bus.py`。


[User] 如何在 Laddr 中使用 `logs` 函数？

[Assistant]
`logs` 位于 `lib/laddr/src/laddr/cli/commands/management.py`，使用方法如下：
```python
logs(agent_name=..., follow=..., tail=...)
```
**参数说明**：
- `agent_name`: str
- `follow`: bool
- `tail`: int | None

**功能简述**：View logs for an agent worker. Examples: laddr logs researcher laddr logs researcher --follow laddr logs researcher --tail 100...


[User] Laddr 的 `TemplateRenderer.render_string` 是做什么的？

[Assistant]
`TemplateRenderer.render_string` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/cli/utils/templates.py`。
**功能描述**：
Render a template string with context. Args: template_str: Template string context: Template context variables Returns: Rendered content Raises: FileGenerationError: If rendering fails
**函数签名**：
```python
def render_string(self, template_str: str, context: dict[str, Any]) -> str:
```
**参数**：
- `self` (Any)
- `template_str` (str): Template string
- `context` (dict[str, Any])

**返回值**：`str`


[User] Laddr 的 `AgentRunner._start_inline_workers` 是做什么的？

[Assistant]
`AgentRunner._start_inline_workers` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/runtime_entry.py`。
**功能描述**：
Start a background task that consumes tasks and runs target agents inline.
**函数签名**：
```python
def _start_inline_workers(self, agent_names: list[str]) -> None:
```
**参数**：
- `self` (Any)
- `agent_names` (list[str])

**返回值**：`None`


[User] 如何在 Laddr 中使用 `run_pipeline` 函数？

[Assistant]
`run_pipeline` 位于 `lib/laddr/src/laddr/cli/commands/run.py`，使用方法如下：
```python
run_pipeline(pipeline_file=...)
```
**参数说明**：
- `pipeline_file`: str

**功能简述**：Run a pipeline defined in a YAML file....


[User] 请解释 Laddr 中 `SubmitJobRequest` 的作用。

[Assistant]
`SubmitJobRequest` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/api/main.py`。
**功能描述**：
Request to submit a new job (legacy).
**函数签名**：
```python
class SubmitJobRequest(BaseModel):
```


[User] 在 Laddr 中，`ParallelDelegationTool.split_document` 方法在哪个文件里？

[Assistant] `ParallelDelegationTool.split_document` 位于 `lib/laddr/src/laddr/core/system_tools.py`。


[User] 请解释 Laddr 中 `DatabaseService.list_traces` 的作用。

[Assistant]
`DatabaseService.list_traces` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
List recent traces, optionally filtered by agent.
**函数签名**：
```python
def list_traces(self, agent: str | None = None, limit: int = 100) -> list[dict]:
```
**参数**：
- `self` (Any)
- `agent` (str | None)
- `limit` (int)

**返回值**：`list[dict]`


[User] 在 Laddr 项目中，`EventThrottler.add` 有什么功能？

[Assistant]
`EventThrottler.add` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/api/main.py`。
**功能描述**：
Add event, return it if should be sent immediately.
**函数签名**：
```python
def add(self, event: dict) -> dict | None:
```
**参数**：
- `self` (Any)
- `event` (dict)

**返回值**：`dict | None`


[User] 在 Laddr 中，`_create_directories` 函数在哪个文件里？

[Assistant] `_create_directories` 位于 `lib/laddr/src/laddr/cli/commands/init.py`。


[User] 如何在 Laddr 中使用 `Agent.__init__` 函数？

[Assistant]
`Agent.__init__` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
```python
Agent.__init__(config=..., env_config=..., tools=...)
```
**参数说明**：
- `config`: AgentConfig - Agent-specific configuration
- `env_config`: LaddrConfig | None
- `tools`: ToolRegistry | list[Any] | None

**功能简述**：Initialize agent. Args: config: Agent-specific configuration env_config: Environment configuration (loaded if None) tools: Tool registry (auto-discovered if None)...


[User] 如何在 Laddr 中使用 `Agent._build_autonomous_user_prompt` 函数？

[Assistant]
`Agent._build_autonomous_user_prompt` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
```python
Agent._build_autonomous_user_prompt(task_description=..., history=..., iteration=...)
```
**参数说明**：
- `task_description`: str
- `history`: list[dict]
- `iteration`: int

**功能简述**：Build user prompt with task and history....


[User] 在 Laddr 中，`TaskMessage.from_dict` 方法在哪个文件里？

[Assistant] `TaskMessage.from_dict` 位于 `lib/laddr/src/laddr/core/message_bus.py`。


[User] 请解释 Laddr 中 `ParallelDelegationTool` 的作用。

[Assistant]
`ParallelDelegationTool` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/system_tools.py`。
**功能描述**：
Tool for delegating multiple tasks in parallel (sharding/fan-out pattern).
**函数签名**：
```python
class ParallelDelegationTool:
```


[User] 如何在 Laddr 中使用 `DatabaseService.get_metrics` 函数？

[Assistant]
`DatabaseService.get_metrics` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
**参数说明**：

**功能简述**：Get aggregated metrics....


[User] 如何在 Laddr 中使用 `TemplateRenderer.__init__` 函数？

[Assistant]
`TemplateRenderer.__init__` 位于 `lib/laddr/src/laddr/cli/utils/templates.py`，使用方法如下：
```python
TemplateRenderer.__init__(templates_dir=...)
```
**参数说明**：
- `templates_dir`: Path - Directory containing Jinja2 templates

**功能简述**：Initialize template renderer. Args: templates_dir: Directory containing Jinja2 templates...


[User] Laddr 的 `DatabaseService.append_trace` 是做什么的？

[Assistant]
`DatabaseService.append_trace` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Append a trace event.
**函数签名**：
```python
def append_trace(self, job_id: str, agent_name: str, event_type: str, payload: dict) -> None:
```
**参数**：
- `self` (Any)
- `job_id` (str)
- `agent_name` (str)
- `event_type` (str)
- `payload` (dict)

**返回值**：`None`


[User] 在 Laddr 项目中，`AgentConfig` 有什么功能？

[Assistant]
`AgentConfig` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Agent configuration (minimal for @actor pattern). Most runtime config is auto-discovered or comes from LaddrConfig.
**函数签名**：
```python
class AgentConfig(BaseModel):
```


[User] Laddr 的 `PipelineConfig` 是做什么的？

[Assistant]
`PipelineConfig` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Pipeline configuration for sequential agent execution.
**函数签名**：
```python
class PipelineConfig(BaseModel):
```


[User] 在 Laddr 中，`WorkerRunner.__init__` 方法在哪个文件里？

[Assistant] `WorkerRunner.__init__` 位于 `lib/laddr/src/laddr/core/runtime_entry.py`。


[User] 如何在 Laddr 中使用 `check` 函数？

[Assistant]
`check` 位于 `lib/laddr/src/laddr/cli/commands/check.py`，使用方法如下：
```python
check(output_path=...)
```
**参数说明**：
- `output_path`: str

**功能简述**：Run diagnostic checks for the Laddr runtime using the DiagnosticAgent....


[User] 在 Laddr 中，`cli` 函数在哪个文件里？

[Assistant] `cli` 位于 `lib/laddr/src/laddr/cli/main.py`。


[User] 如何在 Laddr 中使用 `DatabaseService.__init__` 函数？

[Assistant]
`DatabaseService.__init__` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.__init__(database_url=...)
```
**参数说明**：
- `database_url`: str - SQLAlchemy connection string

**功能简述**：Initialize database service. Args: database_url: SQLAlchemy connection string e.g., "postgresql://user:pass@host:5432/db" or "sqlite:///./laddr.db" for local dev...


[User] 在 Laddr 项目中，`SubmitPromptRequest` 有什么功能？

[Assistant]
`SubmitPromptRequest` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/api/main.py`。
**功能描述**：
Request to submit a new prompt execution.
**函数签名**：
```python
class SubmitPromptRequest(BaseModel):
```


[User] 如何在 Laddr 中使用 `ToolRegistry.list_all_names` 函数？

[Assistant]
`ToolRegistry.list_all_names` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
**参数说明**：

**功能简述**：List all names including aliases (for debugging)....


[User] 在 Laddr 项目中，`ParallelDelegationTool.split_document` 有什么功能？

[Assistant]
`ParallelDelegationTool.split_document` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/system_tools.py`。
**功能描述**：
Split a large document into smaller chunks for parallel processing. Use this before calling delegate_parallel to divide large documents into manageable sections that can be processed by multiple workers. Parameters: - document: The document text to split - num_chunks: Number of chunks to split into (e.g., 3 for 3 workers) - overlap: Number of characters to overlap between chunks (for context continuity) Returns: - chunks: List of document chunks - metadata: Information about the split (lengths, chunk count, etc.)
**函数签名**：
```python
def split_document(
self,
document: str,
num_chunks: int = 3,
overlap: int = 0
```
**参数**：
- `self` (Any)
- `document` (str): The document text to split
- `num_chunks` (int)
- `overlap` (int)

**返回值**：`dict`


[User] 如何在 Laddr 中使用 `CacheBackend.clear` 函数？

[Assistant]
`CacheBackend.clear` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
**参数说明**：


[User] 在 Laddr 项目中，`DockerComposeError` 有什么功能？

[Assistant]
`DockerComposeError` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/errors.py`。
**功能描述**：
Raised when Docker Compose operations fail.
**函数签名**：
```python
class DockerComposeError(LaddrError):
```


[User] 请解释 Laddr 中 `InvalidInputError` 的作用。

[Assistant]
`InvalidInputError` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/errors.py`。
**功能描述**：
Raised when user input is invalid.
**函数签名**：
```python
class InvalidInputError(LaddrError):
```


[User] 在 Laddr 项目中，`DatabaseService.save_result` 有什么功能？

[Assistant]
`DatabaseService.save_result` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Save job result.
**函数签名**：
```python
def save_result(self, job_id: str, outputs: dict, status: str = "completed") -> None:
```
**参数**：
- `self` (Any)
- `job_id` (str)
- `outputs` (dict)
- `status` (str)

**返回值**：`None`


[User] Laddr 的 `get_logger` 是做什么的？

[Assistant]
`get_logger` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/logger.py`。
**功能描述**：
Get a configured logger with rich handler. Args: name: Logger name (usually __name__) level: Log level (default: INFO) Returns: Configured logger instance
**函数签名**：
```python
def get_logger(name: str, level: int = logging.INFO) -> logging.Logger:
```
**参数**：
- `name` (str): Logger name (usually __name__)
- `level` (int)

**返回值**：`logging.Logger`


[User] 如何在 Laddr 中使用 `AgentRunner._stop_inline_workers` 函数？

[Assistant]
`AgentRunner._stop_inline_workers` 位于 `lib/laddr/src/laddr/core/runtime_entry.py`，使用方法如下：
**参数说明**：


[User] 在 Laddr 项目中，`AgentMemory.put` 有什么功能？

[Assistant]
`AgentMemory.put` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/agent_runtime.py`。
**功能描述**：
Store a memory entry.
**函数签名**：
```python
def put(self, key: str, value: Any) -> None:
```
**参数**：
- `self` (Any)
- `key` (str)
- `value` (Any)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `DatabaseService.memory_list` 函数？

[Assistant]
`DatabaseService.memory_list` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.memory_list(agent_name=..., job_id=...)
```
**参数说明**：
- `agent_name`: str
- `job_id`: str | None

**功能简述**：List all memory entries for an agent....


[User] 请解释 Laddr 中 `DatabaseService.memory_list` 的作用。

[Assistant]
`DatabaseService.memory_list` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
List all memory entries for an agent.
**函数签名**：
```python
def memory_list(self, agent_name: str, job_id: str | None = None) -> dict[str, Any]:
```
**参数**：
- `self` (Any)
- `agent_name` (str)
- `job_id` (str | None)

**返回值**：`dict[str, Any]`


[User] 在 Laddr 中，`check` 函数在哪个文件里？

[Assistant] `check` 位于 `lib/laddr/src/laddr/cli/commands/check.py`。


[User] 请解释 Laddr 中 `S3Storage.__init__` 的作用。

[Assistant]
`S3Storage.__init__` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/storage.py`。
**功能描述**：
Initialize S3-compatible storage. Args: endpoint: S3 endpoint (e.g., "s3.amazonaws.com" or "minio:9000") access_key: Access key (AWS Access Key ID or MinIO access key) secret_key: Secret key (AWS Secret Access Key or MinIO secret key) secure: Use HTTPS (True for AWS S3, False for local MinIO) region: AWS region (optional, e.g., "us-east-1")
**函数签名**：
```python
def __init__(
self,
endpoint: str,
access_key: str,
secret_key: str,
```
**参数**：
- `self` (Any)
- `endpoint` (str): S3 endpoint (e.g., "s3.amazonaws.com" or "minio:9000")
- `access_key` (str)
- `secret_key` (str)
- `secure` (bool)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `Agent._discover_tool_overrides` 函数？

[Assistant]
`Agent._discover_tool_overrides` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
**参数说明**：

**功能简述**：Auto-discover and load tool override modules from the project. Searches common locations for tool override files: - ./tools/overrides/ - ./custom_tools/ - ./agent_tools/overrides/ When override module...


[User] Laddr 的项目结构是怎样的？

[Assistant]
Laddr 项目包含以下主要部分：

**核心模块**：
- `core` (核心逻辑，如Agent Runtime, Tooling, Config)
- `cli` (命令行接口)
- `llms` (LLM后端实现)

**主要文件类型统计**：MD: 15, TOML: 2, YML: 1, TXT: 1, SH: 3, LOCK: 1, PNG: 1, SVG: 4, EXAMPLE: 1, HTML: 1, CONF: 1, JSON: 4, JS: 2, TS: 15, PROD: 1, TEMPLATE: 1, TSX: 15, CSS: 2, PY: 32, J2: 10


[User] Laddr 的 `DatabaseService.list_prompts` 是做什么的？

[Assistant]
`DatabaseService.list_prompts` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
List recent prompt executions.
**函数签名**：
```python
def list_prompts(self, limit: int = 50) -> list[dict]:
```
**参数**：
- `self` (Any)
- `limit` (int)

**返回值**：`list[dict]`


[User] 请解释 Laddr 中 `InvalidConfigError` 的作用。

[Assistant]
`InvalidConfigError` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/errors.py`。
**功能描述**：
Raised when configuration files are invalid.
**函数签名**：
```python
class InvalidConfigError(LaddrError):
```


[User] 在 Laddr 项目中，`override_system_tool` 有什么功能？

[Assistant]
`override_system_tool` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/core/system_tools.py`。
**功能描述**：
Decorator to override a system tool with a custom implementation. Use this decorator to replace built-in system tools (like system_delegate_parallel, system_split_document, etc.) with your own implementations. Example: from laddr.core.system_tools import override_system_tool @override_system_tool("system_delegate_parallel") async def my_custom_parallel_delegation(agent_name: str, tasks: list[str], **kwargs): # Your custom implementation print(f"Custom parallel delegation: {len(tasks)} tasks to {agent_name}") return {"status": "success", "results": [...]} Args: tool_name: Name of the system tool to override (e.g., "system_delegate_parallel") Returns: Decorator function that registers the override
**函数签名**：
```python
def override_system_tool(tool_name: str):
```
**参数**：
- `tool_name` (str): Name of the system tool to override (e.g., "system_delegate_parallel")

**返回值**：`None`


[User] 如何在 Laddr 中使用 `OpenAILLM.__init__` 函数？

[Assistant]
`OpenAILLM.__init__` 位于 `lib/laddr/src/laddr/core/llm.py`，使用方法如下：
```python
OpenAILLM.__init__(api_key=..., model=..., base_url=...)
```
**参数说明**：
- `api_key`: str | None
- `model`: str | None
- `base_url`: str | None


[User] 请解释 Laddr 中 `logs` 的作用。

[Assistant]
`logs` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/management.py`。
**功能描述**：
View logs for an agent worker. Examples: laddr logs researcher laddr logs researcher --follow laddr logs researcher --tail 100
**函数签名**：
```python
def logs(agent_name: str, follow: bool, tail: int | None):
```
**参数**：
- `agent_name` (str)
- `follow` (bool)
- `tail` (int | None)

**返回值**：`None`


[User] 在 Laddr 中，`ArtifactStorageTool.__init__` 方法在哪个文件里？

[Assistant] `ArtifactStorageTool.__init__` 位于 `lib/laddr/src/laddr/core/system_tools.py`。


[User] 在 Laddr 项目中，`print_error` 有什么功能？

[Assistant]
`print_error` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/logger.py`。
**功能描述**：
Print an error message. Args: message: Error message hint: Optional hint for resolution
**函数签名**：
```python
def print_error(message: str, hint: str | None = None) -> None:
```
**参数**：
- `message` (str): Error message
- `hint` (str | None)

**返回值**：`None`


[User] Laddr 的 `BackendFactory.create_storage_backend` 是做什么的？

[Assistant]
`BackendFactory.create_storage_backend` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Create S3-compatible storage backend (AWS S3, MinIO, or compatible). Supports backward compatibility with old minio_* field names.
**函数签名**：
```python
def create_storage_backend(self):
```
**参数**：
- `self` (Any)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `AgentRunner._start_inline_workers` 函数？

[Assistant]
`AgentRunner._start_inline_workers` 位于 `lib/laddr/src/laddr/core/runtime_entry.py`，使用方法如下：
```python
AgentRunner._start_inline_workers(agent_names=...)
```
**参数说明**：
- `agent_names`: list[str]

**功能简述**：Start a background task that consumes tasks and runs target agents inline....


[User] 如何在 Laddr 中使用 `DatabaseService.memory_get` 函数？

[Assistant]
`DatabaseService.memory_get` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.memory_get(agent_name=..., key=..., job_id=...)
```
**参数说明**：
- `agent_name`: str
- `key`: str
- `job_id`: str | None

**功能简述**：Retrieve a memory entry....


[User] Laddr 的 `scale` 是做什么的？

[Assistant]
`scale` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/management.py`。
**功能描述**：
Scale an agent worker to N replicas. Examples: laddr scale researcher 3 laddr scale summarizer 0  # Stop all replicas
**函数签名**：
```python
def scale(agent_name: str, replicas: int):
```
**参数**：
- `agent_name` (str)
- `replicas` (int)

**返回值**：`None`


[User] 请解释 Laddr 中 `BackendFactory.create_cache_backend` 的作用。

[Assistant]
`BackendFactory.create_cache_backend` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Create cache backend based on config.
**函数签名**：
```python
def create_cache_backend(self) -> CacheBackend:
```
**参数**：
- `self` (Any)

**返回值**：`CacheBackend`


[User] 如何在 Laddr 中使用 `AgentMemory.get` 函数？

[Assistant]
`AgentMemory.get` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
```python
AgentMemory.get(key=...)
```
**参数说明**：
- `key`: str

**功能简述**：Retrieve a memory entry....


[User] 如何在 Laddr 中使用 `ProjectConfigSchema.save_to_file` 函数？

[Assistant]
`ProjectConfigSchema.save_to_file` 位于 `lib/laddr/src/laddr/cli/utils/config.py`，使用方法如下：
```python
ProjectConfigSchema.save_to_file(path=...)
```
**参数说明**：
- `path`: Path - Path to laddr.yml

**功能简述**：Save project config to YAML file. Args: path: Path to laddr.yml Raises: InvalidConfigError: If save fails...


[User] 请解释 Laddr 中 `create_system_tools` 的作用。

[Assistant]
`create_system_tools` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/core/system_tools.py`。
**功能描述**：
Create system tools for task delegation and artifact management. This function checks for user-provided overrides before registering the default implementations. Users can use @override_system_tool decorator to replace any system tool OR create entirely new system tools. Args: message_bus: Message queue backend storage_backend: Optional storage backend (MinIO/S3) agent: Optional agent instance for accessing current_job_id context Returns: Dict mapping tool names to (tool_function, aliases) tuples
**函数签名**：
```python
def create_system_tools(message_bus, storage_backend=None, agent=None) -> dict[str, tuple[Any, list[str]]]:
```
**参数**：
- `message_bus` (Any): Message queue backend
- `storage_backend` (Any)
- `agent` (Any)

**返回值**：`dict[str, tuple[Any, list[str]]]`


[User] 如何在 Laddr 中使用 `BackendFactory.create_llm_backend` 函数？

[Assistant]
`BackendFactory.create_llm_backend` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
BackendFactory.create_llm_backend(override=..., model_override=..., agent_name=...)
```
**参数说明**：
- `override`: str | None
- `model_override`: str | None
- `agent_name`: str | None

**功能简述**：Create LLM backend based on config. If `override` is provided it takes precedence over the global `LaddrConfig.llm_backend`. `model_override` can be provided to select a different model for an agent....


[User] 如何在 Laddr 中使用 `DatabaseBackend.list_jobs` 函数？

[Assistant]
`DatabaseBackend.list_jobs` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
DatabaseBackend.list_jobs(limit=...)
```
**参数说明**：
- `limit`: int


[User] 在 Laddr 中，`validate_project_directory` 函数在哪个文件里？

[Assistant] `validate_project_directory` 位于 `lib/laddr/src/laddr/cli/utils/config.py`。


[User] 在 Laddr 项目中，`DatabaseService.create_job` 有什么功能？

[Assistant]
`DatabaseService.create_job` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Create a new job record, or reuse existing if job_id already exists (for sequential chains).
**函数签名**：
```python
def create_job(self, job_id: str | None, pipeline: str, inputs: dict) -> str:
```
**参数**：
- `self` (Any)
- `job_id` (str | None)
- `pipeline` (str)
- `inputs` (dict)

**返回值**：`str`


[User] 如何在 Laddr 中使用 `Agent._parse_autonomous_action` 函数？

[Assistant]
`Agent._parse_autonomous_action` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
```python
Agent._parse_autonomous_action(response=...)
```
**参数说明**：
- `response`: str

**功能简述**：Parse LLM response to extract action, preferring JSON format with text fallback....


[User] Laddr 的 `DatabaseService.list_agents` 是做什么的？

[Assistant]
`DatabaseService.list_agents` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
List all registered agents with trace counts and last execution time.
**函数签名**：
```python
def list_agents(self) -> list[dict]:
```
**参数**：
- `self` (Any)

**返回值**：`list[dict]`


[User] 在 Laddr 中，`run_agent_cmd` 函数在哪个文件里？

[Assistant] `run_agent_cmd` 位于 `lib/laddr/src/laddr/cli/commands/run.py`。


[User] 在 Laddr 中，`DatabaseService.get_trace` 方法在哪个文件里？

[Assistant] `DatabaseService.get_trace` 位于 `lib/laddr/src/laddr/core/database.py`。


[User] 在 Laddr 项目中，`ArtifactStorageTool` 有什么功能？

[Assistant]
`ArtifactStorageTool` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/system_tools.py`。
**功能描述**：
Tool for storing and retrieving large data artifacts. Backward-compatible retrieval: - Old style: by artifact_id and artifact_type (stored under default artifact bucket) - New style: by bucket+key (e.g., offloaded response pointers)
**函数签名**：
```python
class ArtifactStorageTool:
```


[User] Laddr 的 `NoOpLLM` 是做什么的？

[Assistant]
`NoOpLLM` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/llm.py`。
**功能描述**：
No-op LLM backend that echoes prompts. Useful for testing and local dev without API keys.
**函数签名**：
```python
class NoOpLLM:
```


[User] 请解释 Laddr 中 `_LLMWithDefaults` 的作用。

[Assistant]
`_LLMWithDefaults` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/llms.py`。
**功能描述**：
Wrap an LLM backend with default params for generate().
**函数签名**：
```python
class _LLMWithDefaults:
```


[User] 如何在 Laddr 中使用 `ToolRegistry.get` 函数？

[Assistant]
`ToolRegistry.get` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
```python
ToolRegistry.get(name=...)
```
**参数说明**：
- `name`: str - Tool name (canonical or alias)

**功能简述**：Get a tool by name or alias. Args: name: Tool name (canonical or alias) Returns: Tool instance or None if not found...


[User] 请解释 Laddr 中 `ProjectConfigSchema` 的作用。

[Assistant]
`ProjectConfigSchema` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/config.py`。
**功能描述**：
Project configuration schema (laddr.yml).
**函数签名**：
```python
class ProjectConfigSchema(BaseModel):
```


[User] 请解释 Laddr 中 `AgentMemory` 的作用。

[Assistant]
`AgentMemory` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/agent_runtime.py`。
**功能描述**：
Memory interface for agents.
**函数签名**：
```python
class AgentMemory:
```


[User] 如何在 Laddr 中使用 `print_error` 函数？

[Assistant]
`print_error` 位于 `lib/laddr/src/laddr/cli/utils/logger.py`，使用方法如下：
```python
print_error(message=..., hint=...)
```
**参数说明**：
- `message`: str - Error message
- `hint`: str | None

**功能简述**：Print an error message. Args: message: Error message hint: Optional hint for resolution...


[User] 如何在 Laddr 中使用 `run_prompt` 函数？

[Assistant]
`run_prompt` 位于 `lib/laddr/src/laddr/cli/commands/prompt.py`，使用方法如下：
```python
run_prompt(prompt_name=..., inputs=..., json_input=..., wait=..., timeout=...)
```
**参数说明**：
- `prompt_name`: str
- `inputs`: tuple
- `json_input`: str | None
- `wait`: bool
- `timeout`: int

**功能简述**：Run a prompt execution. Examples: laddr prompt run researcher --input query="AI trends" laddr prompt run researcher --json '{"query": "AI trends"}' laddr prompt run researcher --json @inputs.json...


[User] 如何在 Laddr 中使用 `DatabaseBackend.create_job` 函数？

[Assistant]
`DatabaseBackend.create_job` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
DatabaseBackend.create_job(job_id=..., pipeline=..., inputs=...)
```
**参数说明**：
- `job_id`: str
- `pipeline`: str
- `inputs`: dict


[User] 如何在 Laddr 中使用 `ToolRegistry.list` 函数？

[Assistant]
`ToolRegistry.list` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
**参数说明**：

**功能简述**：List all registered tools (excludes aliases)....


[User] Laddr 的 `prompt` 是做什么的？

[Assistant]
`prompt` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/prompt.py`。
**功能描述**：
Run and manage prompt executions.
**函数签名**：
```python
def prompt():
```
**返回值**：`None`


[User] 在 Laddr 中，`MCPToolSource.__init__` 方法在哪个文件里？

[Assistant] `MCPToolSource.__init__` 位于 `lib/laddr/src/laddr/core/mcp_client.py`。


[User] 如何在 Laddr 中使用 `DatabaseService.list_traces` 函数？

[Assistant]
`DatabaseService.list_traces` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.list_traces(agent=..., limit=...)
```
**参数说明**：
- `agent`: str | None
- `limit`: int

**功能简述**：List recent traces, optionally filtered by agent....


[User] 在 Laddr 项目中，`TemplateRenderer._kebab_case` 有什么功能？

[Assistant]
`TemplateRenderer._kebab_case` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/cli/utils/templates.py`。
**功能描述**：
Convert string to kebab-case.
**函数签名**：
```python
def _kebab_case(value: str) -> str:
```
**参数**：
- `value` (str)

**返回值**：`str`


[User] 请解释 Laddr 中 `add` 的作用。

[Assistant]
`add` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/add.py`。
**功能描述**：
Add resources to your project (agents, tools).
**函数签名**：
```python
def add():
```
**返回值**：`None`


[User] 在 Laddr 中，`_print_management_commands` 函数在哪个文件里？

[Assistant] `_print_management_commands` 位于 `lib/laddr/src/laddr/cli/commands/run.py`。


[User] 请解释 Laddr 中 `DatabaseService.register_agent` 的作用。

[Assistant]
`DatabaseService.register_agent` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Register or update an agent in the registry.
**函数签名**：
```python
def register_agent(self, agent_name: str, metadata: dict) -> None:
```
**参数**：
- `self` (Any)
- `agent_name` (str)
- `metadata` (dict)

**返回值**：`None`


[User] Laddr 的 `ProjectDetails` 是做什么的？

[Assistant]
`ProjectDetails` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/config.py`。
**功能描述**：
Project details section.
**函数签名**：
```python
class ProjectDetails(BaseModel):
```


[User] 在 Laddr 项目中，`print_panel` 有什么功能？

[Assistant]
`print_panel` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/logger.py`。
**功能描述**：
Print a styled panel. Args: title: Panel title content: Panel content style: Panel border style (default: cyan)
**函数签名**：
```python
def print_panel(title: str, content: str, style: str = "cyan") -> None:
```
**参数**：
- `title` (str): Panel title
- `content` (str)
- `style` (str)

**返回值**：`None`


[User] Laddr 的 `BackendFactory.create_queue_backend` 是做什么的？

[Assistant]
`BackendFactory.create_queue_backend` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Create message queue backend based on config.
**函数签名**：
```python
def create_queue_backend(self) -> QueueBackend:
```
**参数**：
- `self` (Any)

**返回值**：`QueueBackend`


[User] 如何在 Laddr 中使用 `print_warning` 函数？

[Assistant]
`print_warning` 位于 `lib/laddr/src/laddr/cli/utils/logger.py`，使用方法如下：
```python
print_warning(message=...)
```
**参数说明**：
- `message`: str - Warning message

**功能简述**：Print a warning message. Args: message: Warning message...


[User] Laddr 的 `stop` 是做什么的？

[Assistant]
`stop` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/management.py`。
**功能描述**：
Stop all Laddr services. Examples: laddr stop laddr stop --volumes  # Also remove data volumes
**函数签名**：
```python
def stop(volumes: bool):
```
**参数**：
- `volumes` (bool)

**返回值**：`None`


[User] Laddr 的 `Tool.invoke` 是做什么的？

[Assistant]
`Tool.invoke` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/tooling.py`。
**功能描述**：
Invoke the tool with validated inputs. Returns tool execution result.
**函数签名**：
```python
def invoke(self, **kwargs) -> Any:
```
**参数**：
- `self` (Any)

**返回值**：`Any`


[User] 如何在 Laddr 中使用 `replay_job` 函数？

[Assistant]
`replay_job` 位于 `lib/laddr/src/laddr/cli/commands/run.py`，使用方法如下：
```python
replay_job(job_id=..., reexecute=...)
```
**参数说明**：
- `job_id`: str
- `reexecute`: bool

**功能简述**：Replay a previous job by job ID. Examples: laddr run replay abc123-456-def laddr run replay abc123-456-def --reexecute...


[User] 请解释 Laddr 中 `InMemoryCache.delete` 的作用。

[Assistant]
`InMemoryCache.delete` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/cache.py`。
**功能描述**：
Delete value from cache.
**函数签名**：
```python
def delete(self, key: str) -> None:
```
**参数**：
- `self` (Any)
- `key` (str)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `print_info` 函数？

[Assistant]
`print_info` 位于 `lib/laddr/src/laddr/cli/utils/logger.py`，使用方法如下：
```python
print_info(message=...)
```
**参数说明**：
- `message`: str - Info message

**功能简述**：Print an info message. Args: message: Info message...


[User] 在 Laddr 中，`create_tool_schema` 函数在哪个文件里？

[Assistant] `create_tool_schema` 位于 `lib/laddr/src/laddr/core/tooling.py`。


[User] 在 Laddr 中，`InMemoryStorage.__init__` 方法在哪个文件里？

[Assistant] `InMemoryStorage.__init__` 位于 `lib/laddr/src/laddr/core/storage.py`。


[User] 如何在 Laddr 中使用 `Agent._tool_cache_key` 函数？

[Assistant]
`Agent._tool_cache_key` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
```python
Agent._tool_cache_key(name=..., params=...)
```
**参数说明**：
- `name`: str
- `params`: dict

**功能简述**：Generate cache key for tool call....


[User] 如何在 Laddr 中使用 `DatabaseService.list_agents` 函数？

[Assistant]
`DatabaseService.list_agents` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
**参数说明**：

**功能简述**：List all registered agents with trace counts and last execution time....


[User] 如何在 Laddr 中使用 `print_table` 函数？

[Assistant]
`print_table` 位于 `lib/laddr/src/laddr/cli/utils/logger.py`，使用方法如下：
```python
print_table(data=..., title=...)
```
**参数说明**：
- `data`: list[dict] - List of dictionaries (each dict is a row)
- `title`: str | None

**功能简述**：Print data as a rich table. Args: data: List of dictionaries (each dict is a row) title: Optional table title...


[User] 请解释 Laddr 中 `ProjectExistsError` 的作用。

[Assistant]
`ProjectExistsError` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/errors.py`。
**功能描述**：
Raised when trying to create a project that already exists.
**函数签名**：
```python
class ProjectExistsError(LaddrError):
```


[User] 如何在 Laddr 中使用 `anthropic` 函数？

[Assistant]
`anthropic` 位于 `lib/laddr/src/laddr/llms.py`，使用方法如下：
```python
anthropic(model=..., temperature=...)
```
**参数说明**：
- `model`: str | None
- `temperature`: float | None


[User] 在 Laddr 项目中，`ToolRegistry.get` 有什么功能？

[Assistant]
`ToolRegistry.get` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/tooling.py`。
**功能描述**：
Get a tool by name or alias. Args: name: Tool name (canonical or alias) Returns: Tool instance or None if not found
**函数签名**：
```python
def get(self, name: str) -> Tool | None:
```
**参数**：
- `self` (Any)
- `name` (str): Tool name (canonical or alias)

**返回值**：`Tool | None`


[User] Laddr 的 `run_agent_cmd` 是做什么的？

[Assistant]
`run_agent_cmd` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/run.py`。
**功能描述**：
Run a single agent locally using AgentRunner.
**函数签名**：
```python
def run_agent_cmd(agent_name: str, inputs_json: str):
```
**参数**：
- `agent_name` (str)
- `inputs_json` (str)

**返回值**：`None`


[User] Laddr 的 `_create_directories` 是做什么的？

[Assistant]
`_create_directories` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/init.py`。
**功能描述**：
Create project directory structure.
**函数签名**：
```python
def _create_directories(project_path: Path) -> None:
```
**参数**：
- `project_path` (Path)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `groq` 函数？

[Assistant]
`groq` 位于 `lib/laddr/src/laddr/llms.py`，使用方法如下：
```python
groq(model=..., temperature=...)
```
**参数说明**：
- `model`: str | None - Model name (default: llama-3.3-70b-versatile)
- `temperature`: float | None

**功能简述**：Create a Groq LLM backend instance. Args: model: Model name (default: llama-3.3-70b-versatile) temperature: Generation temperature Example: llm = groq(model="llama-3.3-70b-versatile", temperature=0.5)...


[User] 在 Laddr 项目中，`get_tool_override` 有什么功能？

[Assistant]
`get_tool_override` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/core/system_tools.py`。
**功能描述**：
Get a tool override if it exists. Args: tool_name: Name of the tool to check Returns: The override function if registered, None otherwise
**函数签名**：
```python
def get_tool_override(tool_name: str) -> Callable | None:
```
**参数**：
- `tool_name` (str): Name of the tool to check

**返回值**：`Callable | None`


[User] 如何在 Laddr 中使用 `run_dev` 函数？

[Assistant]
`run_dev` 位于 `lib/laddr/src/laddr/cli/commands/run.py`，使用方法如下：
```python
run_dev(build=..., detach=...)
```
**参数说明**：
- `build`: bool
- `detach`: bool

**功能简述**：Run the Laddr development environment. Starts all infrastructure services and agent workers: - PostgreSQL (internal observability database) - Redis (message bus) - API server - Agent workers - Dashboa...


[User] Laddr 的 `DatabaseService.get_job_traces` 是做什么的？

[Assistant]
`DatabaseService.get_job_traces` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Get all traces for a job.
**函数签名**：
```python
def get_job_traces(self, job_id: str) -> list[dict]:
```
**参数**：
- `self` (Any)
- `job_id` (str)

**返回值**：`list[dict]`


[User] 在 Laddr 中，`InMemoryCache.clear` 方法在哪个文件里？

[Assistant] `InMemoryCache.clear` 位于 `lib/laddr/src/laddr/core/cache.py`。


[User] 如何在 Laddr 中使用 `ResponseMessage.from_dict` 函数？

[Assistant]
`ResponseMessage.from_dict` 位于 `lib/laddr/src/laddr/core/message_bus.py`，使用方法如下：
```python
ResponseMessage.from_dict(cls=..., data=...)
```
**参数说明**：
- `cls`: Any
- `data`: dict


[User] 请解释 Laddr 中 `check_docker_compose` 的作用。

[Assistant]
`check_docker_compose` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/docker.py`。
**功能描述**：
Check if Docker Compose is available. Returns: True if Docker Compose is available Raises: DockerNotFoundError: If Docker Compose is not found
**函数签名**：
```python
def check_docker_compose() -> bool:
```
**返回值**：`bool`


[User] 如何在 Laddr 中使用 `MCPToolSource.__init__` 函数？

[Assistant]
`MCPToolSource.__init__` 位于 `lib/laddr/src/laddr/core/mcp_client.py`，使用方法如下：
**参数说明**：


[User] Laddr 的 `GeminiLLM` 是做什么的？

[Assistant]
`GeminiLLM` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/llm.py`。
**功能描述**：
Google Gemini LLM backend.
**函数签名**：
```python
class GeminiLLM:
```


[User] Laddr 的 `run_pipeline` 是做什么的？

[Assistant]
`run_pipeline` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/run.py`。
**功能描述**：
Run a pipeline defined in a YAML file.
**函数签名**：
```python
def run_pipeline(pipeline_file: str):
```
**参数**：
- `pipeline_file` (str)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `DatabaseService.get_trace` 函数？

[Assistant]
`DatabaseService.get_trace` 位于 `lib/laddr/src/laddr/core/database.py`，使用方法如下：
```python
DatabaseService.get_trace(trace_id=...)
```
**参数说明**：
- `trace_id`: str

**功能简述**：Get a single trace event by id with full payload....


[User] 在 Laddr 中，`_list` 函数在哪个文件里？

[Assistant] `_list` 位于 `lib/laddr/src/laddr/core/storage.py`。


[User] 在 Laddr 中，`print_panel` 函数在哪个文件里？

[Assistant] `print_panel` 位于 `lib/laddr/src/laddr/cli/utils/logger.py`。


[User] 在 Laddr 中，`GroqLLM` 类在哪个文件里？

[Assistant] `GroqLLM` 位于 `lib/laddr/src/laddr/core/llm.py`。


[User] 在 Laddr 项目中，`TaskDelegationTool` 有什么功能？

[Assistant]
`TaskDelegationTool` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/system_tools.py`。
**功能描述**：
Tool for delegating tasks to other agents.
**函数签名**：
```python
class TaskDelegationTool:
```


[User] 在 Laddr 项目中，`AgentRunner` 有什么功能？

[Assistant]
`AgentRunner` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/runtime_entry.py`。
**功能描述**：
High-level agent runner for executing agents and managing jobs. Provides: - run(): Execute agent with job tracking - replay(): Replay previous job - run_pipeline(): Orchestrate multi-agent workflow
**函数签名**：
```python
class AgentRunner:
```


[User] 请解释 Laddr 中 `validate_project_directory` 的作用。

[Assistant]
`validate_project_directory` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/config.py`。
**功能描述**：
Check if a directory contains a valid Laddr project. Args: path: Directory path to check Returns: True if valid project directory
**函数签名**：
```python
def validate_project_directory(path: Path) -> bool:
```
**参数**：
- `path` (Path): Directory path to check

**返回值**：`bool`


[User] 请解释 Laddr 中 `TemplateRenderer` 的作用。

[Assistant]
`TemplateRenderer` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/templates.py`。
**功能描述**：
Jinja2 template renderer for Laddr CLI.
**函数签名**：
```python
class TemplateRenderer:
```


[User] 请解释 Laddr 中 `Agent.plan` 的作用。

[Assistant]
`Agent.plan` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/agent_runtime.py`。
**功能描述**：
Create execution plan for a task. Default implementation: simple single-step plan. Subclasses should override for custom planning logic. Args: task: Task inputs Returns: List of steps, where each step is a dict with: - action: "tool" | "delegate" | "llm" | "custom" - Additional fields depending on action type
**函数签名**：
```python
def plan(self, task: dict) -> list[dict]:
```
**参数**：
- `self` (Any)
- `task` (dict): Task inputs

**返回值**：`list[dict]`


[User] 请解释 Laddr 中 `Agent._tool_cache_key` 的作用。

[Assistant]
`Agent._tool_cache_key` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/agent_runtime.py`。
**功能描述**：
Generate cache key for tool call.
**函数签名**：
```python
def _tool_cache_key(self, name: str, params: dict) -> str:
```
**参数**：
- `self` (Any)
- `name` (str)
- `params` (dict)

**返回值**：`str`


[User] 请解释 Laddr 中 `TemplateRenderer.__init__` 的作用。

[Assistant]
`TemplateRenderer.__init__` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/cli/utils/templates.py`。
**功能描述**：
Initialize template renderer. Args: templates_dir: Directory containing Jinja2 templates
**函数签名**：
```python
def __init__(self, templates_dir: Path):
```
**参数**：
- `self` (Any)
- `templates_dir` (Path): Directory containing Jinja2 templates

**返回值**：`None`


[User] Laddr 的 `wrap_with_runtime_injection` 是做什么的？

[Assistant]
`wrap_with_runtime_injection` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/core/system_tools.py`。
**功能描述**：
Wrap a custom system tool function to inject runtime parameters. Custom override functions can declare _message_bus, _artifact_storage, _agent parameters which will be automatically injected at call time.
**函数签名**：
```python
def wrap_with_runtime_injection(tool_func):
```
**参数**：
- `tool_func` (Any)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `AgentRunner.replay` 函数？

[Assistant]
`AgentRunner.replay` 位于 `lib/laddr/src/laddr/core/runtime_entry.py`，使用方法如下：
```python
AgentRunner.replay(job_id=..., reexecute=...)
```
**参数说明**：
- `job_id`: str - Job ID to replay
- `reexecute`: bool

**功能简述**：Replay a previous job. Args: job_id: Job ID to replay reexecute: If True, re-execute the job; if False, return stored result Returns: Job result...


[User] 在 Laddr 中，`decorator` 函数在哪个文件里？

[Assistant] `decorator` 位于 `lib/laddr/src/laddr/core/tooling.py`。


[User] 如何在 Laddr 中使用 `openai` 函数？

[Assistant]
`openai` 位于 `lib/laddr/src/laddr/llms.py`，使用方法如下：
```python
openai(model=..., temperature=..., base_url=...)
```
**参数说明**：
- `model`: str | None
- `temperature`: float | None
- `base_url`: str | None


[User] 请解释 Laddr 中 `DatabaseService.get_metrics` 的作用。

[Assistant]
`DatabaseService.get_metrics` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Get aggregated metrics.
**函数签名**：
```python
def get_metrics(self) -> dict[str, Any]:
```
**参数**：
- `self` (Any)

**返回值**：`dict[str, Any]`


[User] 如何在 Laddr 中使用 `ToolRegistry.register` 函数？

[Assistant]
`ToolRegistry.register` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
```python
ToolRegistry.register(tool_obj=..., name=..., aliases=...)
```
**参数说明**：
- `tool_obj`: Tool | Callable - Tool instance or callable to register
- `name`: str | None
- `aliases`: list[str] | None

**功能简述**：Register a tool with optional aliases. Args: tool_obj: Tool instance or callable to register name: Optional explicit name (overrides tool_obj.name) aliases: Optional list of alias names that resolve t...


[User] 如何在 Laddr 中使用 `wrap_with_runtime_injection` 函数？

[Assistant]
`wrap_with_runtime_injection` 位于 `lib/laddr/src/laddr/core/system_tools.py`，使用方法如下：
```python
wrap_with_runtime_injection(tool_func=...)
```
**参数说明**：
- `tool_func`: Any

**功能简述**：Wrap a custom system tool function to inject runtime parameters. Custom override functions can declare _message_bus, _artifact_storage, _agent parameters which will be automatically injected at call t...


[User] 请解释 Laddr 中 `ToolRegistry.list_names` 的作用。

[Assistant]
`ToolRegistry.list_names` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/tooling.py`。
**功能描述**：
List all canonical tool names (excludes aliases).
**函数签名**：
```python
def list_names(self) -> list[str]:
```
**参数**：
- `self` (Any)

**返回值**：`list[str]`


[User] 在 Laddr 项目中，`create_tool_schema` 有什么功能？

[Assistant]
`create_tool_schema` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/core/tooling.py`。
**功能描述**：
Create a JSON schema for a tool (for LLM function calling). Returns OpenAI-style function schema.
**函数签名**：
```python
def create_tool_schema(tool: Tool) -> dict[str, Any]:
```
**参数**：
- `tool` (Tool)

**返回值**：`dict[str, Any]`


[User] 在 Laddr 中，`CacheBackend` 类在哪个文件里？

[Assistant] `CacheBackend` 位于 `lib/laddr/src/laddr/core/config.py`。


[User] 如何在 Laddr 中使用 `AgentMemory.put` 函数？

[Assistant]
`AgentMemory.put` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
```python
AgentMemory.put(key=..., value=...)
```
**参数说明**：
- `key`: str
- `value`: Any

**功能简述**：Store a memory entry....


[User] 在 Laddr 项目中，`_generate_config_files` 有什么功能？

[Assistant]
`_generate_config_files` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/init.py`。
**功能描述**：
Generate configuration files.
**函数签名**：
```python
def _generate_config_files(project_path: Path, project_name: str) -> None:
```
**参数**：
- `project_path` (Path)
- `project_name` (str)

**返回值**：`None`


[User] Laddr 的 `DatabaseService.get_prompt_result` 是做什么的？

[Assistant]
`DatabaseService.get_prompt_result` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Get prompt execution result.
**函数签名**：
```python
def get_prompt_result(self, prompt_id: str) -> dict | None:
```
**参数**：
- `self` (Any)
- `prompt_id` (str)

**返回值**：`dict | None`


[User] 在 Laddr 项目中，`QueueBackend` 有什么功能？

[Assistant]
`QueueBackend` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Protocol for message queue backends.
**函数签名**：
```python
class QueueBackend(Protocol):
```


[User] Laddr 的 `load_agents` 是做什么的？

[Assistant]
`load_agents` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/core/config.py`。
**功能描述**：
Load agents dynamically from 'agents.<name>.handler'. Supports two patterns: 1) @actor-decorated classes named <Name>Agent (instantiated without args) 2) Module-level Agent instances (any variable bound to laddr.core.agent_runtime.Agent)
**函数签名**：
```python
def load_agents() -> Dict[str, Any]:
```
**返回值**：`Dict[str, Any]`


[User] 如何在 Laddr 中使用 `Agent._build_autonomous_system_prompt` 函数？

[Assistant]
`Agent._build_autonomous_system_prompt` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`，使用方法如下：
```python
Agent._build_autonomous_system_prompt(available_tools=..., available_agents=..., can_delegate=...)
```
**参数说明**：
- `available_tools`: list[str]
- `available_agents`: list[dict]
- `can_delegate`: bool

**功能简述**：Build system prompt for autonomous agent....


[User] 如何在 Laddr 中使用 `DatabaseBackend.memory_get` 函数？

[Assistant]
`DatabaseBackend.memory_get` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
DatabaseBackend.memory_get(agent_name=..., key=..., job_id=...)
```
**参数说明**：
- `agent_name`: str
- `key`: str
- `job_id`: str | None


[User] 在 Laddr 项目中，`AgentRunner._discover_local_agents` 有什么功能？

[Assistant]
`AgentRunner._discover_local_agents` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/runtime_entry.py`。
**功能描述**：
Discover local agents under the 'agents' package for inline execution.
**函数签名**：
```python
def _discover_local_agents(self, exclude: list[str] | None = None) -> list[str]:
```
**参数**：
- `self` (Any)
- `exclude` (list[str] | None)

**返回值**：`list[str]`


[User] Laddr 的 `InMemoryStorage.__init__` 是做什么的？

[Assistant]
`InMemoryStorage.__init__` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/storage.py`。
**功能描述**：
Initialize in-memory storage.
**函数签名**：
```python
def __init__(self):
```
**参数**：
- `self` (Any)

**返回值**：`None`


[User] 如何在 Laddr 中使用 `create_tool_schema` 函数？

[Assistant]
`create_tool_schema` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
```python
create_tool_schema(tool=...)
```
**参数说明**：
- `tool`: Tool

**功能简述**：Create a JSON schema for a tool (for LLM function calling). Returns OpenAI-style function schema....


[User] Laddr 的 `check` 是做什么的？

[Assistant]
`check` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/check.py`。
**功能描述**：
Run diagnostic checks for the Laddr runtime using the DiagnosticAgent.
**函数签名**：
```python
def check(output_path: str):
```
**参数**：
- `output_path` (str)

**返回值**：`None`


[User] 在 Laddr 项目中，`_generate_default_agent` 有什么功能？

[Assistant]
`_generate_default_agent` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/init.py`。
**功能描述**：
Generate default coordinator and researcher agents.
**函数签名**：
```python
def _generate_default_agent(project_path: Path) -> None:
```
**参数**：
- `project_path` (Path)

**返回值**：`None`


[User] Laddr 的 `DatabaseService.__init__` 是做什么的？

[Assistant]
`DatabaseService.__init__` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/database.py`。
**功能描述**：
Initialize database service. Args: database_url: SQLAlchemy connection string e.g., "postgresql://user:pass@host:5432/db" or "sqlite:///./laddr.db" for local dev
**函数签名**：
```python
def __init__(self, database_url: str):
```
**参数**：
- `self` (Any)
- `database_url` (str): SQLAlchemy connection string

**返回值**：`None`


[User] 在 Laddr 中，`_generate_docker_setup` 函数在哪个文件里？

[Assistant] `_generate_docker_setup` 位于 `lib/laddr/src/laddr/cli/commands/init.py`。


[User] 如何在 Laddr 中使用 `DatabaseBackend.append_trace` 函数？

[Assistant]
`DatabaseBackend.append_trace` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
DatabaseBackend.append_trace(job_id=..., agent_name=..., event_type=..., payload=...)
```
**参数说明**：
- `job_id`: str
- `agent_name`: str
- `event_type`: str
- `payload`: dict


[User] 如何在 Laddr 中使用 `bind_tools` 函数？

[Assistant]
`bind_tools` 位于 `lib/laddr/src/laddr/core/tooling.py`，使用方法如下：
```python
bind_tools(agent_instance=..., tools=...)
```
**参数说明**：
- `agent_instance`: Any - Agent instance with .tools registry
- `tools`: list[str | Callable]

**功能简述**：Bind tools to an agent instance for explicit, readable tool registration. Supports: - String names: auto-import from agents.<agent>.tools.<name> - Callables: register directly - Decorated functions: e...


[User] 如何在 Laddr 中使用 `ResponseMessage.to_dict` 函数？

[Assistant]
`ResponseMessage.to_dict` 位于 `lib/laddr/src/laddr/core/message_bus.py`，使用方法如下：
**参数说明**：


[User] 请解释 Laddr 中 `InMemoryCache` 的作用。

[Assistant]
`InMemoryCache` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/cache.py`。
**功能描述**：
In-memory cache for local dev and testing. Simple dict-based cache with optional TTL.
**函数签名**：
```python
class InMemoryCache:
```


[User] 如何在 Laddr 中使用 `TaskMessage.to_dict` 函数？

[Assistant]
`TaskMessage.to_dict` 位于 `lib/laddr/src/laddr/core/message_bus.py`，使用方法如下：
**参数说明**：


[User] 请解释 Laddr 中 `list_tool_overrides` 的作用。

[Assistant]
`list_tool_overrides` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/core/system_tools.py`。
**功能描述**：
List all registered tool overrides. Returns: Dict mapping tool names to their override function names
**函数签名**：
```python
def list_tool_overrides() -> dict[str, str]:
```
**返回值**：`dict[str, str]`


[User] Laddr 的 `get_template_renderer` 是做什么的？

[Assistant]
`get_template_renderer` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/utils/templates.py`。
**功能描述**：
Get a configured template renderer. Returns: TemplateRenderer instance with CLI templates directory
**函数签名**：
```python
def get_template_renderer() -> TemplateRenderer:
```
**返回值**：`TemplateRenderer`


[User] 在 Laddr 项目中，`InMemoryStorage` 有什么功能？

[Assistant]
`InMemoryStorage` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/core/storage.py`。
**功能描述**：
In-memory storage backend for testing.
**函数签名**：
```python
class InMemoryStorage:
```


[User] 在 Laddr 项目中，`ProjectConfigSchema.save_to_file` 有什么功能？

[Assistant]
`ProjectConfigSchema.save_to_file` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/cli/utils/config.py`。
**功能描述**：
Save project config to YAML file. Args: path: Path to laddr.yml Raises: InvalidConfigError: If save fails
**函数签名**：
```python
def save_to_file(self, path: Path) -> None:
```
**参数**：
- `self` (Any)
- `path` (Path): Path to laddr.yml

**返回值**：`None`


[User] 在 Laddr 项目中，`ProjectConfigSchema.load_from_file` 有什么功能？

[Assistant]
`ProjectConfigSchema.load_from_file` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/cli/utils/config.py`。
**功能描述**：
Load project config from YAML file. Args: path: Path to laddr.yml Returns: Parsed project configuration Raises: InvalidConfigError: If config is invalid
**函数签名**：
```python
def load_from_file(cls, path: Path) -> ProjectConfigSchema:
```
**参数**：
- `cls` (Any)
- `path` (Path): Path to laddr.yml

**返回值**：`ProjectConfigSchema`


[User] 在 Laddr 项目中，`ollama` 有什么功能？

[Assistant]
`ollama` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/llms.py`。
**功能描述**：
Create a local Ollama backend instance. Example: llm = ollama(model="gemma2:2b", base_url="http://localhost:11434")
**函数签名**：
```python
def ollama(model: str | None = None, temperature: float | None = None, base_url: str | None = None) -> _LLMWithDefaults:
```
**参数**：
- `model` (str | None)
- `temperature` (float | None)
- `base_url` (str | None)

**返回值**：`_LLMWithDefaults`


[User] 如何在 Laddr 中使用 `validate_project_directory` 函数？

[Assistant]
`validate_project_directory` 位于 `lib/laddr/src/laddr/cli/utils/config.py`，使用方法如下：
```python
validate_project_directory(path=...)
```
**参数说明**：
- `path`: Path - Directory path to check

**功能简述**：Check if a directory contains a valid Laddr project. Args: path: Directory path to check Returns: True if valid project directory...


[User] 如何在 Laddr 中使用 `override_system_tool` 函数？

[Assistant]
`override_system_tool` 位于 `lib/laddr/src/laddr/core/system_tools.py`，使用方法如下：
```python
override_system_tool(tool_name=...)
```
**参数说明**：
- `tool_name`: str - Name of the system tool to override (e.g., "system_delegate_parallel")

**功能简述**：Decorator to override a system tool with a custom implementation. Use this decorator to replace built-in system tools (like system_delegate_parallel, system_split_document, etc.) with your own impleme...


[User] 在 Laddr 中，`Agent._trace` 方法在哪个文件里？

[Assistant] `Agent._trace` 位于 `lib/laddr/src/laddr/core/agent_runtime.py`。


[User] 如何在 Laddr 中使用 `BackendFactory.create_queue_backend` 函数？

[Assistant]
`BackendFactory.create_queue_backend` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
**参数说明**：

**功能简述**：Create message queue backend based on config....


[User] Laddr 的 `run_prompt` 是做什么的？

[Assistant]
`run_prompt` 是 Laddr 项目中的一个 函数，位于 `lib/laddr/src/laddr/cli/commands/prompt.py`。
**功能描述**：
Run a prompt execution. Examples: laddr prompt run researcher --input query="AI trends" laddr prompt run researcher --json '{"query": "AI trends"}' laddr prompt run researcher --json @inputs.json
**函数签名**：
```python
def run_prompt(prompt_name: str, inputs: tuple, json_input: str | None, wait: bool, timeout: int):
```
**参数**：
- `prompt_name` (str)
- `inputs` (tuple)
- `json_input` (str | None)
- `wait` (bool)
- `timeout` (int)

**返回值**：`None`


[User] 请解释 Laddr 中 `Agent._parse_autonomous_action_text` 的作用。

[Assistant]
`Agent._parse_autonomous_action_text` 是 Laddr 项目中的一个 方法，位于 `lib/laddr/src/laddr/core/agent_runtime.py`。
**功能描述**：
Parse legacy text format with ACTION:/AGENT:/TOOL_NAME:/... lines.
**函数签名**：
```python
def _parse_autonomous_action_text(self, response: str) -> dict:
```
**参数**：
- `self` (Any)
- `response` (str)

**返回值**：`dict`


[User] 在 Laddr 中，`Agent` 函数在哪个文件里？

[Assistant] `Agent` 位于 `lib/laddr/src/laddr/__init__.py`。


[User] Laddr 的 `LaddrError` 是做什么的？

[Assistant]
`LaddrError` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/errors.py`。
**功能描述**：
Base exception for all Laddr CLI errors.
**函数签名**：
```python
class LaddrError(Exception):
```


[User] 如何在 Laddr 中使用 `DatabaseBackend.register_agent` 函数？

[Assistant]
`DatabaseBackend.register_agent` 位于 `lib/laddr/src/laddr/core/config.py`，使用方法如下：
```python
DatabaseBackend.register_agent(agent_name=..., metadata=...)
```
**参数说明**：
- `agent_name`: str
- `metadata`: dict


[User] 请解释 Laddr 中 `DockerNotFoundError` 的作用。

[Assistant]
`DockerNotFoundError` 是 Laddr 项目中的一个 类，位于 `lib/laddr/src/laddr/cli/utils/errors.py`。
**功能描述**：
Raised when Docker is not installed or not running.
**函数签名**：
```python
class DockerNotFoundError(LaddrError):
```