andre/crewAI
1
0
Fork 0
mirror of https://github.com/crewAIInc/crewAI.git synced 2026-07-01 13:18:10 +00:00
Code Issues Actions 6 Packages Projects Releases Wiki Activity
Files
4cb2ecd9481004e31b8ea38dfa36fca372d88421
crewAI/docs/ko/enterprise/integrations/salesforce.mdx
Lucas Gomide 1bac7d3afb document one-time admin package install step (#5941) 
* docs: document one-time admin package install step

The previous revision described a manual "install in Salesforce first,
then connect from AMP" flow that nobody actually follows, and linked to
a private repo customers can't access.

* docs: point Integrations link at crewai_plus/unified_tools
2026-05-26 19:06:51 -04:00

731 lines
30 KiB
Plaintext
Raw Blame History

---
title: Salesforce 통합
description: "CrewAI를 위한 Salesforce 통합을 통한 CRM 및 영업 자동화."
icon: "salesforce"
mode: "wide"
---
## 개요
에이전트가 Salesforce를 통해 고객 관계, 영업 프로세스 및 데이터를 관리할 수 있도록 합니다. 레코드를 생성 및 업데이트하고, 리드와 기회를 관리하며, SOQL 쿼리를 실행하고, AI 기반 자동화로 CRM 워크플로를 간소화하세요.
## 사전 준비 사항
Salesforce 통합을 사용하기 전에 다음을 확인하세요:
- 활성 구독이 있는 [CrewAI AMP](https://app.crewai.com) 계정
- 적절한 권한이 있는 Salesforce 계정
- [통합 페이지](https://app.crewai.com/integrations)를 통해 Salesforce 계정 연결
<Note>
Salesforce는 사용자가 연결하기 전에 **관리자가 CrewAI 패키지를 한 번 설치**
해야 합니다. 이는 Spring '26 릴리스부터 모든 ExternalClientApp 기반 통합에
적용되는 Salesforce 플랫폼의 요구 사항이며, CrewAI 고유의 단계가 아닙니다.
CrewAI AMP의 Connect Salesforce 플로우가 첫 연결 시 이 과정을 안내합니다.
</Note>
## Salesforce 통합 설정
### 1. Salesforce 계정 연결
1. [CrewAI AMP 통합](https://app.crewai.com/crewai_plus/unified_tools)으로 이동합니다.
2. 인증 통합 섹션에서 **Salesforce**를 찾습니다.
3. **연결**을 클릭합니다.
이후 동작은 관리자가 조직에 CrewAI 패키지를 이미 설치했는지에 따라 달라집니다:
- **패키지가 이미 설치된 경우:** 곧바로 Salesforce OAuth 동의 화면으로
이동합니다. 승인하면 연결이 완료됩니다.
- **패키지가 아직 설치되지 않은 경우:** **Install CrewAI in Salesforce**
페이지가 표시됩니다. 아래의 일회성 설치 단계를 따른 뒤, CrewAI AMP로
돌아와 **연결**을 다시 클릭하세요.
4. CRM 및 영업 관리에 필요한 권한을 부여합니다.
5. [통합 설정](https://app.crewai.com/crewai_plus/settings/integrations)에서 Enterprise Token을 복사합니다.
#### 일회성 관리자 설치 (Salesforce 관리자 전용)
조직 내 누군가 **Connect Salesforce**를 처음 클릭하면, CrewAI는 CrewAI
관리형 패키지의 설치 페이지로 리디렉션합니다. Salesforce 관리자가 조직
전체를 위해 한 번만 설치하면 됩니다.
1. CrewAI 내 설치 페이지에서 **Install in Salesforce**를 클릭합니다.
(해당 페이지 URL을 관리자에게 공유해도 됩니다. 설치 링크는 누구든 열 수
있도록 동작합니다.)
2. 관리자 권한으로 Salesforce에 로그인합니다. 샌드박스 환경에서는 URL의
`login.salesforce.com`을 `test.salesforce.com`으로 바꾼 뒤 엽니다.
3. **Install for All Users**를 선택하고, 서드파티 앱 동의 항목을 확인한 뒤
**Install**을 클릭합니다.
4. Salesforce Setup에서 **External Client App Manager** → **CrewAI App** →
**Policies** 탭 → **Edit**로 이동하여 다음과 같이 설정합니다:
- **Permitted Users:** All users may self-authorize
- **IP Relaxation:** Relax IP restrictions
- **Refresh Token Policy:** Refresh token is valid until revoked
5. 저장합니다.
6. CrewAI AMP로 돌아가 **Connect Salesforce**를 다시 클릭합니다. 이번에는
OAuth가 정상적으로 완료됩니다.
<Note>
**Salesforce 관리자가 아니신가요?** 설치 페이지의 URL(또는 설치 링크 자체)
을 Salesforce 관리자에게 전달하고 위 단계를 진행해 달라고 요청하세요.
관리자가 완료하면 CrewAI AMP로 돌아와 **연결**을 다시 클릭하면 됩니다.
</Note>
### 2. 필수 패키지 설치
```bash
uv add crewai-tools
```
### 3. 환경 변수 설정
<Note>
`Agent(apps=[])`와 함께 통합을 사용하려면 Enterprise Token으로
`CREWAI_PLATFORM_INTEGRATION_TOKEN` 환경 변수를 설정해야 합니다.
</Note>
```bash
export CREWAI_PLATFORM_INTEGRATION_TOKEN="your_enterprise_token"
```
또는 `.env` 파일에 추가하세요:
```
CREWAI_PLATFORM_INTEGRATION_TOKEN=your_enterprise_token
```
## 사용 가능한 도구
### **레코드 관리**
<AccordionGroup>
<Accordion title="salesforce/create_record_contact">
**설명:** Salesforce에서 새로운 Contact 레코드를 생성합니다.
**파라미터:**
- `FirstName` (string, 선택): 이름
- `LastName` (string, 필수): 성 - 이 필드는 필수입니다
- `accountId` (string, 선택): Account ID - 이 Contact가 소속된 Account
- `Email` (string, 선택): 이메일 주소
- `Title` (string, 선택): 담당자의 직함(예: CEO 또는 Vice President 등)
- `Description` (string, 선택): Contact에 대한 설명
- `additionalFields` (object, 선택): 사용자 정의 Contact 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/create_record_lead">
**설명:** Salesforce에서 새로운 Lead 레코드를 생성합니다.
**파라미터:**
- `FirstName` (string, 선택): 이름
- `LastName` (string, 필수): 성 - 이 필드는 필수입니다
- `Company` (string, 필수): 회사명 - 이 필드는 필수입니다
- `Email` (string, 선택): 이메일 주소
- `Phone` (string, 선택): 전화번호
- `Website` (string, 선택): 웹사이트 URL
- `Title` (string, 선택): 담당자의 직함(예: CEO 또는 Vice President 등)
- `Status` (string, 선택): 리드 상태 - 리드 상태를 선택하려면 Connect Portal Workflow 설정을 사용하세요
- `Description` (string, 선택): Lead에 대한 설명
- `additionalFields` (object, 선택): 사용자 정의 Lead 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/create_record_opportunity">
**설명:** Salesforce에서 새로운 Opportunity 레코드를 생성합니다.
**파라미터:**
- `Name` (string, 필수): Opportunity 이름 - 이 필드는 필수입니다
- `StageName` (string, 선택): Opportunity 단계 - 단계를 선택하려면 Connect Portal Workflow 설정을 사용하세요
- `CloseDate` (string, 선택): 마감일(YYYY-MM-DD 형식) - 기본값은 현재 날짜로부터 30일 이후
- `AccountId` (string, 선택): 이 Opportunity가 소속된 Account
- `Amount` (string, 선택): 예상 전체 판매 금액
- `Description` (string, 선택): Opportunity에 대한 설명
- `OwnerId` (string, 선택): 이 Opportunity를 담당하는 Salesforce 사용자
- `NextStep` (string, 선택): Opportunity 마감을 위한 다음 작업의 설명
- `additionalFields` (object, 선택): 사용자 정의 Opportunity 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/create_record_task">
**설명:** Salesforce에서 새로운 Task 레코드를 생성합니다.
**파라미터:**
- `whatId` (string, 선택): 관련 ID - 이 Task가 관련된 Account 또는 Opportunity의 ID
- `whoId` (string, 선택): 이름 ID - 이 Task가 관련된 Contact 또는 Lead의 ID
- `subject` (string, 필수): 작업 제목
- `activityDate` (string, 선택): 작업 날짜(YYYY-MM-DD 형식)
- `description` (string, 선택): Task에 대한 설명
- `taskSubtype` (string, 필수): Task 하위 유형 - 선택 항목: task, email, listEmail, call
- `Status` (string, 선택): 상태 - 선택 항목: Not Started, In Progress, Completed
- `ownerId` (string, 선택): 담당자 ID - 이 Task를 담당하는 Salesforce 사용자
- `callDurationInSeconds` (string, 선택): 통화 시간(초)
- `isReminderSet` (boolean, 선택): 알림 설정 여부
- `reminderDateTime` (string, 선택): 알림 날짜/시간(ISO 형식)
- `additionalFields` (object, 선택): 사용자 정의 Task 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/create_record_account">
**설명:** Salesforce에서 새로운 Account 레코드를 생성합니다.
**파라미터:**
- `Name` (string, 필수): Account 이름 - 이 필드는 필수입니다
- `OwnerId` (string, 선택): 이 Account를 담당하는 Salesforce 사용자
- `Website` (string, 선택): 웹사이트 URL
- `Phone` (string, 선택): 전화번호
- `Description` (string, 선택): Account 설명
- `additionalFields` (object, 선택): 사용자 정의 Account 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/create_record_any">
**설명:** Salesforce에서 모든 오브젝트 유형의 레코드를 생성합니다.
**참고:** 이 기능은 사용자 정의 또는 알려지지 않은 오브젝트 유형의 레코드를 생성할 때 유연하게 사용할 수 있습니다.
</Accordion>
</AccordionGroup>
### **레코드 업데이트**
<AccordionGroup>
<Accordion title="salesforce/update_record_contact">
**설명:** Salesforce에서 기존 연락처(Contact) 레코드를 업데이트합니다.
**파라미터:**
- `recordId` (string, 필수): 업데이트할 레코드의 ID
- `FirstName` (string, 선택): 이름
- `LastName` (string, 선택): 성
- `accountId` (string, 선택): 계정 ID - 연락처가 속한 계정
- `Email` (string, 선택): 이메일 주소
- `Title` (string, 선택): 연락처의 직함
- `Description` (string, 선택): 연락처에 대한 설명
- `additionalFields` (object, 선택): 커스텀 연락처 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/update_record_lead">
**설명:** Salesforce에서 기존 리드(Lead) 레코드를 업데이트합니다.
**파라미터:**
- `recordId` (string, 필수): 업데이트할 레코드의 ID
- `FirstName` (string, 선택): 이름
- `LastName` (string, 선택): 성
- `Company` (string, 선택): 회사명
- `Email` (string, 선택): 이메일 주소
- `Phone` (string, 선택): 전화번호
- `Website` (string, 선택): 웹사이트 URL
- `Title` (string, 선택): 연락처의 직함
- `Status` (string, 선택): 리드 상태
- `Description` (string, 선택): 리드에 대한 설명
- `additionalFields` (object, 선택): 커스텀 리드 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/update_record_opportunity">
**설명:** Salesforce에서 기존 기회(Opportunity) 레코드를 업데이트합니다.
**파라미터:**
- `recordId` (string, 필수): 업데이트할 레코드의 ID
- `Name` (string, 선택): 기회명
- `StageName` (string, 선택): 기회 단계
- `CloseDate` (string, 선택): 마감 날짜 (YYYY-MM-DD 형식)
- `AccountId` (string, 선택): 기회가 속한 계정
- `Amount` (string, 선택): 예상 총 판매 금액
- `Description` (string, 선택): 기회에 대한 설명
- `OwnerId` (string, 선택): 이 기회를 담당하는 Salesforce 사용자
- `NextStep` (string, 선택): 기회 마감을 위한 다음 작업의 설명
- `additionalFields` (object, 선택): 커스텀 기회 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/update_record_task">
**설명:** Salesforce에서 기존 작업(Task) 레코드를 업데이트합니다.
**파라미터:**
- `recordId` (string, 필수): 업데이트할 레코드의 ID
- `whatId` (string, 선택): 관련 ID - 이 작업이 연결된 계정 또는 기회의 ID
- `whoId` (string, 선택): 이름 ID - 이 작업이 연결된 연락처 또는 리드의 ID
- `subject` (string, 선택): 작업의 주제
- `activityDate` (string, 선택): 활동 날짜 (YYYY-MM-DD 형식)
- `description` (string, 선택): 작업에 대한 설명
- `Status` (string, 선택): 상태 - 옵션: Not Started, In Progress, Completed
- `ownerId` (string, 선택): 담당자 ID - 이 작업을 할당받은 Salesforce 사용자
- `callDurationInSeconds` (string, 선택): 통화 시간(초)
- `isReminderSet` (boolean, 선택): 알림 설정 여부
- `reminderDateTime` (string, 선택): 알림 날짜/시간 (ISO 형식)
- `additionalFields` (object, 선택): 커스텀 작업 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/update_record_account">
**설명:** Salesforce에서 기존 계정(Account) 레코드를 업데이트합니다.
**파라미터:**
- `recordId` (string, 필수): 업데이트할 레코드의 ID
- `Name` (string, 선택): 계정 이름
- `OwnerId` (string, 선택): 이 계정에 할당된 Salesforce 사용자
- `Website` (string, 선택): 웹사이트 URL
- `Phone` (string, 선택): 전화번호
- `Description` (string, 선택): 계정 설명
- `additionalFields` (object, 선택): 커스텀 계정 필드를 위한 JSON 형식의 추가 필드
</Accordion>
<Accordion title="salesforce/update_record_any">
**설명:** Salesforce에서 어떤 객체 유형이든 레코드를 업데이트합니다.
**참고:** 이는 커스텀 또는 미확인 객체 유형의 레코드 업데이트를 위한 유연한 도구입니다.
</Accordion>
</AccordionGroup>
### **레코드 조회**
<AccordionGroup>
<Accordion title="salesforce/get_record_by_id_contact">
**설명:** ID로 Contact 레코드를 조회합니다.
**파라미터:**
- `recordId` (string, 필수): Contact의 레코드 ID
</Accordion>
<Accordion title="salesforce/get_record_by_id_lead">
**설명:** ID로 Lead 레코드를 조회합니다.
**파라미터:**
- `recordId` (string, 필수): Lead의 레코드 ID
</Accordion>
<Accordion title="salesforce/get_record_by_id_opportunity">
**설명:** ID로 Opportunity 레코드를 조회합니다.
**파라미터:**
- `recordId` (string, 필수): Opportunity의 레코드 ID
</Accordion>
<Accordion title="salesforce/get_record_by_id_task">
**설명:** ID로 Task 레코드를 조회합니다.
**파라미터:**
- `recordId` (string, 필수): Task의 레코드 ID
</Accordion>
<Accordion title="salesforce/get_record_by_id_account">
**설명:** ID로 Account 레코드를 조회합니다.
**파라미터:**
- `recordId` (string, 필수): Account의 레코드 ID
</Accordion>
<Accordion title="salesforce/get_record_by_id_any">
**설명:** ID로 임의 객체 유형의 레코드를 조회합니다.
**파라미터:**
- `recordType` (string, 필수): 레코드 유형 (예: "CustomObject__c")
- `recordId` (string, 필수): 레코드 ID
</Accordion>
</AccordionGroup>
### **레코드 검색**
<AccordionGroup>
<Accordion title="salesforce/search_records_contact">
**설명:** 고급 필터링으로 연락처(Contact) 레코드를 검색합니다.
**파라미터:**
- `filterFormula` (object, 선택): 필드별 연산자가 지정된 분리적 정규형(Disjunctive Normal Form)의 고급 필터
- `sortBy` (string, 선택): 정렬 기준 필드 (예: "CreatedDate")
- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/search_records_lead">
**설명:** 고급 필터링으로 리드(Lead) 레코드를 검색합니다.
**파라미터:**
- `filterFormula` (object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터
- `sortBy` (string, 선택): 정렬 기준 필드 (예: "CreatedDate")
- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/search_records_opportunity">
**설명:** 고급 필터링으로 기회(Opportunity) 레코드를 검색합니다.
**파라미터:**
- `filterFormula` (object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터
- `sortBy` (string, 선택): 정렬 기준 필드 (예: "CreatedDate")
- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/search_records_task">
**설명:** 고급 필터링으로 작업(Task) 레코드를 검색합니다.
**파라미터:**
- `filterFormula` (object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터
- `sortBy` (string, 선택): 정렬 기준 필드 (예: "CreatedDate")
- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/search_records_account">
**설명:** 고급 필터링으로 계정(Account) 레코드를 검색합니다.
**파라미터:**
- `filterFormula` (object, 선택): 필드별 연산자가 지정된 분리적 정규형의 고급 필터
- `sortBy` (string, 선택): 정렬 기준 필드 (예: "CreatedDate")
- `sortDirection` (string, 선택): 정렬 방향 - 옵션: ASC, DESC
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/search_records_any">
**설명:** 모든 오브젝트 유형의 레코드를 검색합니다.
**파라미터:**
- `recordType` (string, 필수): 검색할 레코드 유형
- `filterFormula` (string, 선택): 필터 검색 조건
- `includeAllFields` (boolean, 선택): 결과에 모든 필드를 포함
- `paginationParameters` (object, 선택): pageCursor를 포함한 페이지네이션 설정
</Accordion>
</AccordionGroup>
### **리스트 뷰 조회**
<AccordionGroup>
<Accordion title="salesforce/get_record_by_view_id_contact">
**설명:** 특정 리스트 뷰에서 Contact 레코드를 가져옵니다.
**파라미터:**
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_lead">
**설명:** 특정 리스트 뷰에서 Lead 레코드를 가져옵니다.
**파라미터:**
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_opportunity">
**설명:** 특정 리스트 뷰에서 Opportunity 레코드를 가져옵니다.
**파라미터:**
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_task">
**설명:** 특정 리스트 뷰에서 Task 레코드를 가져옵니다.
**파라미터:**
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_account">
**설명:** 특정 리스트 뷰에서 Account 레코드를 가져옵니다.
**파라미터:**
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
<Accordion title="salesforce/get_record_by_view_id_any">
**설명:** 특정 리스트 뷰에서 임의의 객체 유형의 레코드를 가져옵니다.
**파라미터:**
- `recordType` (string, 필수): 레코드 유형
- `listViewId` (string, 필수): 리스트 뷰 ID
- `paginationParameters` (object, 선택): pageCursor와 함께 사용하는 페이지네이션 설정
</Accordion>
</AccordionGroup>
### **커스텀 필드**
<AccordionGroup>
<Accordion title="salesforce/create_custom_field_contact">
**설명:** Contact 오브젝트에 대한 커스텀 필드를 배포합니다.
**파라미터:**
- `label` (string, 필수): 표시 및 내부 참조를 위한 필드 라벨
- `type` (string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, Url
- `defaultCheckboxValue` (boolean, 선택): 체크박스 필드의 기본값
- `length` (string, 필수): 숫자/텍스트 필드의 길이
- `decimalPlace` (string, 필수): 숫자 필드의 소수 자릿수
- `pickListValues` (string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)
- `visibleLines` (string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수
- `description` (string, 선택): 필드 설명
- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
- `defaultFieldValue` (string, 선택): 필드의 기본값
</Accordion>
<Accordion title="salesforce/create_custom_field_lead">
**설명:** Lead 오브젝트에 대한 커스텀 필드를 배포합니다.
**파라미터:**
- `label` (string, 필수): 표시 및 내부 참조를 위한 필드 라벨
- `type` (string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, Url
- `defaultCheckboxValue` (boolean, 선택): 체크박스 필드의 기본값
- `length` (string, 필수): 숫자/텍스트 필드의 길이
- `decimalPlace` (string, 필수): 숫자 필드의 소수 자릿수
- `pickListValues` (string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)
- `visibleLines` (string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수
- `description` (string, 선택): 필드 설명
- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
- `defaultFieldValue` (string, 선택): 필드의 기본값
</Accordion>
<Accordion title="salesforce/create_custom_field_opportunity">
**설명:** Opportunity 오브젝트에 대한 커스텀 필드를 배포합니다.
**파라미터:**
- `label` (string, 필수): 표시 및 내부 참조를 위한 필드 라벨
- `type` (string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, Url
- `defaultCheckboxValue` (boolean, 선택): 체크박스 필드의 기본값
- `length` (string, 필수): 숫자/텍스트 필드의 길이
- `decimalPlace` (string, 필수): 숫자 필드의 소수 자릿수
- `pickListValues` (string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)
- `visibleLines` (string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수
- `description` (string, 선택): 필드 설명
- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
- `defaultFieldValue` (string, 선택): 필드의 기본값
</Accordion>
<Accordion title="salesforce/create_custom_field_task">
**설명:** Task 오브젝트에 대한 커스텀 필드를 배포합니다.
**파라미터:**
- `label` (string, 필수): 표시 및 내부 참조를 위한 필드 라벨
- `type` (string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, Time, Url
- `defaultCheckboxValue` (boolean, 선택): 체크박스 필드의 기본값
- `length` (string, 필수): 숫자/텍스트 필드의 길이
- `decimalPlace` (string, 필수): 숫자 필드의 소수 자릿수
- `pickListValues` (string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)
- `visibleLines` (string, 필수): 멀티셀렉트 필드의 표시 줄 수
- `description` (string, 선택): 필드 설명
- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
- `defaultFieldValue` (string, 선택): 필드의 기본값
</Accordion>
<Accordion title="salesforce/create_custom_field_account">
**설명:** Account 오브젝트에 대한 커스텀 필드를 배포합니다.
**파라미터:**
- `label` (string, 필수): 표시 및 내부 참조를 위한 필드 라벨
- `type` (string, 필수): 필드 유형 - 옵션: Checkbox, Currency, Date, Email, Number, Percent, Phone, Picklist, MultiselectPicklist, Text, TextArea, LongTextArea, Html, Time, Url
- `defaultCheckboxValue` (boolean, 선택): 체크박스 필드의 기본값
- `length` (string, 필수): 숫자/텍스트 필드의 길이
- `decimalPlace` (string, 필수): 숫자 필드의 소수 자릿수
- `pickListValues` (string, 필수): 피클리스트 필드의 값(줄바꿈으로 구분)
- `visibleLines` (string, 필수): 멀티셀렉트/텍스트 영역 필드의 표시 줄 수
- `description` (string, 선택): 필드 설명
- `helperText` (string, 선택): 마우스를 올렸을 때 표시되는 도움말 텍스트
- `defaultFieldValue` (string, 선택): 필드의 기본값
</Accordion>
<Accordion title="salesforce/create_custom_field_any">
**설명:** 모든 오브젝트 타입에 대한 커스텀 필드를 배포합니다.
**참고:** 커스텀 또는 미지의 오브젝트 타입에 커스텀 필드를 생성할 수 있는 유연한 도구입니다.
</Accordion>
</AccordionGroup>
### **고급 작업**
<AccordionGroup>
<Accordion title="salesforce/write_soql_query">
**설명:** Salesforce 데이터에 대해 커스텀 SOQL 쿼리를 실행합니다.
**파라미터:**
- `query` (string, 필수): SOQL 쿼리 (예: "SELECT Id, Name FROM Account WHERE Name = 'Example'")
</Accordion>
<Accordion title="salesforce/create_custom_object">
**설명:** Salesforce에 새로운 커스텀 오브젝트를 배포합니다.
**파라미터:**
- `label` (string, 필수): 탭, 페이지 레이아웃, 리포트에 사용되는 오브젝트 라벨
- `pluralLabel` (string, 필수): 복수형 라벨 (예: "Accounts")
- `description` (string, 선택): 커스텀 오브젝트에 대한 설명
- `recordName` (string, 필수): 레이아웃과 검색에 표시되는 레코드 이름 (예: "Account Name")
</Accordion>
<Accordion title="salesforce/describe_action_schema">
**설명:** 특정 오브젝트 타입에 대한 작업의 예상 스키마를 가져옵니다.
**파라미터:**
- `recordType` (string, 필수): 설명할 레코드 타입
- `operation` (string, 필수): 작업 타입 (예: "CREATE_RECORD" 또는 "UPDATE_RECORD")
**참고:** 커스텀 오브젝트 작업 시, 해당 스키마를 이해하기 위해 제일 먼저 이 기능을 사용하세요.
</Accordion>
</AccordionGroup>
## 사용 예시
### 기본 Salesforce 에이전트 설정
```python
from crewai import Agent, Task, Crew
# Create an agent with Salesforce capabilities
salesforce_agent = Agent(
role="CRM Manager",
goal="Manage customer relationships and sales processes efficiently",
backstory="An AI assistant specialized in CRM operations and sales automation.",
apps=['salesforce']
)
# Task to create a new lead
create_lead_task = Task(
description="Create a new lead for John Doe from Example Corp with email john.doe@example.com",
agent=salesforce_agent,
expected_output="Lead created successfully with lead ID"
)
# Run the task
crew = Crew(
agents=[salesforce_agent],
tasks=[create_lead_task]
)
crew.kickoff()
```
### 특정 Salesforce 도구 필터링
```python
sales_manager = Agent(
role="Sales Manager",
goal="Manage leads and opportunities in the sales pipeline",
backstory="An experienced sales manager who handles lead qualification and opportunity management.",
apps=['salesforce']
)
# Task to manage sales pipeline
pipeline_task = Task(
description="Create a qualified lead and convert it to an opportunity with $50,000 value",
agent=sales_manager,
expected_output="Lead created and opportunity established successfully"
)
crew = Crew(
agents=[sales_manager],
tasks=[pipeline_task]
)
crew.kickoff()
```
### 연락처 및 계정 관리
```python
from crewai import Agent, Task, Crew
account_manager = Agent(
role="Account Manager",
goal="Manage customer accounts and maintain strong relationships",
backstory="An AI assistant that specializes in account management and customer relationship building.",
apps=['salesforce']
)
# Task to manage customer accounts
account_task = Task(
description="""
1. Create a new account for TechCorp Inc.
2. Add John Doe as the primary contact for this account
3. Create a follow-up task for next week to check on their project status
""",
agent=account_manager,
expected_output="Account, contact, and follow-up task created successfully"
)
crew = Crew(
agents=[account_manager],
tasks=[account_task]
)
crew.kickoff()
```
### 고급 SOQL 쿼리 및 리포팅
```python
from crewai import Agent, Task, Crew
data_analyst = Agent(
role="Sales Data Analyst",
goal="Generate insights from Salesforce data using SOQL queries",
backstory="An analytical AI that excels at extracting meaningful insights from CRM data.",
apps=['salesforce']
)
# Complex task involving SOQL queries and data analysis
analysis_task = Task(
description="""
1. Execute a SOQL query to find all opportunities closing this quarter
2. Search for contacts at companies with opportunities over $100K
3. Create a summary report of the sales pipeline status
4. Update high-value opportunities with next steps
""",
agent=data_analyst,
expected_output="Comprehensive sales pipeline analysis with actionable insights"
)
crew = Crew(
agents=[data_analyst],
tasks=[analysis_task]
)
crew.kickoff()
```
이 포괄적인 문서는 모든 Salesforce 도구를 기능별로 정리하여, 사용자가 CRM 자동화 작업에 필요한 특정 작업을 쉽게 찾을 수 있도록 도와줍니다.
### 도움 받기
<Card
title="도움이 필요하신가요?"
icon="headset"
href="mailto:support@crewai.com"
>
Salesforce 통합 설정 또는 문제 해결에 대해 지원팀에 문의하세요.
</Card>
Reference in New Issue View Git Blame Copy Permalink