> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent 블록

> 모든 Flow의 추론 심장. 역할, 모델, 도구, 메모리

**Agent 블록**은 워크플로우가 생각하는 곳입니다. Flow마다 적어도 하나는 있습니다. Agent는 네 가지를 정합니다.

1. **역할(role)** 무엇을 하는지 자연어로 적은 지시.
2. **모델(model)** 어떤 밑바탕 LLM을 쓸지.
3. **도구·데이터** 부르고 읽어도 되는 것.
4. **제한(limits)** 턴, 토큰, 비용의 안전 레일.

<Frame>
  <img src="https://mintcdn.com/conscience-technology/Jo24V8Wx9hATIxJq/images/docs/workflow-agent-inspector.png?fit=max&auto=format&n=Jo24V8Wx9hATIxJq&q=85&s=df928c17d6c6b7f6df56b0efb9df056a" width="400" alt="Agent 인스펙터 — 이름, 설명, 시스템 프롬프트가 일반 탭에 놓여 있다" data-path="images/docs/workflow-agent-inspector.png" />
</Frame>

## 역할과 프롬프트

역할은 Agent의 시스템 프롬프트를 자연어로 쓴 것입니다. 새 팀원을 들이듯 씁니다.

* Agent는 누구와 대화하나?
* 무엇을 책임지나?
* 무엇은 범위 밖인가?
* 어떤 톤을 써야 하나?
* 확신이 없을 때 어떻게 다뤄야 하나?

예를 들면 이렇습니다.

> 너는 핀테크 앱의 고객 지원 어시스턴트야. 계좌 잔액, 수수료표, 송금 상태에 관한 질문에 답해. 법률이나 세무 자문에 닿는 질문이면 `escalate_to_human`을 걸어 사람에게 넘겨. 쓴 정책 문서는 늘 인용해.

프롬프트는 블록에서 바로 고치거나, 전체화면 에디터(Agent를 고르고 `E`)에서 고칩니다.

## 모델 고르기

워크스페이스에서 쓸 수 있는 모델 중에 고릅니다. 저마다 속도, 비용, 품질이 표시돼 있어 짐작 없이 고를 수 있습니다.

**폴백 모델**도 둘 수 있습니다. 주 모델이 제한에 걸리면 Agent가 실행을 실패시키지 않고 폴백에서 조용히 다시 시도합니다.

## 도구

Agent가 부를 수 있도록 **Tool 블록**을 하나 이상 붙입니다. Agent는 도구 설명을 보고 실행 중에 어느 도구를 부를지 정합니다. 그래서 도구 설명이 사실상 Agent 프롬프트의 일부입니다. 분명하게 쓰세요.

도구는 인스펙터의 **Tools** 섹션에서 붙입니다. 순서를 바꿔 우선순위를 넌지시 줄 수 있습니다.

## 데이터 소스

Agent가 리트리벌할 수 있도록 **Documents**와 **Memory space**를 붙입니다. 붙임은 Flow 단위가 아니라 Agent 단위입니다. 같은 Flow 안의 다른 Agent가 다른 지식을 가질 수 있죠.

[에이전트에 데이터 붙이기](/ko/build/knowledge/attach)와 [Memory space](/ko/build/memory/spaces)를 참고하세요.

## 제한

노브가 셋이고 다 선택입니다.

* **Max turns** Agent가 실행을 끝내기 전에 오갈 수 있는 도구 호출 왕복 수. 기본은 Flow 수준 상한입니다.
* **Max tokens** 실행 하나의 모든 모델 호출을 합친 토큰.
* **Max cost** 실행당 USD 상한. 이걸 넘길 실행은 멈추고 트레이스에 표시됩니다.

작업을 해낼 만큼은 높게, 폭주 루프에서 지켜 줄 만큼은 낮게 잡으세요.

## 승인

특정 결과를 게이트로 막으려면 **Require approval**을 켭니다. 켜면 Agent 응답이 Approvals 큐에 멈춰, 리뷰어가 승인하거나 거부하거나 고칠 때까지 기다립니다. [승인](/ko/reliable/optimization/approve)을 참고하세요.

## 모드

Agent는 두 모드 중 하나로 돕니다.

* **Chat** 여러 턴, 대화형, 같은 세션의 이전 턴을 기억합니다.
* **Task** 한 턴입니다. 입력을 받아 출력을 내고 끝냅니다. 파이프라인 스텝에 좋습니다.
