Editing AI Agents and Agentic Systems (section)

== <span style="color: #FFFFFF;">Creating</span> ==
Designing a production agentic system:

'''1. Agent architecture selection'''
<syntaxhighlight lang="text">
Task type assessment:
├── Well-defined, linear → Sequential pipeline (not really an agent)
├── Requires adaptive planning → Single ReAct agent
├── Requires multiple specializations → Multi-agent with orchestrator
└── Requires human judgment at key points → Human-in-the-loop agent
</syntaxhighlight>

'''2. Tool design principles'''
* Tools should be idempotent where possible (safe to call multiple times)
* Tools should validate inputs and return structured errors, not exceptions
* Tools with side effects (write, delete, send) require explicit confirmation
* Every tool call should be logged with inputs and outputs for auditability

'''3. Safety architecture'''
<syntaxhighlight lang="text">
Agent decides action
    ↓
[Action classifier: is this action reversible?]
    ├── Reversible → Execute directly
    └── Irreversible → [Human approval checkpoint]
              ↓
[Sandboxed execution environment]
    ↓
[Output validation: does result match expected schema?]
    ↓
Observation returned to agent
</syntaxhighlight>

'''4. Observability'''
* Trace every thought, action, and observation (LangSmith, Langfuse, OpenTelemetry)
* Alert on: step budget exceeded, tool error rate > threshold, task failure
* Store all agent traces for post-hoc analysis and fine-tuning data collection

[[Category:Artificial Intelligence]]
[[Category:AI Agents]]
[[Category:Large Language Models]]
</div>