---
title: "AI Agent 设计笔记"
description: "用易于理解的方式整理 Agent、Harness 和工具调用的边界。"
---

> Documentation Index
> Fetch the complete documentation index at: https://personal-docs-b7b.pages.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# AI Agent 设计笔记

## 最小心智模型

一个 Agent 通常需要三个部分：

1. **目标**：要做什么。
2. **执行环境**：运行循环、消息上下文以及工具调用。
3. **反馈**：使用工具返回的结果决定下一步。

```text
用户任务
  ↓
Agent（选择行动）
  ↓
Harness（执行工具 / 管理运行状态）
  ↓
工具结果
  ↳ 返回 Agent，直到结束
```

## 为什么需要可观察性

开发 Agent 时不仅需要最终答案，还需要知道：执行了哪一步、调用了哪个工具、发生了什么错误。

> 先记录关键运行事件，再考虑复杂的观测平台。

## 待扩展

后续可以在这里嵌入 Agent 执行流程图、节点交互和可运行的示例。

Source: https://personal-docs-b7b.pages.dev/notes/agent/index.mdx