에이전트 요소 만들기
Agentforce 에이전트를 사용하여 플로에서 동적으로 과업을 처리합니다. 기존 에이전트를 선택하거나 사용자 정의 지침 및 작업을 사용하여 에이전트를 만듭니다.
필수 Edition
권한
플로에서 기존 에이전트를 사용하려면 설정 보기 사용자 권한이 필요합니다. Flow Builder에서 에이전트를 만들려면 응용 프로그램 사용자 정의, Einstein Copilot Builder, Einstein Agent Platform Builder 또는 셀프 서비스 Copilot Builder 사용자 권한이 필요합니다. 시스템 관리자 프로필이 있는 사용자는 에이전트를 만들고 사용할 수 있습니다.
에이전트를 만들 수 있는 권한이 없는 경우 에이전트 선택 패널에 에이전트 만들기 버튼이 표시되지 않습니다. 기존 에이전트만 선택할 수 있습니다.
사용
플로에 에이전트 만들기 요소를 추가합니다. 에이전트 필드에서 활성 에이전트를 검색하여 선택하거나 에이전트 만들기를 클릭하여 새 에이전트를 만듭니다.
기존 에이전트 선택
기존 에이전트를 사용하려면 에이전트 필드에서 이름으로 에이전트를 검색합니다. 활성 에이전트만 목록에 표시됩니다. 에이전트를 선택한 후 속성 패널에서 에이전트의 입력과 출력을 구성합니다.
새 에이전트 만들기
에이전트를 만들려면 에이전트 만들기를 클릭합니다. 새 에이전트 창에서 에이전트의 기본 정보를 구성합니다.
| 필드 | 설명 |
|---|---|
| 레이블 | 에이전트의 이름입니다. |
| API 이름 | 고유성에 대한 요구 사항은 현재 플로 내의 요소에만 적용됩니다. 두 요소가 서로 다른 플로에서 사용되는 경우 동일한 API 이름을 가질 수 있습니다.API 이름은 공백 없이 밑줄과 영숫자를 포함할 수 있습니다. 이름은 문자로 시작해야 하며 밑줄로 끝날 수는 없습니다. 또한 밑줄을 연속으로 두 번 사용할 수 없습니다. |
| 설명 | 에이전트가 수행하는 작업에 대한 설명입니다. |
| 사용자 액세스 | 에이전트가 실행하는 사용자 레코드입니다. 기존 사용자를 선택하거나 시스템에서 사용자를 만듭니다. |
| 명령 | 에이전트의 작업을 설명하고 추론을 안내하는 지침입니다. |
| 작업 | 에이전트가 사용할 수 있는 작업입니다. 자산 라이브러리에서 기존 작업을 선택하거나 사용자 정의 작업을 만듭니다. |
에이전트에 작업 추가
과업을 수행하려면 에이전트에게 하나 이상의 작업이 필요합니다. 만들기 및 활성화를 클릭하기 전에 또는 에이전트를 활성화한 후 Agentforce 빌더에서 작업을 추가합니다.
기존 작업을 선택하려면 작업 선택을 클릭합니다. 자산 라이브러리에서 하나 이상의 작업을 검색하여 선택한 다음, 에이전트에 추가를 클릭합니다. 사용 가능한 작업에는 Knowledge 작업, 호출 가능한 작업으로 구성된 플로, 표준 작업이 포함됩니다.
작업을 만들려면 작업 만들기를 클릭합니다. 만들기 작업 창에서 작업을 구성합니다.
| 필드 | 상세 설명 |
|---|---|
| 에이전트 도구 레이블 | 작업의 이름입니다. |
| API 이름 | 고유성에 대한 요구 사항은 현재 플로 내의 요소에만 적용됩니다. 두 요소가 서로 다른 플로에서 사용되는 경우 동일한 API 이름을 가질 수 있습니다.API 이름은 공백 없이 밑줄과 영숫자를 포함할 수 있습니다. 이름은 문자로 시작해야 하며 밑줄로 끝날 수는 없습니다. 또한 밑줄을 연속으로 두 번 사용할 수 없습니다. |
| 설명 | 작업의 이름입니다. 에이전트가 이 정보를 사용하여 이 작업을 사용하는 방법과 시기를 결정합니다. |
| 참조 작업 유형 | 작업 유형입니다(예: Flow 또는 Apex). |
| 참조 작업 범주 | 참조 작업 유형의 하위 유형입니다. 일부 작업에는 참조 작업 범주가 없습니다. |
| 참조 작업 | 참조할 작업의 이름입니다. |
각 입력에 대해 입력이 수행하는 작업에 대한 설명을 추가합니다. 에이전트가 설명을 사용하여 작업을 호출할 때 입력을 사용하는 방법을 결정합니다. 입력이 필요한 작업 실행에 입력 필요을 선택합니다.
각 출력에 대해 출력 반환 및 플로에서 결과를 사용하는 방법에 대한 설명을 추가합니다. 에이전트의 추론에서 출력을 제외하려면 에이전트 컨텍스트에서 필터를 선택합니다. 에이전트의 응답에 이 출력을 포함하려면 대화에서 보기를 선택합니다.
에이전트를 만들고 활성화하려면 만들기 및 활성화를 클릭합니다.
요소 구성
에이전트를 선택하거나 만든 후 속성 패널에서 에이전트 만들기 요소를 구성합니다.
| 필드 | 설명 |
|---|---|
| 레이블 | 캔버스 및 도구 상자 관리자의 작업에 대한 레이블입니다. |
| API 이름 | 고유성에 대한 요구 사항은 현재 플로 내의 요소에만 적용됩니다. 두 요소가 서로 다른 플로에서 사용되는 경우 동일한 API 이름을 가질 수 있습니다.API 이름은 공백 없이 밑줄과 영숫자를 포함할 수 있습니다. 이름은 문자로 시작해야 하며 밑줄로 끝날 수는 없습니다. 또한 밑줄을 연속으로 두 번 사용할 수 없습니다. |
| 설명 | 요소에 대한 설명입니다. |
입력 값 설정
속성 패널에서 에이전트 만들기 요소의 입력을 구성합니다.
| 필드 | 상세 설명 |
|---|---|
| 에이전트 요청 | 이 플로 실행을 위해 에이전트에게 보내는 질문 또는 요청입니다. 에이전트가 이 특정 요청에 지침을 적용하여 출력을 생성합니다. |
| 세션 ID | (선택 사항) 플로의 이전에 실행되는 에이전트 만들기 요소에서 반환된 세션 ID를 사용합니다. 에이전트는 해당 대화의 전체 추론 컨텍스트와 메모리를 유지합니다. 세션 ID를 제공하지 않을 경우 에이전트가 새 대화를 시작하지만, 항상 이전 에이전트 만들기 요소의 출력을 입력으로 지정할 수 있습니다. |
구조화된 출력 구성
에이전트가 플로에서 사용할 수 있는 구조화된 데이터를 반환하도록 구성하려면 구조화된 출력 필드를 정의합니다. 각 필드는 에이전트가 추출하거나 생성하는 정보의 일부를 나타냅니다.
구조화된 출력을 구성하는 경우 에이전트가 구조화된 에이전트 응답 필드의 구조화된 데이터만 반환합니다. 에이전트 응답 필드는 null를 반환합니다. 구조화된 출력을 구성하지 않을 경우 에이전트가 에이전트 응답 필드의 구조화되지 않은 텍스트만 반환합니다.
구조화된 출력을 구성하려면 구성을 클릭합니다. 각 구조화된 출력 필드에 대한 필드를 구성합니다.
| 필드 | 상세 설명 |
|---|---|
| 필드 이름 | (필수) 구조화된 출력 필드의 고유한 영숫자 이름입니다. 이름에는 특수 문자 또는 공백을 포함할 수 없습니다. |
| 상세 설명 | 대규모 언어 모델(LLM) 정확성을 높이기 위해 필드 이름과 함께 사용되는 간단한 설명입니다. |
| 데이터 유형 | (필수) 필드의 데이터 유형입니다. 유효한 값: 문자열, 숫자, 부울. |
| 필수 | LLM이 이 출력 필드에 대한 응답을 생성해야 함을 나타냅니다. 출력 행을 요구하면 LLM의 응답이 부정확하거나 유해할 수 있습니다. |
출력 값 저장
| 필드 | 상세 설명 |
|---|---|
| 에이전트 응답 | 에이전트의 비정형 응답입니다. 구조화된 출력이 구성된 경우 null을 반환합니다. |
| 세션 ID | 에이전트 응답이 있는 대화 세션의 ID입니다. |
| 정형 에이전트 응답 | 에이전트의 구조화된 출력입니다. 구조화된 출력이 구성되지 않은 경우 null을 반환합니다. |
구조화된 출력 사용량
구조화된 출력을 구성하기 전에 에이전트 만들기 요소에 대한 레이블 및 API 이름을 입력한 다음, 플로를 저장합니다.
구조화된 출력을 구성할 경우 저장하기 전에 하나 이상의 구조화된 출력 필드를 정의합니다.
정의된 각 구조화된 출력 필드에 대해 정의된 이름과 관련 부울 _set 필드가 있는 두 개의 필드가 생성됩니다. 예를 들어, summary라는 구조화된 출력 필드를 정의한 경우 summary_set라는 부울 필드도 생성됩니다.
| 필드 | 상세 설명 |
|---|---|
| True | 구조화된 에이전트 응답에 필드가 포함되었지만 설정 값이 없습니다. |
| False | 구조화된 에이전트 응답에 필드가 포함되지 않았습니다. |
정의된 구조화된 출력이 null을 반환하면 플로의 나중에 관련 _set 필드를 사용하여 필드가 null인 이유를 확인합니다.
사용 메모
- 활성화하기 전에 플로를 테스트하여 에이전트 만들기 요소가 예상대로 작동하는지 확인합니다.
- Agentforce 빌더에서 Flow Builder에서 만든 에이전트를 언제든지 찾고 편집할 수 있습니다.
- API 버전 67.0부터 더 이상 작업 요소에서 AI 에이전트 작업을 사용할 수 없습니다. 에이전트 만들기 요소를 사용하여 에이전트와 작업합니다. AI 에이전트 작업을 참조하는 작업 요소가 있는 플로를 열면 자동으로 에이전트 만들기 요소로 표시됩니다. 원래 구성이 유지됩니다.
