Fireflies
ShanoneのFireflies連携は、Fireflies.aiのGraphQL APIを通じて会議のトランスクリプトや要約を扱う21個のツールをエージェントに提供します。トランスクリプトの検索、ハイライトの切り出し(「Bite」)、ライブ会議やチャンネルの管理などが行えます。はじめに
1
FirefliesのAPIキーを取得する
Fireflies内で、設定 → Integrations → API Accessに移動し、APIキーを生成します。
2
Shanoneにキーを追加する
Shanoneダッシュボードの連携を開き、Firefliesを選択してAPIキーを貼り付けます。
3
リクエストを再実行する
保存が完了すると、
fireflies_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。利用可能なツール
ShanoneはFireflies向けに21個のツールを、以下のカテゴリに整理して提供しています。クエリ
クエリ
fireflies_get_user, fireflies_list_users, fireflies_get_user_groups, fireflies_get_transcript, fireflies_list_transcripts, fireflies_get_bite, fireflies_list_bites, fireflies_list_channels, fireflies_get_channel, fireflies_list_contacts, fireflies_get_ai_app_outputs, fireflies_list_active_meetingsミューテーション
ミューテーション
fireflies_upload_audio, fireflies_add_to_live_meeting, fireflies_delete_transcript, fireflies_set_user_role, fireflies_update_meeting_title, fireflies_update_meeting_privacy, fireflies_update_meeting_channel, fireflies_create_bite, fireflies_share_meetingよくあるユースケース
会議要約の配布
会議終了直後にトランスクリプトとAIアプリの出力(要約、アクションアイテム)を取得する
ハイライトの切り出し
トランスクリプト内の重要な場面から「Bite」を作成し、会議に参加できなかった人に共有する
ライブ会議ボットの管理
fireflies_add_to_live_meetingを使って、進行中の会議にFirefliesのノートテイカーボットを追加するトランスクリプトのガバナンス
会議のプライバシー設定やチャンネル割り当てを監査したり、保持すべきでないトランスクリプトを削除する
トラブルシューティング
fireflies_upload_audioがすぐにトランスクリプトを返さない
fireflies_upload_audioがすぐにトランスクリプトを返さない
文字起こしは非同期処理です。処理が完了するまで、返された会議IDを使って
fireflies_get_transcriptやfireflies_list_transcriptsをポーリングしてください。クエリでレート制限に達してしまう
クエリでレート制限に達してしまう
Firefliesはプランごとにレート制限を課しています(Free: 50件/日、Pro: 500件/日、Business/Enterprise: 60件/分)。個々のトランスクリプトを短いループでポーリングするのではなく、
fireflies_list_transcriptsの呼び出しをまとめてください。fireflies_set_user_roleや管理系のツールが権限エラーを返す
fireflies_set_user_roleや管理系のツールが権限エラーを返す
ロール管理や一部の組織レベルのクエリは、接続中のAPIキーが通常メンバーではなくFirefliesの管理者アカウントに属していることを要求します。