Outlook 캘린더 및 이메일 작업 추가

다음 페이지에서는 Outlook 이메일 및 Outlook 일정의 작업을 설정하는 방법을 설명합니다.

Outlook 이메일 작업 추가

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

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

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

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

Outlook 이메일의 인증 및 권한 설정

Outlook 작업을 사용 설정하기 전에 관리자가 Outlook의 인증 및 권한을 설정해야 합니다.

다음 절차는 Outlook 이메일 및 Outlook 캘린더 작업 모두에 적용됩니다. 이메일과 캘린더 작업을 모두 사용하려면 범위 사용 설정 절차 중에 두 범위 모두 사용 설정하세요.

OAuth 앱을 만들고 범위 추가

  1. https://portal.azure.com/에 로그인하고 앱 등록 페이지로 이동합니다.

  2. 새 등록을 클릭합니다.

    1. 앱 이름을 지정합니다.
    2. 리디렉션 URI의 경우:
      • 플랫폼 유형에서 웹을 선택합니다.
      • 다음 리디렉션 URI를 추가합니다. https://vertexaisearch.cloud.google.com/oauth-redirect

  3. 인증서 및 보안 비밀에서 새 클라이언트 보안 비밀번호를 만듭니다. 클라이언트 보안 비밀번호를 기록해 둡니다. 생성 직후에만 표시됩니다.

필수 범위를 사용 설정하려면 다음 단계를 따르세요.

  1. Azure 앱의 API 권한 설정 페이지로 이동합니다.
  2. 권한 추가를 클릭합니다.
  3. Microsoft Graph를 선택합니다.
  4. 위임된 권한을 선택합니다.
  5. 다음 범위를 추가합니다.
    1. offline_access
    2. User.Read
    3. Calendars.ReadWrite (캘린더 작업이 필요한 경우)
    4. Mail.Send (이메일 작업이 필요한 경우)

Azure의 조직 설정 유형에 따라 범위를 사용 설정하는 마지막 단계를 생략할 수 있습니다.

Outlook 이메일 작업 구성

시작하기 전에 Google Cloud 관리자가 Outlook 이메일의 인증 및 권한 설정의 단계를 완료하고 다음을 제공했는지 확인하세요.

  • 클라이언트 ID
  • 클라이언트 보안 비밀번호
  • 테넌트 ID (API에서는 인스턴스 ID라고 함)

API를 사용하여 Outlook 이메일 작업 구성

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

다음 안내를 사용하여 Outlook 이메일 및 캘린더 작업을 모두 구성할 수 있습니다. Outlook 일정 작업을 이미 구성한 경우 이 단계를 다시 실행하지 않아도 됩니다.

  1. Outlook 데이터를 Gemini Enterprise에 연결하지 않은 경우 Outlook 커넥터를 만드세요. Outlook 커넥터가 이미 있는 경우 다음 단계로 이동합니다.

    SERVER=https://discoveryengine.googleapis.com
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_NUMBER" \
"$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global:setUpDataConnector" \
-d '{
  "collectionId": "COLLECTION_ID",
  "collectionDisplayName": "YOUR_COLLECTION_DISPLAY_NAME",
  "dataConnector": {
    "dataSource": "outlook",
    "params": {
      "instance_id": "INSTANCE_ID",
      "client_id": "CLIENT_ID",
      "client_secret": "CLIENT_SECRET"
    },
    "refreshInterval": "86400s",
    "entities": [
      {
        "entityName": "mail"
      },
      {
        "entityName": "mail-attachment"
      },
      {
        "entityName": "calendar"
      },
      {
        "entityName": "contact"
      }
    ],
    "syncMode": "PERIODIC",
  }
}'

    다음을 바꿉니다.

    • PROJECT_NUMBER: Google Cloud 프로젝트 수입니다.
    • COLLECTION_ID: 컬렉션의 ID입니다.
    • COLLECTION_DISPLAY_NAME: 컬렉션의 표시 이름입니다.
    • CLIENT_ID: OAuth 앱을 만들고 범위 추가 섹션에서 관리자가 만든 클라이언트 ID입니다.
    • CLIENT_SECRET: OAuth 앱 만들기 및 범위 추가 섹션에서 관리자가 만든 클라이언트 보안 비밀번호입니다.

  2. Outlook 커넥터에 작업 구성을 포함합니다.

    curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector?update_mask=action_config" \
  -d '{
  "name": "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector",
  "actionConfig": {
      "isActionConfigured": true,
      "actionParams": {
        "client_id": "CLIENT_ID",
        "client_secret": "CLIENT_SECRET",
        "instance_id": "INSTANCE_ID",
      }
    }
  }'

    다음을 바꿉니다.

  3. 어시스턴트에서 Outlook 작업을 사용 설정합니다. 이메일 작업만 필요한 경우 캘린더 항목을 제외합니다.

    curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "send_email",
            "actionDisplayName": "Send Outlook email"
          },
          {
            "actionName": "create_calendar_event",
            "actionDisplayName": "Create Outlook calendar event"
          }
        ]
      }
    }
  }'

    다음을 바꿉니다.

    • PROJECT_ID: 앱과 Outlook 커넥터가 있는 프로젝트의 ID입니다.
    • LOCATION: 앱 및 커넥터의 멀티 리전입니다(global, us 또는 eu).
    • APP_ID: 작업을 연결할 앱의 ID입니다.
    • COLLECTION_ID: 이전 단계에서 만든 Outlook 커넥터의 ID입니다.

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

Outlook 캘린더 작업 추가

Outlook 캘린더 작업이 사용 설정되면 최종 사용자가 어시스턴트에게 캘린더 일정을 만들어 달라고 요청할 수 있습니다.

예를 들어 사용자가 '11월 4일 금요일 오전 11시에 userA@example.com과 회의를 예약해 줘'라고 입력할 수 있습니다. 필요한 경우 어시스턴트가 추가 세부정보를 요청한 다음 사용자에게 일정을 만들 것인지 확인합니다.

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

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

Outlook 일정의 인증 및 권한 설정

Outlook 작업을 사용 설정하기 전에 관리자가 Outlook의 인증 및 권한을 설정해야 합니다.

다음 절차는 Outlook 이메일 및 Outlook 캘린더 작업 모두에 적용됩니다. 이메일과 캘린더 작업을 모두 사용하려면 범위 사용 설정 절차 중에 두 범위 모두 사용 설정하세요.

OAuth 앱을 만들고 범위 추가

  1. https://portal.azure.com/에 로그인하고 앱 등록 페이지로 이동합니다.

  2. 새 등록을 클릭합니다.

    1. 앱 이름을 지정합니다.
    2. 리디렉션 URI의 경우:
      • 플랫폼 유형에서 웹을 선택합니다.
      • 다음 리디렉션 URI를 추가합니다. https://vertexaisearch.cloud.google.com/oauth-redirect

  3. 인증서 및 보안 비밀에서 새 클라이언트 보안 비밀번호를 만듭니다. 클라이언트 보안 비밀번호를 기록해 둡니다. 생성 직후에만 표시됩니다.

필수 범위를 사용 설정하려면 다음 단계를 따르세요.

  1. Azure 앱의 API 권한 설정 페이지로 이동합니다.
  2. 권한 추가를 클릭합니다.
  3. Microsoft Graph를 선택합니다.
  4. 위임된 권한을 선택합니다.
  5. 다음 범위를 추가합니다.
    1. offline_access
    2. User.Read
    3. Calendars.ReadWrite (캘린더 작업이 필요한 경우)
    4. Mail.Send (이메일 작업이 필요한 경우)

Azure의 조직 설정 유형에 따라 범위를 사용 설정하는 마지막 단계를 생략할 수 있습니다.

Outlook 캘린더 작업 구성

시작하기 전에 Microsoft Outlook 관리자가 Outlook 일정의 인증 및 권한 설정의 단계를 완료하고 다음을 제공했는지 확인하세요.

  • 클라이언트 ID
  • 클라이언트 보안 비밀번호
  • 테넌트 ID (API에서는 인스턴스 ID라고 함)

API를 사용하여 Outlook 일정 작업 구성

다음 안내를 사용하여 Outlook 이메일 및 캘린더 작업을 모두 구성할 수 있습니다. Outlook 이메일 작업을 이미 구성한 경우 이 단계를 다시 실행하지 않아도 됩니다.

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

  1. Outlook 데이터를 Gemini Enterprise에 연결하지 않은 경우 Outlook 커넥터를 만드세요. Outlook 커넥터가 이미 있는 경우 다음 단계로 이동합니다.

    SERVER=https://discoveryengine.googleapis.com
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_NUMBER" \
"$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global:setUpDataConnector" \
-d '{
  "collectionId": "COLLECTION_ID",
  "collectionDisplayName": "YOUR_COLLECTION_DISPLAY_NAME",
  "dataConnector": {
    "dataSource": "outlook",
    "params": {
      "instance_id": "INSTANCE_ID",
      "client_id": "CLIENT_ID",
      "client_secret": "CLIENT_SECRET"
    },
    "refreshInterval": "86400s",
    "entities": [
      {
        "entityName": "mail"
      },
      {
        "entityName": "mail-attachment"
      },
      {
        "entityName": "calendar"
      },
      {
        "entityName": "contact"
      }
    ],
    "syncMode": "PERIODIC",
  }
}'

    다음을 바꿉니다.

    • PROJECT_NUMBER: Google Cloud 프로젝트 수입니다.
    • COLLECTION_ID: 컬렉션의 ID입니다.
    • COLLECTION_DISPLAY_NAME: 컬렉션의 표시 이름입니다.
    • CLIENT_ID: OAuth 앱을 만들고 범위 추가 섹션에서 관리자가 만든 클라이언트 ID입니다.
    • CLIENT_SECRET: OAuth 앱 만들기 및 범위 추가 섹션에서 관리자가 만든 클라이언트 보안 비밀번호입니다.

  2. Outlook 커넥터에 작업 구성을 포함합니다.

    curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "https://discoveryengine.googleapis.com/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector?update_mask=action_config" \
  -d '{
  "name": "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector",
  "actionConfig": {
      "isActionConfigured": true,
      "actionParams": {
        "client_id": "CLIENT_ID",
        "client_secret": "CLIENT_SECRET",
        "instance_id": "INSTANCE_ID",
      }
    }
  }'

    다음을 바꿉니다.

  3. 어시스턴트에서 Outlook 작업을 사용 설정합니다.

    UI에서 새 데이터 커넥터를 어시스턴트와 연결할 수 있습니다. Outlook 작업을 사용 설정하려면 다음 API 명령어가 필요합니다.

    SERVER=https://discoveryengine.googleapis.com
PROJECT_NUMBER={YOUR PROJECT_NUMBER}
ENGINE_ID="{YOUR ENGINE ID}"
CONNECTOR_ID="{THE CONNECTOR'S COLLECTION ID YOU GENERATED IN PREVIOUS STEP}"

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token --project "PROJECT_NUMBER")" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_NUMBER" \
  "$SERVER/v1alpha/projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant?update_mask=enabledActions" \
  -d '{
    "name": "projects/PROJECT_NUMBER/locations/global/collections/default_collection/engines/APP_ID/assistants/default_assistant",
    "enabledActions": {
      "projects/PROJECT_NUMBER/locations/global/collections/COLLECTION_ID/dataConnector": {
        "actionInfo": [
          {
            "actionName": "send_email",
            "actionDisplayName": "Send Outlook email"
          },
          {
            "actionName": "create_calendar_event",
            "actionDisplayName": "Create Outlook calendar event"
          }
        ]
      }
    }
  }'

    다음을 바꿉니다.

    • PROJECT_ID: 앱과 Outlook 커넥터가 있는 프로젝트의 ID입니다.
    • APP_ID: 작업을 연결할 앱의 ID입니다.
    • COLLECTION_ID: 이전 단계에서 만든 Outlook 커넥터의 ID입니다.

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