개요
에이전트가 Google Sheets를 통해 스프레드시트 데이터를 관리할 수 있도록 합니다. 행을 읽고, 새 항목을 생성하며, 기존 데이터를 업데이트하고, AI 기반 자동화를 통해 데이터 관리 워크플로우를 간소화하세요. 데이터 추적, 보고, 협업 데이터 관리에 최적화되어 있습니다.사전 준비 사항
Google Sheets 통합을 사용하기 전에 다음을 확인하세요:- 활성 구독이 되어 있는 CrewAI Enterprise 계정
- Google Sheets에 액세스할 수 있는 Google 계정
- 통합 페이지를 통해 Google 계정 연결
- 데이터 작업을 위한 올바른 열 헤더가 있는 스프레드시트
Google Sheets 통합 설정
1. Google 계정 연결하기
- CrewAI Enterprise Integrations로 이동합니다.
- 인증 통합 섹션에서 Google Sheets를 찾습니다.
- Connect를 클릭하고 OAuth 흐름을 완료합니다.
- 스프레드시트 접근에 필요한 권한을 허용합니다.
- Account Settings에서 Enterprise Token을 복사합니다.
2. 필수 패키지 설치
사용 가능한 작업
GOOGLE_SHEETS_GET_ROW
GOOGLE_SHEETS_GET_ROW
설명: Google Sheets 스프레드시트에서 행을 가져옵니다.매개변수:
spreadsheetId
(string, 필수): 스프레드시트 - Connect Portal Workflow Settings를 사용하여 사용자가 스프레드시트를 선택할 수 있도록 합니다. 선택한 스프레드시트의 첫 번째 워크시트를 기본값으로 사용합니다.limit
(string, 선택): 행 제한 - 반환할 최대 행 수를 제한합니다.
GOOGLE_SHEETS_CREATE_ROW
GOOGLE_SHEETS_CREATE_ROW
설명: Google Sheets 스프레드시트에 새로운 행을 만듭니다.매개변수:
spreadsheetId
(string, 필수): 스프레드시트 - Connect Portal Workflow Settings를 사용하여 사용자가 스프레드시트를 선택할 수 있도록 합니다. 선택한 스프레드시트의 첫 번째 워크시트를 기본값으로 사용합니다.worksheet
(string, 필수): 워크시트 - 워크시트에는 반드시 열 헤더가 있어야 합니다.additionalFields
(object, 필수): 필드 - 추가할 행의 필드를 열 이름을 key로 하는 객체로 포함합니다. Connect Portal Workflow Settings를 사용하여 사용자가 열 매핑을 선택할 수 있도록 합니다.
GOOGLE_SHEETS_UPDATE_ROW
GOOGLE_SHEETS_UPDATE_ROW
설명: Google Sheets 스프레드시트의 기존 행을 업데이트합니다.매개변수:
spreadsheetId
(string, 필수): 스프레드시트 - Connect Portal Workflow Settings를 사용하여 사용자가 스프레드시트를 선택할 수 있도록 합니다. 선택한 스프레드시트의 첫 번째 워크시트를 기본값으로 사용합니다.worksheet
(string, 필수): 워크시트 - 워크시트에는 반드시 열 헤더가 있어야 합니다.filterFormula
(object, 선택): 필터 - 업데이트할 행을 식별하기 위한 단일 조건의 AND 그룹으로 이루어진 OR의 형태(분리 정규형)로 작성합니다.사용 가능한 연산자:$stringContains
,$stringDoesNotContain
,$stringExactlyMatches
,$stringDoesNotExactlyMatch
,$stringStartsWith
,$stringDoesNotStartWith
,$stringEndsWith
,$stringDoesNotEndWith
,$numberGreaterThan
,$numberLessThan
,$numberEquals
,$numberDoesNotEqual
,$dateTimeAfter
,$dateTimeBefore
,$dateTimeEquals
,$booleanTrue
,$booleanFalse
,$exists
,$doesNotExist
additionalFields
(object, 필수): 필드 - 업데이트할 필드를 열 이름을 key로 하는 객체로 포함합니다. Connect Portal Workflow Settings를 사용하여 사용자가 열 매핑을 선택할 수 있도록 합니다.
사용 예시
기본 Google Sheets 에이전트 설정
특정 Google Sheets 도구 필터링
데이터 분석 및 보고
자동화된 데이터 업데이트
복잡한 데이터 관리 워크플로우
문제 해결
일반적인 문제
권한 오류- Google 계정이 대상 스프레드시트에 대해 편집 권한이 있는지 확인하세요
- OAuth 연결에 Google Sheets API에 필요한 scope가 포함되어 있는지 검증하세요
- 스프레드시트가 인증된 계정과 공유되어 있는지 확인하세요
- 행을 생성하거나 업데이트하기 전에 워크시트에 올바른 열 헤더가 있는지 확인하세요
additionalFields
의 열 이름이 실제 열 헤더와 일치하는지 검증하세요- 지정된 워크시트가 스프레드시트에 존재하는지 확인하세요
- 데이터 값이 각 열에 대해 예상되는 형식과 일치하는지 확인하세요
- 날짜 열에는 올바른 날짜 형식(ISO 형식 권장)을 사용하세요
- 숫자 열에 입력되는 값이 적절한 형식인지 검증하세요
- 필터 수식이 부정 정규형(disjunctive normal form)의 올바른 JSON 구조를 따르는지 확인하세요
- 실제 열 헤더와 일치하는 유효한 필드명을 사용하세요
- 복잡한 다중 조건 쿼리를 작성하기 전에 간단한 필터로 테스트하세요
- 연산자 유형이 열의 데이터 유형과 일치하는지 검증하세요
GOOGLE_SHEETS_GET_ROW
를 사용할 때 행 제한에 유의하세요- 대용량 데이터셋의 경우 페이지네이션을 고려하세요
- 처리되는 데이터의 양을 줄이기 위해 구체적인 필터를 사용하세요
- 필터 조건이 업데이트하려는 행을 정확하게 식별하는지 확인하세요
- 대규모 업데이트 전에 작은 데이터셋으로 필터 조건을 테스트하세요
- 모든 필수 필드가 업데이트 작업에 포함되어 있는지 검증하세요
도움 받기
도움이 필요하신가요?
Google Sheets 통합 설정 또는 문제 해결에 대한 지원이 필요하시면 저희 지원팀으로 문의해 주세요.