Skip to main content
Agent 블록은 워크플로우가 생각하는 곳입니다. Flow마다 적어도 하나는 있습니다. Agent는 네 가지를 정합니다.
  1. 역할(role) 무엇을 하는지 자연어로 적은 지시.
  2. 모델(model) 어떤 밑바탕 LLM을 쓸지.
  3. 도구·데이터 부르고 읽어도 되는 것.
  4. 제한(limits) 턴, 토큰, 비용의 안전 레일.
Agent 인스펙터 — 이름, 설명, 시스템 프롬프트가 일반 탭에 놓여 있다

역할과 프롬프트

역할은 Agent의 시스템 프롬프트를 자연어로 쓴 것입니다. 새 팀원을 들이듯 씁니다.
  • Agent는 누구와 대화하나?
  • 무엇을 책임지나?
  • 무엇은 범위 밖인가?
  • 어떤 톤을 써야 하나?
  • 확신이 없을 때 어떻게 다뤄야 하나?
예를 들면 이렇습니다.
너는 핀테크 앱의 고객 지원 어시스턴트야. 계좌 잔액, 수수료표, 송금 상태에 관한 질문에 답해. 법률이나 세무 자문에 닿는 질문이면 escalate_to_human을 걸어 사람에게 넘겨. 쓴 정책 문서는 늘 인용해.
프롬프트는 블록에서 바로 고치거나, 전체화면 에디터(Agent를 고르고 E)에서 고칩니다.

모델 고르기

워크스페이스에서 쓸 수 있는 모델 중에 고릅니다. 저마다 속도, 비용, 품질이 표시돼 있어 짐작 없이 고를 수 있습니다. 폴백 모델도 둘 수 있습니다. 주 모델이 제한에 걸리면 Agent가 실행을 실패시키지 않고 폴백에서 조용히 다시 시도합니다.

도구

Agent가 부를 수 있도록 Tool 블록을 하나 이상 붙입니다. Agent는 도구 설명을 보고 실행 중에 어느 도구를 부를지 정합니다. 그래서 도구 설명이 사실상 Agent 프롬프트의 일부입니다. 분명하게 쓰세요. 도구는 인스펙터의 Tools 섹션에서 붙입니다. 순서를 바꿔 우선순위를 넌지시 줄 수 있습니다.

데이터 소스

Agent가 리트리벌할 수 있도록 DocumentsMemory space를 붙입니다. 붙임은 Flow 단위가 아니라 Agent 단위입니다. 같은 Flow 안의 다른 Agent가 다른 지식을 가질 수 있죠. 에이전트에 데이터 붙이기Memory space를 참고하세요.

제한

노브가 셋이고 다 선택입니다.
  • Max turns Agent가 실행을 끝내기 전에 오갈 수 있는 도구 호출 왕복 수. 기본은 Flow 수준 상한입니다.
  • Max tokens 실행 하나의 모든 모델 호출을 합친 토큰.
  • Max cost 실행당 USD 상한. 이걸 넘길 실행은 멈추고 트레이스에 표시됩니다.
작업을 해낼 만큼은 높게, 폭주 루프에서 지켜 줄 만큼은 낮게 잡으세요.

승인

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

모드

Agent는 두 모드 중 하나로 돕니다.
  • Chat 여러 턴, 대화형, 같은 세션의 이전 턴을 기억합니다.
  • Task 한 턴입니다. 입력을 받아 출력을 내고 끝냅니다. 파이프라인 스텝에 좋습니다.