Google Calendar 및 Gmail 작업 추가

다음 페이지에서는 Google Calendar 및 Gmail의 어시스턴트 작업을 설정하는 방법을 설명합니다.

Google Calendar 작업

Google Calendar 작업을 사용 설정하면 최종 사용자가 어시스턴트에게 Google Calendar 일정을 만들어 달라고 요청할 수 있습니다.

예를 들어 사용자가 '내일 오후 3시에 user1@example.com과 회의를 예약해 줘'라고 입력할 수 있습니다. 어시스턴트는 필요한 경우 추가 세부정보를 요청한 다음 사용자에게 이벤트를 생성할지 확인합니다.

어시스턴트는 작업을 통해 다음 Google Calendar 필드를 읽고 수정할 수 있습니다.

필드 설명
참석자 필수 항목입니다. 참석자 이메일 주소 목록입니다. 요청하는 사용자가 목록에 자동으로 추가됩니다.
제목 회의 제목입니다.
시작 시간 회의 시작 시간입니다.
기간 회의 시간입니다. 기본값은 30분입니다.
시간대 회의 시간대입니다. 제공되지 않으면 사용자의 시간대가 사용됩니다.
설명 회의 설명입니다.

Google Calendar의 인증 및 권한 설정

Google Calendar 작업을 사용 설정하기 전에 Google Cloud 관리자가 다음과 같이 Google Calendar API를 사용 설정하고 승인을 설정해야 합니다.

Google Calendar API 사용 설정

Google Cloud 콘솔에서 다음 API를 사용 설정합니다.

OAuth 앱을 만들고 범위 추가

OAuth 앱이 없는 경우 다음 단계를 따르세요. OAuth 앱이 이미 있는 경우 OAuth 클라이언트 사용자 인증 정보 만들기로 건너뜁니다.

  1. Google 인증 플랫폼 / 개요로 이동합니다.

  2. 시작하기를 클릭합니다.

  3. OAuth 앱 이름을 입력합니다.

  4. 사용자 지원 이메일을 입력합니다.

  5. 내부를 선택합니다.

  6. 개발자 연락처 정보를 입력합니다.

  7. 만들기를 클릭합니다.

OAuth 클라이언트 사용자 인증 정보 만들기

이 절차에서는 Google Cloud작업을 위한 새 OAuth 클라이언트 ID를 만드는 방법을 설명합니다. 이 OAuth 클라이언트 ID 및 보안 비밀은 다른 Google Cloud작업에도 사용할 수 있습니다. Google Cloud작업에 기존 Google Cloud OAuth 클라이언트 ID가 있는 경우 새 클라이언트 ID를 만드는 대신 Google Calendar 작업에 해당 클라이언트 ID와 보안 비밀번호를 사용할 수 있습니다.

  1. Google 인증 플랫폼 / 클라이언트로 이동합니다.

  2. 클라이언트 만들기를 클릭합니다.

  3. 애플리케이션 유형에서 웹 애플리케이션을 선택합니다.

  4. 이름에 클라이언트 ID 이름을 입력합니다.

  5. 승인된 리디렉션 URI 섹션에서 URI 추가를 클릭하고 다음 URI를 입력합니다. https://vertexaisearch.cloud.google.com/oauth-redirect

  6. 만들기를 클릭하고 다음 정보를 복사합니다.

    • 클라이언트 ID
    • 클라이언트 보안 비밀번호

Google Calendar 작업 추가

콘솔 또는 API를 사용하여 Google Calendar 작업을 만들려면 다음 단계를 따르세요.

시작하기 전에

Google Calendar 작업을 추가하려면 기존 앱 및 인증 세부정보를 비롯한 필수 요건이 충족되어야 합니다.

  • Google Cloud 관리자가 먼저 Google Calendar의 인증 및 권한 설정 섹션의 단계를 완료하고 클라이언트 ID와 클라이언트 보안 비밀번호를 제공해야 작업을 추가할 수 있습니다.

  • Google Calendar 데이터 스토어에 연결된 기존 Gemini Enterprise 앱이 있어야 합니다. 새 앱을 만들려면 앱 만들기를 참고하세요.

  • 최근에 Google Cloud 프로젝트에서 Discovery Engine API를 사용 설정하고 앱을 만든 경우 앱 설정이 완료될 때까지 최소 15분 정도 기다린 후 Google Calendar 작업을 구성하세요.

Google Calendar 작업 구성

콘솔

콘솔을 사용하여 앱에 작업을 추가하려면 다음 단계를 따르세요.

  1. Gemini Enterprise에서 Gemini Enterprise 페이지로 이동합니다.
  2. Gemini Enterprise 앱을 선택합니다.
  3. 탐색 메뉴에서 작업을 클릭합니다.

  4. 작업 추가:

    • 첫 번째 작업인 경우 작업 추가를 클릭합니다.

    • 이전에 작업을 만든 경우 만들기를 클릭합니다.

  5. Google Calendar의 경우 연결을 클릭합니다.

  6. 작업 커넥터 이름을 입력합니다.

  7. 작업 커넥터의 승인 정보를 입력합니다.

    1. 새 클라이언트 ID 및 새 클라이언트 보안 비밀번호에 관리자가 OAuth 클라이언트 사용자 인증 정보 만들기 섹션에서 만든 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.
    2. 인증 확인을 클릭하고 Gemini Enterprise 앱에 Google Calendar 액세스 권한을 부여합니다.

  8. 사용 설정할 작업을 선택합니다.

  9. 설정 완료를 클릭합니다. 작업이 작업 페이지에 표시됩니다.

REST

API를 사용하여 앱에 작업을 추가하려면 다음 단계를 따르세요.

  1. Google Calendar 작업을 위한 작업 커넥터를 만듭니다.

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-GFE-SSL: yes" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
-d '{
  "collection_id":"CONNECTOR_ID",
  "collection_display_name":"CONNECTOR_DISPLAY_NAME",
  "data_connector":{
      "data_source":"google_calendar",
      "action_config":{
        "is_action_configured":true,
        "action_params":{
            "client_id":"CLIENT_ID",
            "client_secret":"CLIENT_SECRET"
        }
      },
      "connector_modes": ["ACTIONS"]
  }
}'
    • PROJECT_ID: Google Calendar 작업 커넥터를 만들려는 프로젝트의 ID입니다.
    • LOCATION: Google Calendar 작업 커넥터의 멀티 리전입니다(global, us, eu).
    • CONNECTOR_ID: 만들려는 커넥터의 ID입니다. 이 ID는 소문자, 숫자, 밑줄, 하이픈만 포함할 수 있습니다.
    • CONNECTOR_DISPLAY_NAME: 만들려는 커넥터의 표시 이름입니다.
    • CLIENT_ID: 관리자가 OAuth 클라이언트 사용자 인증 정보 만들기에서 만든 클라이언트 ID입니다.
    • CLIENT_SECRET: 관리자가 OAuth 클라이언트 사용자 인증 정보 만들기에서 만든 클라이언트 보안 비밀번호입니다.

  2. 만든 Google Calendar 작업 커넥터를 기존 앱에 연결합니다.

    curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
  "enabled_tools": {
    "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
      "tool_info": [
        {
          "tool_name": "create_calendar_event",
          "tool_display_name": "Create Calendar Event"
        }
      ]
    }
  }
}'
    • PROJECT_ID: 앱과 Google Calendar 작업 커넥터가 있는 프로젝트의 ID입니다.
    • LOCATION: 앱 및 작업 커넥터의 멀티 리전입니다(global, us 또는 eu).
    • APP_ID: 작업을 연결할 앱의 ID입니다.
    • CONNECTOR_ID: 이전 단계에서 만든 Google Calendar 작업 커넥터의 ID입니다.

작업을 추가하면 어시스턴트가 앱에서 최종 사용자를 대신하여 이러한 작업을 실행할 수 있습니다. 사용자가 어시스턴트에게 Google Calendar 작업을 실행해 달라고 처음 요청하면 Google Calendar 계정에 대한 액세스를 승인하라는 메시지가 표시됩니다.

Gmail 작업

Gmail 작업을 사용 설정하면 최종 사용자가 어시스턴트에게 이메일을 보내 달라고 요청할 수 있습니다.

예를 들어 사용자는 'user1@example.com에 제목이 '안녕하세요'이고 내용이 '잘 지내시나요?'인 이메일을 보내줘'라고 입력할 수 있습니다. 어시스턴트는 필요한 경우 추가 세부정보를 요청한 다음 사용자에게 이메일 전송을 확인하도록 요청합니다.

어시스턴트는 작업을 통해 다음 Gmail 필드를 읽고 수정할 수 있습니다.

필드 설명
받는사람 필수 항목입니다. 수신자 이메일 목록입니다.
제목 필수 항목입니다. 이메일 제목
콘텐츠 필수 항목입니다. 이메일의 콘텐츠(마크다운 형식)입니다.
CC 이메일의 참조 목록입니다.
BCC 이메일의 숨은참조 목록입니다.

Gmail의 인증 및 권한 설정

Gmail 작업을 사용 설정하기 전에 Google Cloud 관리자가 Gmail API를 사용 설정하고 승인을 설정해야 합니다.

Gmail API 사용 설정

Google Cloud 콘솔에서 다음 API를 사용 설정합니다.

OAuth 앱을 만들고 범위 추가

OAuth 앱이 없는 경우 다음 단계를 따르세요. OAuth 앱이 이미 있는 경우 OAuth 클라이언트 사용자 인증 정보 만들기로 건너뜁니다.

  1. Google 인증 플랫폼 / 개요로 이동합니다.

  2. 시작하기를 클릭합니다.

  3. OAuth 앱 이름을 입력합니다.

  4. 사용자 지원 이메일을 입력합니다.

  5. 내부를 선택합니다.

  6. 개발자 연락처 정보를 입력합니다.

  7. 만들기를 클릭합니다.

OAuth 클라이언트 사용자 인증 정보 만들기

이 절차에서는 Google Cloud작업을 위한 새 OAuth 클라이언트 ID를 만드는 방법을 설명합니다. 이 OAuth 클라이언트 ID 및 보안 비밀은 다른 Google Cloud작업에도 사용할 수 있습니다. Google Cloud작업에 기존 Google Cloud OAuth 클라이언트 ID가 있는 경우 새 클라이언트 ID를 만드는 대신 Google Calendar 작업에 해당 클라이언트 ID와 보안 비밀번호를 사용할 수 있습니다.

  1. Google 인증 플랫폼 / 클라이언트로 이동합니다.

  2. 클라이언트 만들기를 클릭합니다.

  3. 애플리케이션 유형에서 웹 애플리케이션을 선택합니다.

  4. 이름에 클라이언트 ID 이름을 입력합니다.

  5. 승인된 리디렉션 URI 섹션에서 URI 추가를 클릭하고 다음 URI를 입력합니다. https://vertexaisearch.cloud.google.com/oauth-redirect

  6. 만들기를 클릭하고 다음 정보를 복사합니다.

    • 클라이언트 ID
    • 클라이언트 보안 비밀번호

Gmail 작업 추가

콘솔 또는 API를 사용하여 Gmail 작업을 만들려면 다음 단계를 따르세요.

시작하기 전에

Gmail 작업을 추가하려면 기존 앱 및 인증 세부정보를 비롯한 필수 요건을 충족해야 합니다.

  • 작업을 추가하려면 먼저 Google Cloud 관리자가 Gmail 인증 및 권한 설정 섹션의 단계를 완료하고 클라이언트 ID와 클라이언트 보안 비밀번호를 제공해야 합니다.

  • Gmail 데이터 스토어에 연결된 기존 Gemini Enterprise 앱이 있어야 합니다. 새 앱을 만들려면 앱 만들기를 참고하세요.

  • 최근에 Google Cloud 프로젝트에서 Discovery Engine API를 사용 설정하고 앱을 만든 경우 앱 설정이 완료될 때까지 최소 15분 정도 기다린 후 Gmail 작업을 구성하세요.

Gmail 작업 구성

콘솔

콘솔을 사용하여 앱에 작업을 추가하려면 다음 단계를 따르세요.

  1. Gemini Enterprise에서 Gemini Enterprise 페이지로 이동합니다.
  2. Gemini Enterprise 앱을 선택합니다.
  3. 탐색 메뉴에서 작업을 클릭합니다.

  4. 작업 추가:

    • 첫 번째 작업인 경우 작업 추가를 클릭합니다.

    • 이전에 작업을 만든 경우 만들기를 클릭합니다.

  5. Gmail의 경우 연결을 클릭합니다.

  6. 작업 커넥터 이름을 입력합니다.

  7. 작업 커넥터의 승인 정보를 입력합니다.

    1. 새 클라이언트 ID 및 새 클라이언트 보안 비밀번호에 관리자가 OAuth 클라이언트 사용자 인증 정보 만들기 섹션에서 만든 클라이언트 ID와 클라이언트 보안 비밀번호를 입력합니다.
    2. 인증 확인을 클릭하고 Gemini Enterprise 앱에 Gmail 액세스 권한을 부여합니다.

  8. 사용 설정할 작업을 선택합니다.

  9. 설정 완료를 클릭합니다. 작업이 작업 페이지에 표시됩니다.

REST

API를 사용하여 앱에 작업을 추가하려면 다음 단계를 따르세요.

  1. Gmail 작업의 작업 커넥터를 만듭니다.

    curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-GFE-SSL: yes" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
-d '{
  "collection_id":"CONNECTOR_ID",
  "collection_display_name":"CONNECTOR_DISPLAY_NAME",
  "data_connector":{
      "data_source":"gmail",
      "action_config":{
        "is_action_configured":true,
        "action_params":{
            "client_id":"CLIENT_ID",
            "client_secret":"CLIENT_SECRET"
        }
      },
      "connector_modes": ["ACTIONS"]
  }
}'
    • PROJECT_ID: Gmail 작업 커넥터를 만들 프로젝트의 ID입니다.
    • LOCATION: Gmail 작업 커넥터의 멀티 리전입니다(global, us 또는 eu).
    • CONNECTOR_ID: 만들려는 커넥터의 ID입니다. 이 ID는 소문자, 숫자, 밑줄, 하이픈만 포함할 수 있습니다.
    • CONNECTOR_DISPLAY_NAME: 만들려는 커넥터의 표시 이름입니다.
    • CLIENT_ID: 관리자가 OAuth 클라이언트 사용자 인증 정보 만들기에서 만든 클라이언트 ID입니다.
    • CLIENT_SECRET: 관리자가 OAuth 클라이언트 사용자 인증 정보 만들기에서 만든 클라이언트 보안 비밀번호입니다.

  2. 생성한 Gmail 작업 커넥터를 기존 앱에 연결합니다.

    curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
  "name": "projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
  "enabled_tools": {
    "projects/PROJECT_ID/locations/LOCATION/collections/CONNECTOR_ID/dataConnector": {
      "tool_info": [
        {
          "tool_name": "send_email",
          "tool_display_name": "Send Email"
        }
      ]
    }
  }
}'
    • PROJECT_ID: 앱과 Gmail 작업 커넥터가 있는 프로젝트의 ID입니다.
    • LOCATION: 앱 및 커넥터의 멀티 리전입니다(global, us 또는 eu).
    • APP_ID: 작업을 연결할 앱의 ID입니다.
    • CONNECTOR_ID: 이전 단계에서 만든 Gmail 작업 커넥터의 ID입니다.

작업을 추가하면 어시스턴트가 앱에서 최종 사용자를 대신하여 이러한 작업을 실행할 수 있습니다. 사용자가 어시스턴트에게 Gmail 작업을 실행해 달라고 처음 요청하면 Gmail 계정에 대한 액세스 권한을 승인하라는 메시지가 표시됩니다.

Google Calendar 및 Gmail 작업을 모두 앱에 연결

다음 API 요청은 Google Calendar 및 Gmail 작업을 기존 앱에 연결하는 방법을 보여줍니다.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
-H "X-Goog-User-Project: PROJECT_ID" \
"https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabled_tools" \
-d '{
   "name":"projects/PROJECT_ID/locations/LOCATION/collections/default_collection/engines/APP_ID/assistants/default_assistant",
   "enabled_tools":{
      "projects/PROJECT_ID/locations/LOCATION/collections/GMAIL_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"send_email",
               "tool_display_name":"Send Email"
            }
         ]
      },
      "projects/PROJECT_ID/locations/LOCATION/collections/CALENDAR_CONNECTOR_ID/dataConnector":{
         "tool_info":[
            {
               "tool_name":"create_calendar_event",
               "tool_display_name":"Create Calendar Event"
            }
         ]
      }
    }
  }'
  • PROJECT_ID: 앱과 Google Calendar 및 Gmail 작업 커넥터가 있는 프로젝트의 ID입니다.
  • LOCATION: 앱 및 커넥터의 멀티 리전입니다(global, us 또는 eu).
  • APP_ID: 작업을 연결할 앱의 ID입니다.
  • CALENDAR_CONNECTOR_ID: 이전 단계에서 만든 Google Calendar 작업 커넥터의 ID입니다.
  • GMAIL_CONNECTOR_ID: 이전 단계에서 만든 Gmail 작업 커넥터의 ID입니다.

작업을 추가하면 어시스턴트가 앱에서 최종 사용자를 대신하여 이러한 작업을 실행할 수 있습니다. 사용자가 어시스턴트에게 Google Calendar 또는 Gmail 작업을 실행해 달라고 처음 요청하면 계정에 대한 액세스 권한을 승인하라는 메시지가 표시됩니다.