Agentforce Builder를 사용하며 실제로 맞닥뜨린 4가지 포인트 | Subagent · Tool · Agent Script 이전 메모

2026년 4월, Salesforce는 Agentforce의 「토픽 (Topic)」을 「서브에이전트 (Subagent)」로 명칭을 변경했습니다.

기능적인 변경은 없다고 알려져 있으나, 실제로 Agentforce Builder를 사용해 보니 화면의 표기와 문서의 표기가 아직 일치하지 않는 부분이 있어 처음에는 은근히 당혹스러웠습니다.

이 기사에서는 개념 정리보다는, 실제로 에이전트를 설계하는 과정에서 막혔던 4가지 포인트에 집중하여 작성합니다.

서브에이전트와 툴 (Tool)의 역할 분담,

에이전트 스크립트 (Agent Script)를 통한 동작 제어,

라우팅 (Routing) 정밀도를 높이기 위한 지시문 작성법 등,

직접 사용해 보고 나서야 처음 깨달은 부분들을 중심으로 정리했습니다.

Agentforce Builder의 전체적인 모습부터 알고 싶다면, 먼저 Salesforce 공식 도움말을 읽고 나서 보는 것이 이해가 빠릅니다.

Agentforce Builder는 AI 에이전트를 생성 · 커스터마이징 · 테스트하기 위한 Salesforce 상의 비주얼 인터페이스입니다. 애플리케이션 런처 (Application Launcher)에서 「Agentforce 스튜디오 (Agentforce Studio)」를 열고, 「새 에이전트 (New Agent)」 버튼을 클릭하면 Agentforce Builder가 실행됩니다.

애플리케이션 런처 → Agentforce 스튜디오 → [새 에이전트] 클릭

Agentforce 스튜디오는 크게 두 개의 페인 (Pane)으로 구성되어 있습니다.

「구축」 페인 (Build): 에이전트의 생성 · 프롬프트 템플릿 (Prompt Template) · 데이터 라이브러리 (Data Library) · AI 모델 선택 등을 관리
「관찰」 페인 (Observe): 에이전트의 분석 (Analytics)이나 세션 분석 등, 퍼포먼스 관측을 수행

에이전트를 생성할 때는 템플릿에서 선택하거나, 「이 에이전트에게 무엇을 시키고 싶은지」를 자연어로 입력하는 것 중 하나를 선택할 수 있습니다. 템플릿에는 일반적인 서브에이전트 · 툴 · 변수가 미리 포함되어 있기 때문에, **제로 베이스에서 설계하기보다 먼저 템플릿을 시도하는 것이 베스트 프랙티스 (Best Practice)**로 권장됩니다.

이용 가능한 에디션: Enterprise Edition, Performance Edition, Unlimited Edition, Developer Edition (Agentforce · Data 360 대응 버전)

서브에이전트는 에이전트가 「어떤 업무를 담당할지」를 정의하는 단위입니다. Salesforce의 도움말에서는 「서브에이전트는 에이전트가 실행할 수 있는 작업 (Job)」이라고 정의되어 있습니다.

하나의 에이전트에 여러 개의 서브에이전트를 갖게 함으로써, 문의 내용에 따라 적절한 서브에이전트로 라우팅됩니다. 예를 들어 「주문 확인」 「주소 변경」 「해지 절차」를 각각 별도의 서브에이전트로 설계하는 방식이 전형적입니다.

커스텀 서브에이전트 생성 절차:

• Agentforce Builder의 왼쪽 패널 (익스플로러)에서 「서브에이전트 (Subagent)」 옆의 「＋」 버튼을 클릭한다 -
• 「새 서브에이전트 (New Subagent)」를 선택한다
• 서브에이전트 이름과 「이 서브에이전트에게 담당시키고 싶은 일」에 대한 설명문을 입력한다
• 「생성하여 열기 (Create and Open)」를 클릭하고, **지시 (Instructions)**와 툴을 설정한다 -
• 「저장 (Save)」을 클릭한다

「지시」에는 이 서브에이전트가 어떻게 행동해야 하는지를 자연어로 기술합니다. 「제공된 툴의 데이터 이외의 Salesforce 데이터를 사용하지 말 것」이라고 명시적으로 적는 것이 베스트 프랙티스로 권장됩니다.

툴은 서브에이전트가 실제로 실행할 수 있는 처리 단위입니다. 툴에는 몇 가지 「참조 툴 유형 (Reference Tool Type)」이 있습니다.

플로우 (Flow): Salesforce Flow를 호출 (관리자가 가장 다루기 쉬운 타입) -
Apex: @InvocableMethod 어노테이션을 붙인 Apex 클래스를 호출 -
표준 툴 (Standard Tool): 레코드 조회 · 업데이트 등, 미리 준비된 처리

커스텀 툴 추가 절차 (서브에이전트 내부에서):

• 익스플로러에서 서브에이전트를 연다
• 「툴 (Tool)」 옆의 「＋」 버튼을 클릭하고 「툴 생성 (Create Tool)」을 선택한다 -
• 툴 이름을 입력하고 「생성하여 열기 (Create and Open)」를 클릭한다
• 「설명 (Description)」 (LLM에 대한 설명문) · 「참조 툴 유형 (Reference Tool Type)」 · 「참조 툴 (Reference Tool)」 (호출할 플로우나 Apex 클래스)을 설정한다
• 출력 항목의 「대화에 표시 (Show in Conversation)」 체크박스로 사용자에게 표시할지 여부를 설정한다
• 「저장 (Save)」을 클릭한다

솔직히 처음에는 툴(Tool)과 서브에이전트(Subagent)의 관계가 조금 혼란스러웠습니다. '서브에이전트는 툴을 담는 그릇'이라고 이해하니 비교적 명확하게 파악할 수 있었습니다.

에이전트 스크립트(Agent Script)는 Agentforce Builder에서 에이전트의 동작을 기술하기 위한 언어입니다. Spring '26에서 GA가 될 예정이며, 자연어의 유연성과 프로그래밍적인 확실성을 결합할 수 있습니다.

에이전트 스크립트로 할 수 있는 것들의 예시:

• 조건 분기: if/else 구문을 사용하여 변수의 값에 따라 에이전트의 발화나 실행할 툴을 전환합니다.
• 변수 관리: 대화 상태를 LLM의 컨텍스트 메모리가 아닌 변수로 확실하게 유지합니다.
• 서브에이전트 간 전이: 특정 조건에서 서브에이전트를 전환하는 타이밍을 결정론적으로 제어합니다.

Agentforce Builder에는 두 가지 뷰가 있습니다.

• 캔버스 뷰(Canvas View): 자연어로 에이전트를 설정합니다. 슬래시(/)를 입력하면 if/else 등의 식을 삽입할 수 있고, 앳(@)을 입력하면 서브에이전트, 툴, 변수 등의 리소스를 참조할 수 있습니다.
• 스크립트 뷰(Script View): 코드로 직접 에이전트 스크립트를 편집할 수 있습니다. 하이라이트 및 자동 완성, 검증 기능이 제공됩니다.

두 뷰는 자유롭게 전환 가능하며, 캔버스 뷰에서의 변경은 스크립트 뷰에도 반영되고 그 반대도 마찬가지입니다. 설계의 자유도가 높은 만큼, 초기의 스크립트 구조 설계를 잘하는 것이 나중 가독성에 영향을 미친다는 인상을 받았습니다.

테스트는 '미리보기(Preview)' 모드에서 진행하며, '상호작용 상세(Interaction Details)'에서 '어떤 서브에이전트로 라우팅되었는지', '어떤 툴이 실행되었는지', 'LLM이 어떻게 추론했는지'를 상세하게 확인할 수 있습니다.

2026년 4월 명칭 변경 후에도 문서나 화면에 따라 '토픽(Topic)'과 '서브에이전트(Subagent)'가 혼재되어 있을 수 있습니다. Salesforce 공식 설명에서는 '명칭 변경만으로 기능 변경은 없다'고 되어 있으므로, 어느 것이 나오든 같은 것으로 간주하고 읽어 나가는 것이 실제로는 빠릅니다. 특히 '기존 빌더(Legacy Builder)' 관련 도움말 문서는 오래된 용어가 그대로 남아있는 경우도 있습니다.

서브에이전트의 라우팅은 해당 서브에이전트의 설명문과 지시를 기반으로 LLM이 판단합니다. '무엇을 하는 서브에이전트인지'를 명확하게 작성하지 않으면 의도치 않은 서브에이전트로 라우팅될 수 있습니다. '이 서브에이전트가 다루지 않는 경우'를 명시적으로 작성하는 것도 효과적입니다.

툴을 설정한 후, 출력 항목의 '대화에 표시(Show in Conversation)' 체크박스를 비활성화 상태로 두면 사용자에게 결과가 표시되지 않습니다. 미리보기에서 '응답이 없다'고 느낀다면, 가장 먼저 이곳을 확인하는 것을 추천합니다.

Agentforce를 이용하려면 Enterprise Edition 이상 (또는 Agentforce/Data 360 지원 Developer Edition)이 필요합니다. 실제 환경 도입을 고려하고 있다면, 먼저 에디션과 라이선스 조건을 확인해 주십시오.

• 2026년 4월 이후, 토픽은 서브에이전트로 명칭 변경 (기능 변경 없음)
• Agentforce Builder는 Agentforce Studio에서 접근하는 AI 에이전트 설계 도구
• 서브에이전트는 '담당하는 업무의 단위', 툴은 '서브에이전트가 실행할 수 있는 처리'
• 에이전트 스크립트는 캔버스 뷰와 스크립트 뷰에서 편집 가능하며, 자연어와 코드를 결합하여 동작을 제어할 수 있습니다.
• 미리보기 모드에서 동작 확인, 상호작용 상세에서 추론 및 툴 실행의 상세를 확인할 수 있습니다.

Agentforce Builder는 설계 자유도가 높은 만큼, 초기 개념 정리가 중요하다고 느꼈습니다. 먼저 서브에이전트와 툴의 관계를 파악하고, 작게 시도하면서 확장해 나가는 접근 방식이 실무에는 적합한 것 같습니다.

AI×자격 학습·Salesforce 업무 활용 정보를 note에서도 발신하고 있습니다.