Apex 에이전트 작업 생성

학습 목표

이 유닛을 완료하면 다음을 수행할 수 있습니다.

Apex 에이전트 작업을 생성합니다.
주제에 에이전트 작업을 추가합니다.
에이전트 작업을 테스트합니다.

참고

한국어로 학습하시겠어요? Trailhead playground에서 한국어로 실습 과제를 시작하고, 괄호 안에 제공된 번역을 사용해 탐색해 보세요. 영어 데이터를 기반으로 실습 과제 검증이 이루어지므로 영문으로 표시된 값만 복사해 붙여 넣습니다. 한국어 조직에서 실습 과제를 통과하지 못한 경우, (1) 로캘을 미국을 바꾸고 (2) 여기에 제시된 지침에 따라 언어를 영어로 바꾼 후 (3) "Check Challenge(과제 확인)" 버튼을 눌러 다시 진행해 보세요.

원하는 언어로 Trailhead 사용하기 뱃지를 확인해 현지화된 Trailhead 경험을 활용하는 방법에 대해 자세히 알아보세요.

Apex 에이전트 작업 구축하기

이제 Apex가 준비되었으니 작업에 추가해 보겠습니다. Apex의 매개변수가 자동으로 작업에 이식되는 것을 확인할 수 있습니다.

Setup(설정)() 아이콘을 클릭하고 Setup(설정)을 선택합니다.
Setup(설정)의 Quick Find(빠른 찾기) 상자에서 Agentforce Assets(Agentforce 자산)를 검색하여 선택합니다.
Actions(작업) 탭을 클릭합니다.
New Agent Action(새 에이전트 작업)을 클릭합니다.
Reference Action Type(참조 작업 유형)에서 Apex를 선택합니다.
Reference Action Category(참조 작업 범주)에서 Invocable Method(Invocable 메서드)를 선택합니다.
Reference Action(참조 작업)에서 Check Weather(날씨 확인)를 선택합니다. 이것이 invocable 메서드입니다.

Agent Action Label(에이전트 작업 레이블)에는 invocable 메서드의 label 매개변수에서 가져와 미리 채워진 Check Weather(날씨 확인)를 그대로 둡니다.
Agent Action API Name(에이전트 작업 API 이름)에는 자동으로 생성되어 미리 채워진 Check_Weather를 그대로 둡니다.
Next(다음)를 클릭합니다.

다음 단계에서는 에이전트 작업을 구성합니다. 여기서 Apex에 설정한 매개변수의 이점을 확인할 수 있습니다.

Agent Action Instructions(에이전트 작업 지침)에는 Apex invocable 메서드의 description 매개변수에서 제공되어 채워진 값을 그대로 둡니다.
Show loading text for this action(이 작업에 대해 로드 중인 텍스트 표시)의 선택을 취소합니다.
Input(입력)에서 dateToCheck가 미리 채워져 있는 것을 확인합니다.
Instructions(지침)에는 Apex invocable 변수의 description 매개변수에서 가져온 값이 미리 채워져 있는 것을 확인합니다. 필요한 경우 지침을 수정하거나 추가할 수도 있습니다.
Data Type(데이터 형식)에는 Apex 데이터 유형이 미리 채워져 있습니다.
Required input(필수 입력)은 required 매개변수가 true로 설정되어 있어 기본적으로 선택되어 있습니다.
Collect data from user(사용자로부터 데이터 수집)를 확인합니다.

Outputs(출력)에는 Apex invocable 변수에서 가져온 세 가지 항목인 maxTemperature, minTemperature, temperatureDescription이 있습니다. 각각의 지침은 해당 description 매개변수와 Data Type(데이터 형식)에서 가져와 미리 채워져 있습니다.
세 번째 출력인 temperatureDescription에서 Show in conversation(대화에 표시)을 선택합니다.

Finish(완료)를 클릭합니다.

잘 하셨습니다. 작업을 완료했습니다. 이제 Apex를 작업에 추가하는 데 무엇이 필요한지 알게 되었습니다. 또한 Apex 매개변수가 작업을 구성하는 데 어떻게 도움이 되는지도 더 상세히 이해했습니다. 이제 날씨 확인 에이전트 작업을 주제에 추가하고 테스트해 보겠습니다.

주제 업데이트

Setup(설정)() 아이콘을 클릭하고 Setup(설정)을 선택합니다.
Setup(설정)의 Quick Find(빠른 찾기) 상자에서 Agentforce Agents(Agentforce 에이전트)를 검색하여 선택합니다.
Einstein Copilot 또는 Agentforce (Default)(Agentforce (기본값))를 선택합니다.
Open in Builder(빌더에서 열기)를 클릭합니다.
에이전트가 비활성화되었는지 확인합니다.
MigrationDefaultTopic을 선택합니다.
This Topic’s Actions(이 주제의 작업)를 클릭합니다.
New(새로 만들기)를 클릭하고, Add from Asset Library(자산 라이브러리에서 추가)를 선택합니다.
Check Weather(날씨 확인) 작업에 대한 확인란을 선택하고 Finish(완료)를 클릭합니다.
브라우저 창을 새로 고친 다음 MigrationDefaultTopic을 클릭합니다.
This Topic’s Actions(이 주제의 작업)를 클릭하고 Check Weather(날씨 확인) 작업이 아직 목록에 있는지 확인합니다. 목록에 없는 경우 8~11단계를 반복합니다. 연습 환경에서는 추가된 작업이 처음 저장한 주제와 연결된 상태로 남아 있지 않을 때가 있습니다.
Activate(활성화)를 클릭합니다. 참고: Configuration Issues Detected(구성 문제가 감지됨) 팝업이 나타나면 Ignore & Activate(무시 및 활성화)를 클릭합니다.