AI 에이전트를 Gmail에 연결

인증 방식

• OAuth 2.0

로컬 콘솔에서 제공업체를 선택하고 인증 정보를 설정하세요. OAuth 제공업체를 사용하려면 해당 서비스에 직접 OAuth 앱을 등록해야 합니다.

이 커넥터의 확인 사항

이 get_profile 예시는 메일 본문 대신 메일함 식별 정보와 통계를 읽습니다. emailAddress가 원하는 메일함인지 확인하세요. messagesTotal과 threadsTotal은 개수이며 historyId는 커서입니다. 실행 전 필수 Gmail 읽기 scope를 확인하세요.

호출 전에 Action 확인

예제 용도

연결된 Gmail 사서함의 프로필과 통계를 읽습니다.

Action에 필요한 권한 범위

• https://www.googleapis.com/auth/gmail.readonly

실행 중인 인스턴스에서 스키마를 읽고 실행 전에 필수 입력, 권한, 계정 연결을 확인하세요.

curl -s http://localhost:3000/v1/actions/gmail.get_profile

계정을 연결한 후 자신의 리소스에 맞게 예제 입력을 수정하세요. runtime 인증이 활성화되어 있으면 runtime Bearer Token도 추가하세요.

curl -s -X POST \
  http://localhost:3000/v1/actions/gmail.get_profile \
  -H 'content-type: application/json' \
  -d '{"input":{}}'

결과 읽기

HTTP 런타임 응답에는 success, message, data, meta가 포함됩니다. HTTP 상태만 보지 말고 success와 Action 출력 스키마를 확인하세요. 실행 메타데이터에 executionId가 있으면 해당 식별자로 민감 정보가 가려진 로그를 찾을 수 있습니다. 아래는 응답 구조 예시이며 실제 API 실행 결과가 아닙니다.

{
  "success": true,
  "message": "OK",
  "data": {
    "emailAddress": "reader@example.com",
    "messagesTotal": 12,
    "threadsTotal": 8,
    "historyId": "12345"
  },
  "meta": {}
}

호출 실패 시 확인 사항

• 인증 실패 시 엔드포인트와 자격 증명 유형을 확인하세요. 관리자 자격 증명은 /api를 보호하고 런타임 Bearer 토큰은 /v1과 /mcp에 사용됩니다. 공급자 API 키는 런타임 토큰을 대체하지 못합니다.
• 권한 거부 시 Action의 필수 scopes, 런타임 Action 규칙과 연결 권한을 확인하세요. 유효한 토큰이라도 선택한 계정에 접근하지 못할 수 있습니다.
• 결과가 비어 있거나 리소스가 없다면 연결 계정과 해당 리소스 접근 권한을 확인하세요. 인증 성공이 모든 워크스페이스, 채널, 문서의 접근을 보장하지는 않습니다.
• 재시도 전에 오류와 실행 로그를 확인하세요. 공급자 데이터를 변경하는 Action은 이미 완료되었는지 확인하고 무조건 반복 요청하지 마세요.

다음 단계

지원되는 제공업체의 경우 OOMOL이 OAuth 앱 설정과 호스팅 런타임을 관리합니다. 계정을 선택하고 권한을 승인하는 것은 사용자의 몫입니다.