EMQXエージェントをOutlookに接続する
Outlookコネクターを使用すると、EMQXエージェントがOutlookのメール、メールボックスフォルダー、添付ファイル、連絡先、カレンダーイベントと連携できます。認可されたMicrosoftアカウントを通じてメールやカレンダーのワークフローを自動化するために利用します。
一般的なユースケース
- 運用用メールボックスを検索し、最近のインシデントメッセージを要約する。
- エージェントが異常状態を検知した後にメールを作成または送信する。
- メンテナンスカレンダーイベントを作成または更新する。
- 添付ファイルを読み込み、その内容をワークフローで利用する。
チャットプロンプトの例：
text
operations-outlookコネクターを使って、過去24時間のデバイス障害に関する未読メッセージを検索し、要約を作成してください。メールは送信しないでください。前提条件
コネクターを追加する前に、以下を準備してください：
- Outlookにアクセス可能なMicrosoftアカウント
- 必要なメール、連絡先、カレンダー操作を認可する権限
- ワークフローで必要となる共有メールボックス、カレンダー、連絡先フォルダー、添付ファイルへのアクセス権
Outlookコネクターの追加手順
- 左側のナビゲーションメニューで Connectors をクリックします。
- Available タブで Outlook を見つけて Add をクリックします。
- 説明的なコネクター名を入力します。
- Confirm をクリックすると、Microsoft認証フローがダイアログで開きます。
- 接続するMicrosoftアカウントを選択するか、Use another account を選択します。
- 認証ダイアログが閉じてEMQXエージェントに戻るまで待ちます。
- Added タブでコネクターのステータスが Authorized になっていることを確認します。
対応ツール
カレンダー
| ツール | アクセス | 説明 |
|---|---|---|
OUTLOOK_ACCEPT_EVENT | 書き込み | カレンダーイベントの招待を承諾します。 |
OUTLOOK_CANCEL_EVENT | 破壊的 | カレンダーイベントをキャンセルします。 |
OUTLOOK_GET_CALENDAR_VIEW | 読み取り | 指定期間内に発生または重複するイベントを取得します。 |
OUTLOOK_LIST_EVENTS | 読み取り | カレンダーイベントを一覧表示します。 |
OUTLOOK_LIST_USER_CALENDAR_VIEW | 読み取り | ユーザーのカレンダー内の指定期間のイベントを取得します。 |
OUTLOOK_SEARCH_EVENTS | 読み取り | カレンダーイベントを検索します。 |
OUTLOOK_CALENDAR_CREATE_EVENT | 書き込み | デフォルトカレンダーにイベントを作成します。 |
OUTLOOK_CREATE_CALENDAR_EVENT_IN_CALENDAR | 書き込み | 選択したカレンダーにイベントを作成します。 |
OUTLOOK_UPDATE_CALENDAR_EVENT | 書き込み | デフォルトカレンダーのイベントを更新します。 |
OUTLOOK_UPDATE_CALENDAR_EVENT_IN_CALENDAR | 書き込み | 選択したカレンダーのイベントを更新します。 |
メール送信と下書き管理
| ツール | アクセス | 説明 |
|---|---|---|
OUTLOOK_CREATE_DRAFT | 書き込み | 宛先、件名、本文、添付ファイル付きのメール下書きを作成します。 |
OUTLOOK_CREATE_DRAFT_REPLY | 書き込み | メッセージへの返信用下書きを作成します。 |
OUTLOOK_REPLY_EMAIL | 書き込み | メールに返信します。 |
OUTLOOK_SEND_DRAFT | 書き込み | メール下書きを送信します。 |
OUTLOOK_SEND_EMAIL | 書き込み | Outlook経由でメールを送信します。 |
メールボックスフォルダー
| ツール | アクセス | 説明 |
|---|---|---|
OUTLOOK_GET_MAIL_FOLDER | 読み取り | メールボックスフォルダーを取得します。 |
OUTLOOK_GET_MAIL_FOLDER_MESSAGE | 読み取り | 選択したメールボックスフォルダーからメッセージを取得します。 |
OUTLOOK_LIST_MAIL_FOLDER_MESSAGES | 読み取り | メールボックスフォルダー内のメッセージを一覧表示します。 |
OUTLOOK_LIST_MAIL_FOLDERS | 読み取り | メールボックスフォルダーを一覧表示します。 |
メールの読み取りと管理
| ツール | アクセス | 説明 |
|---|---|---|
OUTLOOK_MOVE_MESSAGE | 書き込み | メッセージを別のメールボックスフォルダーに移動します。 |
OUTLOOK_UPDATE_EMAIL | 書き込み | メッセージのプロパティを更新します。 |
OUTLOOK_GET_ME_MESSAGE_MIME_CONTENT | 読み取り | メッセージのMIMEコンテンツを取得します。 |
OUTLOOK_GET_MESSAGE | 読み取り | メッセージIDでメッセージを取得します。 |
OUTLOOK_LIST_MESSAGES | 読み取り | メールボックス内のメッセージを一覧表示します。 |
OUTLOOK_LIST_SENT_ITEMS_MESSAGES | 読み取り | 送信済みメッセージを一覧表示します。 |
OUTLOOK_QUERY_EMAILS | 読み取り | OData条件を使ってフォルダー内のメッセージをクエリします。 |
OUTLOOK_SEARCH_MESSAGES | 読み取り | KQLを使ってメールボックスを検索します。 |
添付ファイル
| ツール | アクセス | 説明 |
|---|---|---|
OUTLOOK_DOWNLOAD_OUTLOOK_ATTACHMENT | 読み取り | メールの添付ファイルをダウンロードします。 |
OUTLOOK_GET_USER_MESSAGES_ATTACHMENTS | 読み取り | メッセージの添付ファイル情報を取得します。 |
連絡先とユーザー
| ツール | アクセス | 説明 |
|---|---|---|
OUTLOOK_CREATE_CONTACT | 書き込み | Outlookの連絡先フォルダーに連絡先を作成します。 |
OUTLOOK_LIST_USER_CONTACTS | 読み取り | ユーザーの連絡先を一覧表示します。 |
OUTLOOK_UPDATE_CONTACT | 書き込み | 連絡先を更新します。 |
OUTLOOK_GET_PROFILE | 読み取り | Outlookユーザープロファイルを取得します。 |
重要なお知らせ
メール送信および返信ツールは外部と通信します。カレンダーのキャンセルおよび更新ツールは参加者のスケジュールを変更します。メッセージの移動および更新ツールはメールボックスの状態を変更します。
チャットでのコネクター利用方法
- チャット入力欄でコネクターアイコンをクリックします。
- 認可済みの Outlook コネクターを選択します。
- プロンプト内でエージェントが使用する外部リソースと操作を指定します。
- 生成されたエージェント定義を確認し、必要なツールのみが含まれていることを確認します。
権限とデータアクセス
コネクターは認可されたMicrosoftアカウントを使用します。Microsoft 365テナントのポリシー、メールボックス権限、カレンダー共有、連絡先フォルダーアクセスが利用可能なリソースと操作を決定します。
チャットプロンプトやエージェント指示に外部サービスの認証情報やアクセストークンを含めないでください。
制限事項
- Microsoft Graph APIのクォータおよびMicrosoft 365テナントのポリシーが適用されます。
- 共有メールボックスおよび委任されたカレンダーアクセスには管理者設定が必要な場合があります。
- メッセージ検索の挙動はODataクエリとKQL検索で異なります。
トラブルシューティング
| 症状 | 対処方法 |
|---|---|
| コネクターが Unauthorized のままになる。 | 認証を再試行し、接続するMicrosoftアカウントを選択してください。 |
| ツールが権限エラーを返す。 | 認可されたアカウントの対象リソースおよび操作へのアクセス権を確認してください。 |
| 必要なツールが利用できない。 | ツールがこのコネクターでサポートおよび承認されているか確認し、チャットで再度コネクターを選択してください。 |
| リクエストが断続的に拒否される。 | 外部サービスのステータス、APIクォータ、レート制限、アカウントプランを確認してください。 |