
Agent Script 조건 분기 작성법 | 신규 Agentforce Builder로 AI 판단과 확정 로직을 결합하는 실습 가이드
요약
Agentforce Builder의 신규 기능인 Agent Script 조건 분기 작성법을 다룹니다. AI의 판단과 확정 규칙을 결합하는 방법과 캔버스/스크립트 뷰 활용법을 단계별로 설명합니다.
핵심 포인트
- Agent Script를 통해 AI 판단과 확정 규칙을 하나의 대본으로 결합 가능
- 캔버스 뷰와 스크립트 뷰를 통해 시각적 또는 코드로 편집 가능
- 변수 타입(Boolean, Number, String)에 따른 정확한 값 입력 필수
- 멀티 에이전트 오케스트레이션은 현재 베타 기능으로 권장 테스트 필요
서론
'Agentforce의 새로운 Builder, 조건 분기가 나오는데 어려울 것 같아...'라고 생각하고 계신가요?
저도 처음에는 그랬습니다. 캔버스 뷰를 열자마자 생소한 블록들이 늘어서 있고 '우와, 외워야 할 게 많아졌네...'라며 긴장했습니다.
하지만 실제로 만져보니 Agent Script의 조건 분기는 생각보다 훨씬 간단했습니다. 오늘은 그 개념과 작성법을 1년 차였던 저 자신에게 가르쳐준다는 마음으로 정리해 보겠습니다.
Agentforce Builder의 조건 분기나 Agent Script 작성이 궁금한 분들은 꼭 끝까지 읽어보세요.
애초에 Agent Script란 무엇인가?
새로운 Agentforce Builder에서는 에이전트의 움직임을 'Agent Script'라는 언어로 작성합니다.
쉽게 말해, AI의 자유로운 판단과 사람이 정한 확정 규칙을 하나의 대본으로 묶을 수 있는 시스템입니다. 엑셀로 비유하자면, 셀에 문장을 쓰면서 IF 함수도 혼용할 수 있는 느낌과 가깝습니다.
Agent Script에는 두 가지 형태가 있습니다. 블록으로 표시되는 '캔버스 뷰'와 코드로 직접 작성할 수 있는 '스크립트 뷰'입니다.
어느 쪽으로 편집해도 내용은 같기 때문에, 처음에는 캔버스 뷰만 만져봐도 충분합니다. 익숙해지면 스크립트 뷰를 한번 들여다보는 정도가 적당하다고 생각합니다.

즉, 캔버스 뷰로 시작해서 익숙해지면 스크립트 뷰를 확인하는 것으로 이해하시면 됩니다!
if/else 작성법 [단계별 가이드]
실제로 if/else를 작성하는 절차를 살펴보겠습니다.
- Agentforce Studio를 열고 대상 에이전트를 선택합니다.
- 탐색기 패널에서 서브 에이전트를 선택하고, 캔버스 뷰에서 지시(Instructions)를 엽니다.
- 지시 입력란에 '/'를 입력하여 인라인 액션 후보를 표시합니다.
- 후보 목록에서 조건 스테이트먼트(if/else)를 선택합니다.
- 조건에 사용할 변수를 '@'로 호출합니다. 변수 이름을 입력하면 후보가 나오므로, 대상 변수를 선택합니다.
- 연산자와 비교할 값을 입력합니다. 값의 형식은 변수의 타입에 따라 결정되는데, 참/거짓(Boolean)이면 True/False, 숫자는 그대로 60 같은 숫자, 문자열은
주의사항! 실수하기 쉬운 포인트
새로운 Agentforce Builder와 조건 분기(Conditional Branching) 기능은 Enterprise Edition, Performance Edition, Unlimited Edition, Developer Edition에서 사용할 수 있지만, 에이전트의 종류에 따라 필요한 애드온 라이스스(Add-on License)가 달라지므로 주의해야 합니다!
계약 중인 에디션에서 대상 에이전트 유형을 사용할 수 있는지 사전에 확인해 두는 것이 안심할 수 있는 방법입니다.
또한, 조건문(Conditional Statement)에서 지정하는 값은 변수의 타입(Type)에 따라 작성 방식이 결정됩니다. 숫자로 의도하고 "60"과 같이 큰따옴표를 붙여 작성하면 문자열(String)로 취급되어 에러가 발생할 수 있습니다. 저도 처음에는 이 타입의 차이를 인지하지 못해, 한동안 조건이 반응하지 않는 원인을 찾느라 고생했습니다.
참고로, 여러 서브 에이전트가 연계되는 멀티 에이전트 오케스트레이션(Multi-agent Orchestration) 기능은 이번에 조사한 시점 기준으로 베타(Beta) 기능으로 취급되고 있습니다. 실제 운영되는 중요한 업무 흐름(Workflow)에 도입하기 전에, 베타 기능이라는 점을 고려하여 검증 환경에서 충분히 테스트하는 것을 권장합니다.
추가 비용에 대해서는, 이번에 조사한 범위 내에서는 새로운 Agentforce Builder 자체나 Agent Script 이용에 특별한 추가 과금이 있다는 기재는 발견되지 않았습니다. 다만 Agentforce 이용 자체에 Flex Credits나 Agentforce 관련 라이선스 비용이 발생하므로, 계약 내용은 영업 담당자나 공식 요금 페이지를 통해 확인하시기 바랍니다.
요약
오늘의 핵심 포인트를 정리합니다.
- Agent Script는 자연어의 유연함과 확정 로직(Deterministic Logic)의 신뢰성을 하나의 스크립트로 양립시키는 메커니즘
- 캔버스 뷰(Canvas View)에서는 "/"로 인라인 액션(Inline Action)을, "@"로 변수 등의 리소스를 호출할 수 있음
- 조건문의 값은 변수의 타입에 따라 형식이 결정됨 (Boolean, 숫자, 문자열, 리스트, 객체)
- 금액과 같이 타협할 수 없는 기준은 AI의 판단에 맡기지 말고 인라인 액션이나 검색 조건으로 확정하는 것이 안전함
새로운 Agentforce Builder가 처음에는 조금 어렵게 느껴질 수 있지만, 함께 조금씩 익숙해져 봅시다!
AI × 자격증 학습 정보를 note에서 발신하고 있습니다.
→ note
Discussion

AI 자동 생성 콘텐츠
본 콘텐츠는 Zenn AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기