AX-Copilot-Codex/docs/SEMINAR_AGENT_LOOP.md

# ?먯씠?꾪듃 猷⑦봽 ?꾪궎?띿쿂 ???뚰겕?뚮줈??鍮꾧탳 遺꾩꽍

> **???*: 湲곗닠 ?꾩썝 쨌 媛쒕컻 由щ뜑
> **珥덉젏**: ?먯씠?꾪듃 肄붾뵫 ?쒕퉬?ㅼ쓽 ?듭떖 ?뚰겕?뚮줈??援ъ“? ?덉쭏 蹂댁쬆 ?꾨왂
> **?묒꽦??*: 2026-03-31

---

## 1. ?먯씠?꾪듃 猷⑦봽??

AI 肄붾뵫/臾몄꽌 ?앹꽦 ?쒕퉬?ㅼ쓽 ?듭떖 ?붿쭊? **?먯씠?꾪듃 猷⑦봽**?낅땲??

```
?ъ슜???붿껌 ??[LLM ?먮떒] ??[?꾧뎄 ?ㅽ뻾] ??[寃곌낵 愿李? ??[LLM ?ы뙋?? ??... ??理쒖쥌 ?묐떟
```

??諛섎났(iteration)??**?쇰쭏??吏?μ쟻?쇰줈, ?쇰쭏???덉쭏 ?덇쾶 ?섑뻾?섎뒓??*媛 ?쒕퉬??寃쎌웳?μ쓣 寃곗젙?⑸땲??

---

## 2. ?낃퀎 二쇱슂 ?쒕퉬???뚰겕?뚮줈??鍮꾧탳

### 2-1. OpenHands (?ㅽ뵂?뚯뒪, ICLR 2025)

OpenHands??CodeAct ?쇰Ц 湲곕컲???먯씠?꾪듃 ?꾨젅?꾩썙?ъ엯?덈떎.

```
?뚢?????????????????????????????????????????????????????                AgentController                  ????                                                 ???? while budget > 0:                               ????   action = agent.step(state)  ??1 LLM ?몄텧     ????   observation = runtime.run(action)  ???꾧뎄 ?ㅽ뻾????   state.update(action, observation)             ????   if action == AgentFinishAction:               ????       break  ??LLM??"???대씪 ?먮떒?섎㈃ 醫낅즺     ????                                                 ???? ??寃利?寃???④퀎: ?놁쓬                          ???? ??怨꾪쉷 ?앹꽦: ?놁쓬 (LLM ?먯쑉 ?먮떒)               ???붴???????????????????????????????????????????????????```

**?듭떖 ?뱀쭠**:
- **1 諛섎났 = 1 LLM ?몄텧 + 1 ?꾧뎄 ?ㅽ뻾** (怨좎젙)
- 怨꾪쉷(Plan) ?놁쓬 ??LLM??chain-of-thought???섏〈
- 寃利?Review) ?놁쓬 ??LLM???뚯븘???ㅼ쓬 諛섎났?먯꽌 ?뺤씤?좎? 寃곗젙
- 醫낅즺??`AgentFinishAction` 諛섑솚?쇰줈 寃곗젙 (LLM ?먯쑉)
- **SecurityAnalyzer**: ?ㅽ뻾 ???꾪뿕???됯? (LOW/MEDIUM/HIGH) ???덉쭏 寃利앹씠 ?꾨땶 **?덉쟾 寃뚯씠??*

**?μ젏**: ?⑥닚, 鍮좊쫫, 紐⑤뜽 臾닿?
**?쎌젏**: 臾몄꽌 ?앹꽦 ??寃??蹂댁옣 ?놁쓬, LLM??"異⑸텇?섎떎"怨??먮떒?섎㈃ 誘몄셿???곹깭濡?醫낅즺

### 2-2. Claw Code (Sigmoid)

```
?뚢?????????????????????????????????????????????????????             Claw Code Agent Loop              ????                                                 ???? while true:                                     ????   response = llm.call(messages)  ??1 LLM ?몄텧  ????   if no tool_calls:                             ????       break  ???띿뒪?몃쭔 諛섑솚?섎㈃ 醫낅즺            ????   for tool in tool_calls:                       ????       result = execute(tool)                    ????       messages.append(result)                   ????                                                 ???? ??寃利??④퀎: ?놁쓬 (?쒖뒪???꾨＼?꾪듃 沅뚭퀬留?       ???? ??怨꾪쉷: SKILL.md ?꾨＼?꾪듃濡??좊룄                 ???붴???????????????????????????????????????????????????```

**?듭떖 ?뱀쭠**:
- OpenHands? ?숈씪??援ъ“ (1 諛섎났 = 1 LLM ?몄텧)
- 醫낅즺: ?꾧뎄 ?몄텧???놁쑝硫?醫낅즺 (OpenHands??AgentFinishAction怨??좎궗)
- 寃利? ?쒖뒪???꾨＼?꾪듃??"?뺤씤?섎씪"怨??묒꽦 媛?ν븯?? **LLM??臾댁떆?????덉쓬**
- 李⑤퀎?? SKILL.md ?쒖??쇰줈 ?꾨찓?몃퀎 ?꾨＼?꾪듃 而ㅼ뒪?곕쭏?댁쭠

### 2-3. Cursor / Windsurf / GitHub Copilot

紐⑤몢 ?숈씪??**?⑥씪 LLM ?몄텧 猷⑦봽** ?⑦꽩:
- Cursor: Tab ??Apply 湲곕컲, ?먯씠?꾪듃 紐⑤뱶?먯꽌??1?몄텧/諛섎났
- Windsurf (Cascade): Flow 湲곕컲?댁?留?猷⑦봽 援ъ“???숈씪
- GitHub Copilot: 肄붾뱶 ?꾩꽦 ?뱁솕, ?먯씠?꾪듃 紐⑤뱶??Claw Code? ?좎궗

**怨듯넻 ?쎌젏**: **臾몄꽌/肄붾뱶 ?앹꽦 ??"?쎌뼱???뺤씤"?섎뒗 ?꾪궎?띿쿂媛 ?놁쓬**

---

## 3. ??寃利??④퀎媛 ?놁쓣源?

### 3-1. AgentFinishAction 臾몄젣

OpenHands??LLM??`AgentFinishAction`??諛섑솚?섎㈃ 猷⑦봽媛 醫낅즺?⑸땲??

```python
# OpenHands??醫낅즺 ?먮떒
if isinstance(action, AgentFinishAction):
    return  # LLM??"???대씪怨??섎㈃ ??```

**臾몄젣**: LLM??"?뚯씪???앹꽦?덉쑝?????대씪怨??먮떒?섎㈃, **?댁슜??遺덉셿?꾪빐??醫낅즺**?⑸땲??

?곕━????AgentFinishAction???ъ슜?섏? ?딅뒗媛?

| ??ぉ | AgentFinishAction (OpenHands) | ?꾧뎄 ?몄텧 ?놁쓬 醫낅즺 (AX Copilot) |
|------|------------------------------|--------------------------------|
| 醫낅즺 ?먮떒 | LLM??紐낆떆?곸쑝濡?"finish" ?≪뀡 諛섑솚 | LLM???띿뒪?몃쭔 諛섑솚 (?꾧뎄 誘명샇異? |
| ?μ젏 | 紐낆떆?? 醫낅즺 ?댁쑀 ?ы븿 媛??| 蹂꾨룄 ?≪뀡 ?뺤쓽 遺덊븘?? ?먯뿰?ㅻ윭??????먮쫫 |
| ?⑥젏 | finish ?몄텧???딄굅???섎せ ?몄텧 媛??| LLM???꾧뎄瑜?遺瑜댁? ?딆쑝硫??섎룄移??딄쾶 醫낅즺 |
| 寃利???대컢 | finish ?꾩뿉 寃利??쎌엯 媛??(誘멸뎄?? | ?꾧뎄 ?ㅽ뻾 ??利됱떆 寃利??쎌엯 (援ы쁽 ?꾨즺) |

**?듭떖**: ????"LLM???뚯븘???앸궡????援ъ“?대?濡? **寃利앹쓣 LLM?먭쾶 留↔린硫??앸왂???섎컰???놁뒿?덈떎.**

### 3-2. ?쒖뒪???꾨＼?꾪듃留뚯쑝濡쒕뒗 遺議?
```
?쒖뒪???꾨＼?꾪듃: "臾몄꽌 ?묒꽦 ??諛섎뱶??file_read濡?寃곌낵臾쇱쓣 寃?좏븯?몄슂"
```

??吏?쒕? LLM???곕? ?뺣쪧:
- GPT-4/Sigmoid: **~60-70%** (蹂듭옟???묒뾽?먯꽌 臾댁떆 寃쏀뼢)
- Gemini Flash: **~40-50%** (臾대즺 紐⑤뜽?먯꽌 ???먯＜ ?앸왂)
- 濡쒖뺄 紐⑤뜽 (Ollama): **~30%** (而⑦뀓?ㅽ듃 湲몄뼱吏硫?珥덇린 吏???ъ꽍)

??**?꾪궎?띿쿂 ?섏??먯꽌 媛뺤젣?댁빞 ?좊ː???뺣낫 媛??*

---

## 4. 寃利?媛뺤젣 ?꾪궎?띿쿂 (AX Copilot 援ы쁽)

### 4-1. 湲곗〈 援ъ“ (v1.7.0)

```
諛섎났 1: LLM ?몄텧 ??"file_read濡??꾩옱 ?뚯씪 ?뺤씤?섍쿋?듬땲??
         ?꾧뎄 ?ㅽ뻾: file_read ???뚯씪 ?댁슜 諛섑솚

諛섎났 2: LLM ?몄텧 ??"html_create濡?蹂닿퀬?쒕? ?앹꽦?섍쿋?듬땲??
         ?꾧뎄 ?ㅽ뻾: html_create ??"蹂닿퀬??html ?앹꽦 ?꾨즺"

諛섎났 3: LLM ?몄텧 ??"蹂닿퀬?쒓? ?꾩꽦?섏뿀?듬땲??" (?띿뒪?몃쭔 = 猷⑦봽 醫낅즺)
         ???앹꽦???뚯씪???쎌뼱???뺤씤?섏? ?딆쓬!
```

### 4-2. 媛쒖꽑 援ъ“ (v1.7.1 ??寃利?媛뺤젣)

```
諛섎났 1: LLM ?몄텧 ??"file_read濡??꾩옱 ?뚯씪 ?뺤씤?섍쿋?듬땲??
         ?꾧뎄 ?ㅽ뻾: file_read ???뚯씪 ?댁슜 諛섑솚

諛섎났 2: LLM ?몄텧 ??"html_create濡?蹂닿퀬?쒕? ?앹꽦?섍쿋?듬땲??
         ?꾧뎄 ?ㅽ뻾: html_create ??"蹂닿퀬??html ?앹꽦 ?꾨즺"
         ?뚢????????????????????????????????????????????????         ????寃利?媛뺤젣 (?먮룞 ?쎌엯)                       ??         ??                                             ??         ???쒖뒪?? "?앹꽦???뚯씪??file_read濡??쎄퀬        ??         ??        ?댁슜 ?꾩쟾?? 援ъ“, 留욎땄踰뺤쓣 ?뺤씤?섏꽭?? ??         ??                                             ??         ??LLM ?몄텧 (寃利??꾩슜)                          ??         ????file_read ?ㅽ뻾 ???댁슜 ?뺤씤                  ??         ????臾몄젣 ?덉쑝硫??섏젙 ?꾧뎄 ?몄텧                    ??         ????臾몄젣 ?놁쑝硫?"寃利??꾨즺" 蹂닿퀬                 ??         ?붴????????????????????????????????????????????????
諛섎났 3: LLM ?몄텧 ??"蹂닿퀬?쒓? ?꾩꽦?섏뿀?듬땲??" (寃利??듦낵 ??醫낅즺)
```

### 4-3. 肄붾뱶 ?먮쫫 (?섏궗肄붾뱶)

```csharp
while (iteration < maxIterations)
{
    var blocks = await llm.SendWithToolsAsync(messages, tools);

    foreach (var call in toolCalls)
    {
        var result = await tool.ExecuteAsync(call);
        messages.Add(CreateToolResult(result));

        // ??寃利?媛뺤젣: 臾몄꽌 ?앹꽦 ?꾧뎄 ?ㅽ뻾 ???먮룞 ?쎌엯
        if (settings.EnablePostToolVerification
            && IsDocumentCreationTool(call.ToolName)
            && result.Success)
        {
            // 寃利??꾩슜 LLM ?몄텧 (file_read ?좊룄)
            await RunPostToolVerificationAsync(messages, call, result);
            iteration++;  // 寃利앸룄 諛섎났 ?잛닔???ы븿
        }
    }

    if (no tool calls) break;  // ?띿뒪?몃쭔 = 醫낅즺
}
```

---

## 5. 遺議깊븳 遺遺꾧낵 ?ν썑 媛쒕컻 諛⑺뼢

### 5-1. ?꾩옱 遺議깊븳 ?곸뿭

| ?곸뿭 | ?꾩옱 ?곹깭 | OpenHands 鍮꾧탳 | 媛쒖꽑 ?꾩슂??|
|------|----------|---------------|-----------|
| **Multi-Agent ?꾩엫** | ??誘멸뎄??| ??AgentDelegateAction | ?믪쓬 ??蹂듭옟???묒뾽???섏쐞 ?먯씠?꾪듃??遺꾪븷 |
| **Event-Sourced State** | 遺遺?援ы쁽 (Events 而щ젆?? | ??遺덈? ?대깽???ㅽ듃由?| 以묎컙 ???ъ떎???붾쾭源낆뿉 ?좎슜 |
| **SecurityAnalyzer** | Ask 紐⑤뱶 沅뚰븳 ?뺤씤 | ???꾪뿕???먮룞 遺꾨쪟 | ??쓬 ???щ궡 ?섍꼍?먯꽌 ?곗꽑?쒖쐞 ??쓬 |
| **CodeAct ?듯빀 ?≪뀡** | ?꾧뎄蹂?遺꾨━ | ??bash+Python ?듯빀 | ??쓬 ???꾩옱 ?꾧뎄 泥닿퀎濡?異⑸텇 |
| **寃利?源딆씠** | ?⑥씪 寃利??몄텧 | ?대떦 ?놁쓬 | 以묎컙 ??蹂듭닔 湲곗?蹂?寃利?媛??|
| **寃利?????뺣?** | 臾몄꽌 ?앹꽦 ?꾧뎄留?| ?대떦 ?놁쓬 | 以묎컙 ??肄붾뱶 ?앹꽦 ?꾩뿉??寃利??꾩슂 |

### 5-2. ?ν썑 媛쒕컻 怨꾪쉷

#### Phase A: 寃利?怨좊룄??(?④린)

| 湲곕뒫 | ?ㅻ챸 | ?덉긽 怨듭닔 |
|------|------|----------|
| 寃利?湲곗? 而ㅼ뒪?곕쭏?댁쭠 | ?ㅼ젙?먯꽌 寃利?泥댄겕由ъ뒪?몃? ?ъ슜?먭? ?몄쭛 | ??쓬 |
| 肄붾뱶 寃利??뺣? | `script_create`, `file_edit` ?꾩뿉??寃利?(援щЦ ?ㅻ쪟 寃?? | ??쓬 |
| 寃利?寃곌낵 UI ?쒖떆 | ?뚰겕?뚮줈????꾨씪?몄뿉 "??寃利??듦낵" / "???섏젙 諛쒖깮" 諛곗? | ??쓬 |
| 寃利??듦퀎 | 寃利앹뿉??臾몄젣 諛쒓껄/?섏젙??鍮꾩쑉 異붿쟻 | ??쓬 |

#### Phase B: 硫?곗뿉?댁쟾???꾩엫 (以묎린)

OpenHands??`AgentDelegateAction` ?⑦꽩??李멸퀬?섎릺, ?щ궡 ?섍꼍??留욊쾶:

```
[硫붿씤 ?먯씠?꾪듃]
  ?쒋?? [由ъ꽌移??먯씠?꾪듃] ??file_read, grep, folder_map ?꾨떞
  ?쒋?? [臾몄꽌 ?먯씠?꾪듃] ??html_create, docx_create ?꾨떞
  ?붴?? [寃利??먯씠?꾪듃] ??file_read + ?덉쭏 ?됯? ?꾨떞  ??寃利?遺꾨━!
```

| 湲곕뒫 | ?ㅻ챸 | ?덉긽 怨듭닔 |
|------|------|----------|
| AgentDelegateAction | ?섏쐞 ?먯씠?꾪듃 ?꾩엫 ?≪뀡 ?뺤쓽 | 以묎컙 |
| ?먯씠?꾪듃蹂??꾧뎄 ?쒗븳 | 由ъ꽌移??쎄린留? 臾몄꽌=?곌린留???| ??쓬 |
| 寃利??먯씠?꾪듃 遺꾨━ | ?앹꽦怨?寃利앹쓣 ?ㅻⅨ ?먯씠?꾪듃濡?| 以묎컙 |

#### Phase C: Reflexion ?⑦꽩 (?κ린)

Reflexion ?쇰Ц(Shinn et al., 2023)???먭린 諛섏꽦 ?⑦꽩 媛뺥솕:

```
?ㅽ뻾 ??寃곌낵 ???먭린 ?됯? ??諛섏꽦 硫붾え由???????ㅼ쓬 ?쒕룄??諛섏쁺
```

?꾩옱 Self-Reflection? **?ㅻ쪟 諛쒖깮 ?쒖뿉留?* ?숈옉. ?대? **?깃났 ?쒖뿉??* ?곸슜:
- "??臾몄꽌???ъ슜???붽뎄瑜?80% 異⑹”. 誘명씉 ?? ?쒓? ?꾨씫??
- 諛섏꽦 寃곌낵瑜?AgentMemory???????媛숈? ?좏삎 ?묒뾽 ??李멸퀬

---

## 6. ?뺣━

### ?듭떖 硫붿떆吏

```
?뚢?????????????????????????????????????????????????????????                                                    ???? ?낃퀎 紐⑤뱺 ?먯씠?꾪듃 猷⑦봽??"1諛섎났 = 1 LLM ?몄텧"     ???? 寃利?Review)??媛뺤젣?섎뒗 ?꾪궎?띿쿂???대뵒?먮룄 ?놁뿀??  ????                                                    ???? AX Copilot? "寃利?媛뺤젣"瑜??꾪궎?띿쿂 ?섏??먯꽌 援ы쁽   ???? ??臾몄꽌 ?덉쭏 蹂댁쬆??李⑤퀎???ъ씤??                   ????                                                    ???붴???????????????????????????????????????????????????????```

### 鍮꾧탳 ?붿빟

| ??ぉ | OpenHands | Claw Code | AX Copilot |
|------|-----------|-------------|------------|
| 諛섎났??LLM ?몄텧 | 1??| 1??| 1??+ 寃利?1??|
| 怨꾪쉷 ?앹꽦 | ??| ??| ??PlanMode |
| 寃利?媛뺤젣 | ??| ??| ??PostToolVerification |
| ?먭린 諛섏꽦 | ??| ??| ??Self-Reflection |
| 而⑦뀓?ㅽ듃 ?뺤텞 | ??| ??| ??ContextCondenser |
| ?ъ슜???뱀씤 | SecurityAnalyzer | 沅뚰븳 ?꾨＼?꾪듃 | UserDecisionCallback |
| 吏꾪뻾瑜?異붿쟻 | ??| ??| ??TaskDecomposer |
| ?쇰뱶諛??숈뒿 | ??| ??| ??FeedbackContext |

### ?뚰겕?뚮줈???꾩껜 鍮꾧탳??
```
OpenHands:
  ?붿껌 ??[LLM] ??[?꾧뎄] ??[LLM] ??[?꾧뎄] ??[LLM: "??] ???묐떟
                                                ??寃利??놁쓬

Claw Code:
  ?붿껌 ??[LLM] ??[?꾧뎄] ??[LLM] ??[?꾧뎄] ??[LLM: ?띿뒪?몃쭔] ???묐떟
                                                ??寃利??놁쓬

AX Copilot (v1.7.1):
  ?붿껌 ??[怨꾪쉷 LLM] ???뱀씤 ??[LLM] ??[?꾧뎄] ??[?낃?利?LLM?? ??[LLM] ???묐떟
           ??PlanMode        ???ㅽ뻾    ???앹꽦    ??媛뺤젣 ?뺤씤     ???꾨즺
```

---

*?묒꽦: AX Copilot 媛쒕컻? 쨌 2026-03-31*