> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.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)** — 턴·토큰·비용의 안전 레일.

## 역할과 프롬프트

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

* Agent 는 누구와 대화하는가?
* 무엇에 책임이 있는가?
* 무엇이 범위 밖인가?
* 어떤 톤을 써야 하는가?
* 불확실성을 어떻게 다루어야 하는가?

예:

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

프롬프트는 블록에서 인라인으로, 또는 전체화면 에디터 (Agent 선택 시 `E`) 에서 편집합니다.

## 모델 선택

워크스페이스에 사용 가능한 모델 중에서 고릅니다. 각각 속도·비용·품질 프로필이 표시되어 있어 짐작 없이 고를 수 있습니다.

**폴백 모델** 도 설정 가능 — 프라이머리가 제한에 걸리면 Agent 가 실행을 실패시키지 않고 조용히 폴백에서 재시도합니다.

## 도구

Agent 가 호출할 수 있도록 **Tool 블록** 을 하나 이상 붙입니다. Agent 는 도구 설명을 기반으로 실행 중에 어떤 도구를 호출할지 결정합니다 — 그래서 도구 설명은 Agent 의 실질적인 프롬프트의 일부입니다. 명확하게 쓰세요.

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

## 데이터 소스

Agent 가 리트리벌할 수 있도록 **Documents** 와 **Memory space** 를 붙입니다. 붙임은 Agent 별입니다 (Flow 별이 아님) — 같은 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** — 싱글턴: 입력 받고 출력 만들고 끝. 파이프라인 스텝에 좋음.