Apex 에이전트 작업 생성
학습 목표
이 유닛을 완료하면 다음을 수행할 수 있습니다.
- Apex 에이전트 작업을 생성합니다.
- 서브에이전트에 에이전트 작업을 추가합니다.
- 에이전트 작업을 테스트합니다.
참고
한국어로 학습하시겠어요? Trailhead playground에서 한국어로 실습 과제를 시작하고, 괄호 안에 제공된 번역을 사용해 탐색해 보세요. 영어 데이터를 기반으로 실습 과제 검증이 이루어지므로 영문으로 표시된 값만 복사해 붙여 넣습니다. 한국어 조직에서 실습 과제를 통과하지 못한 경우, (1) 로캘을 미국을 바꾸고 (2) 여기에 제시된 지침에 따라 언어를 영어로 바꾼 후 (3) "Check Challenge(과제 확인)" 버튼을 눌러 다시 진행해 보세요.
원하는 언어로 Trailhead 사용하기 뱃지를 확인해 현지화된 Trailhead 경험을 활용하는 방법에 대해 자세히 알아보세요.
Apex 에이전트 작업 구축하기
이제 Apex가 준비되었으니 작업에 추가해 보겠습니다. Apex의 매개변수가 자동으로 작업에 이식되는 것을 확인할 수 있습니다.
-
App Launcher(앱 시작 관리자)(
)에서 Agentforce Studio를 검색 및 선택합니다.
-
Agent Customization(에이전트 맞춤화)을 클릭합니다.
-
New Version(새 버전)을 클릭합니다.
- 서브에이전트에서 Answer Weather Questions(날씨 질문 답변)를 선택합니다.
- Actions Available For Reasoning(추론에 사용 가능한 작업)에서 Select action(작업 선택)을 클릭하고 Create a custom action(맞춤형 작업 만들기)을 선택합니다.
- Action Name(작업 이름)에
Check Weather(날씨 확인)를 입력합니다.
- Description(설명)에
This action will return the local weather information.(이 작업은 지역 날씨 정보를 반환합니다.)을 입력합니다. - Reference Action Type(참조 작업 유형)에서 Apex를 선택합니다.
- Reference Action Category(참조 작업 범주)에서 Invocable Method(Invocable 메서드)를 선택합니다.
- Reference Action(참조 작업)에서 Check Weather(날씨 확인)를 선택합니다.
-
Create and Open(만들기 및 열기)을 클릭합니다.
Inputs(입력) 섹션에는 Apex invocable 변수의 description 매개변수에서 가져온 값이 dateToCheck의 Description(설명)에 미리 채워져 있는 것을 확인할 수 있습니다. 필요한 경우 지침을 업데이트하거나 추가할 수 있습니다.
- Require input to execute action(작업을 실행하려면 입력 필요)이 기본적으로 선택되어 있어야 합니다. 이를 위해서는 코드의 required 매개변수가 true로 설정되어야 합니다.
Outputs(출력)에는 Apex invocable 변수에서 가져온 세 가지 항목인 maxTemperature, minTemperature, temperatureDescription이 있습니다. 각각의 지침은 해당 description 매개변수와 Data Type(데이터 형식)에서 가져와 미리 채워져 있습니다.
- 세 번째 출력인 temperatureDescription에서 Show in conversation(대화에 표시)을 선택합니다.
-
Save(저장)를 클릭합니다.
-
Commit Version(버전 커밋)을 클릭합니다.
-
Commit Version(버전 커밋)을 다시 클릭합니다.
-
Activate(활성화)를 클릭합니다.
-
Activate(활성화)를 다시 클릭합니다.
잘 하셨습니다. 작업을 완료했습니다. 이제 Apex를 작업에 추가하는 데 무엇이 필요한지 알게 되었습니다. 또한 Apex 매개변수가 작업을 구성하는 데 어떻게 도움이 되는지도 더 상세히 이해했습니다. 이제 테스트해 보겠습니다.
날씨 확인하기
Agentforce 빌더로 도구에서 바로 에이전트를 활용하거나 미리 볼 수 있습니다.
- Agentforce 빌더에서 Preview(미리보기)를 클릭합니다.
- 현재 Live Test Mode(라이브 테스트 모드)여야 합니다.
- Describe your task or ask a question(작업을 설명하거나 질문하세요) 상자에서
What’s the weather like this Monday?(이번 주 월요일 날씨 어때?)를 입력하고 Enter를 누릅니다. 에이전트는 정확한 날짜를 물어보며 고를 수 있는 선택지를 제시할 수 있습니다. 다음 주 월요일 날짜를 선택하여 제출합니다.
-
에이전트가 수행한 단계를 살펴보고 요청을 처리하기 위해 Check Weather(날씨 확인) 작업을 선택한 것을 확인하세요.
잘하셨어요. 조직에 있는 모든 Apex 기능을 AI 에이전트가 사용할 수 있도록 제공하는 데 큰 진전을 이루었습니다. 에이전트를 최대한으로 활용하기 위한 모범 사례와 매개변수 설정 방법을 배웠습니다.