Skip to main content

​
Google Chat

ShanoneのGoogle Chat連携は、スペース・メッセージング・メンバー管理に加えて、他の連携ではあまり扱われない機能(在席状況、カスタム絵文字、既読状態、セクション)まで含む49個のツールをエージェントに提供します。

​
はじめに

1

OAuthで接続する

エージェントにGoogle Chat関連の作業を依頼(例: 「#launchスペースに要約を投稿して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Googleアカウントを許可する

Shanoneに操作させたいアカウントについて、GoogleのOAuth同意画面を承認します。
3

リクエストを再実行する

接続が完了すると、google_chat_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。

​
利用可能なツール

ShanoneはGoogle Chat向けに49個のツールを、以下のカテゴリに整理して提供しています。
google_chat_list_spaces, google_chat_get_space, google_chat_list_members, google_chat_find_direct_message, google_chat_create_space, google_chat_update_space, google_chat_delete_space, google_chat_setup_space, google_chat_find_group_chat
google_chat_list_messages, google_chat_get_message, google_chat_create_message, google_chat_create_card_message, google_chat_update_message, google_chat_delete_message, google_chat_search_messages, google_chat_replace_message_cards
google_chat_add_member, google_chat_remove_member, google_chat_get_member, google_chat_update_member_role
google_chat_add_reaction, google_chat_remove_reaction, google_chat_list_reactions, google_chat_pin_message, google_chat_unpin_message, google_chat_list_pinned_messages
google_chat_get_attachment, google_chat_download_media, google_chat_upload_attachment
google_chat_get_space_read_state, google_chat_mark_space_read, google_chat_get_thread_read_state, google_chat_get_notification_setting, google_chat_update_notification_setting
google_chat_get_user_availability, google_chat_set_availability_active, google_chat_set_availability_away, google_chat_set_availability_dnd, google_chat_update_availability
google_chat_list_custom_emojis, google_chat_create_custom_emoji, google_chat_get_custom_emoji, google_chat_delete_custom_emoji, google_chat_list_sections, google_chat_create_section, google_chat_update_section, google_chat_delete_section, google_chat_reorder_section

​
よくあるユースケース

自動ステータス更新

デプロイやビルドが完了したときに、整形されたカードメッセージをスペースに投稿する

スペースメンバーシップ管理

新しいメンバーをスペースに追加し、適切なメンバーロールを割り当てる

メッセージ検索 & トリアージ

スペースのメッセージ履歴を検索して、スレッドを解決した決定事項を見つけてピン留めする

在席状況を考慮した通知

すぐの返信を期待するダイレクトメッセージを送る前に、相手の在席状況を確認する

​
トラブルシューティング

カード形式のコンテンツにはgoogle_chat_create_messageではなくgoogle_chat_create_card_messageを使ってください——通常のメッセージツールはテキストのみを受け付けます。
非常に新しいメッセージは検索インデックスへの反映が遅れることがあり、検索対象は接続中のアカウントがメンバーになっているスペースに限られます。まずgoogle_chat_list_spacesで確認してください。
添付ファイルは、返された添付ファイルのリソースを使って後続のgoogle_chat_create_message呼び出しで参照する必要があります——アップロードだけではスペースに投稿されません。