~/wiki

Agent Ergonomics

Mis à jour le 2025-01-02Confiance : high
agent-ergonomicsuser-experienceobservabilityworkflow-designverificationorchestrationbounded-autonomythread-hygienemeasurable-outcomeshuman-checkpoints

Design principles and practices for creating effective human-agent interaction patterns and workflows. Focuses on verification systems, orchestration methods, and user experience patterns that enable productive collaboration between humans and AI agents.

Core Principles

Observability: Agents need dashboards and monitoring systems that provide visibility into their decision-making processes, error states, and performance metrics.

Verification Integration: Built-in checkpoints and validation mechanisms that allow humans to review and approve agent actions before execution.

Bounded Autonomy: Clear limits on agent decision-making authority with escalation paths for complex or high-stakes scenarios.

Workflow Patterns

Thread Hygiene: Management of conversation and context length to maintain agent performance over extended interactions. Balance between context accumulation and performance degradation.

Measurable Outcomes: Definition of clear, objective success criteria that both agents and humans can evaluate.

Human Checkpoints: Strategic insertion of human review points, particularly in domains where verification is difficult or consequences are high.

Infrastructure Requirements

Isolated Environments: Agents require sandboxed, inspectable execution environments for safe experimentation and rollback capabilities.

Long-running Sessions: Support for persistent agent state and memory across extended workflows and multi-session projects.

Multiplayer Workflows: Coordination systems for multiple humans and agents working on shared tasks or projects.

Implementation Examples

ClaudeDevs: Observability dashboards for MCP connector developers including adoption, latency, and error monitoring.

MagicPath: Builder plan for external-agent workflows with multiplayer canvas editing capabilities.

LangSmith Sandboxes: Isolated environments for agent development and testing with inspection capabilities.

Performance Considerations

Context Management: Balance between single-thread context accumulation (successful for some) vs. thread splitting to prevent performance degradation.

Approval Defaults: Systems that default to seeking approval ("approve-for-me") for common operations to maintain human oversight.

Error Recovery: Robust handling of bash errors, tool failures, and execution problems with clear recovery paths.

See also