Skip to main content

​
Miro

ShanoneのMiro連携は、ボードをプログラムから組み立てるための47個のツールをエージェントに提供します——すべてのウィジェットタイプ(付箋、図形、カード、テキスト、画像、フレーム、コネクタ)に加えて、ボードの共有やタグも扱えます。

​
はじめに

1

OAuthで接続する

エージェントにMiro関連の作業を依頼(例: 「ロードマップボードに付箋を追加して」)するか、Shanoneダッシュボードの連携から事前に接続しておきます。
2

Miroワークスペースを許可する

Shanoneに操作させたいチーム/ワークスペースについて、MiroのOAuth同意画面を承認します。
3

リクエストを再実行する

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

​
利用可能なツール

ShanoneはMiro向けに47個のツールを、以下のカテゴリに整理して提供しています。
miro_list_boards, miro_get_board, miro_create_board, miro_update_board, miro_delete_board, miro_copy_board, miro_get_board_members, miro_share_board, miro_get_board_member, miro_update_board_member, miro_remove_board_member
miro_get_items, miro_get_item, miro_update_item_position, miro_delete_item, miro_bulk_create_items
miro_create_sticky_note, miro_update_sticky_note, miro_create_shape, miro_update_shape
miro_create_card, miro_update_card, miro_create_app_card, miro_update_app_card
miro_create_text, miro_update_text, miro_create_image, miro_update_image, miro_create_document, miro_update_document, miro_create_embed, miro_update_embed
miro_create_frame, miro_update_frame, miro_create_connector, miro_update_connector
miro_create_group, miro_get_group_items, miro_update_group, miro_ungroup, miro_delete_group
miro_list_tags, miro_create_tag, miro_get_tag, miro_update_tag, miro_delete_tag, miro_attach_tag_to_item

​
よくあるユースケース

自動生成される振り返りボード

列を持つボードを作成し、議事録から付箋を生成して配置する

図の自動生成

説明されたプロセスに基づいて、図形とコネクタからフローチャートを組み立てる

コンテンツの一括インポート

miro_bulk_create_itemsを使って、1回の呼び出しで多数のアイテムをボードに投入する

ボードの整理

ステータスや担当者でアイテムにタグ付けし、関連アイテムをグループ化する

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

Miroボードの座標は画面上のピクセルではなく、固定のキャンバス空間上のものです——新しいアイテムを作成する前に、まず既存のボードでmiro_get_itemsを呼び、使われている座標の範囲を把握してください。
バルク作成は1リクエスト単位でall-or-nothingですが、1回の呼び出しあたりのアイテム数に上限があります——サイズ上限エラーが出た場合は、大きなバッチを複数のmiro_bulk_create_items呼び出しに分割してください。
共有はMiro自身のメール招待フローを通じて行われ、招待されたユーザーがそれを承諾する必要があります——miro_get_board_membersでpending/active状態を確認してください。