Confluence
ShanoneのConfluence連携は、Atlassian Confluenceを扱う46個のツールをエージェントに提供します。ページ、ブログ記事、コメント、ラベル、添付ファイル、スペース、タスク、検索が対象です。はじめに
1
Atlassian APIトークンを発行する
Atlassian API tokensにアクセスし、アカウント用の新しいトークンを作成します。
2
認証情報をShanoneに登録する
Shanoneダッシュボードの連携を開き、Confluenceを選択して、AtlassianアカウントのメールアドレスとAPIトークンを入力します。
3
リクエストを再実行する
保存が完了すると、
confluence_*ツールに対するshanone_execute_tool呼び出しが成功するようになります。利用可能なツール
ShanoneはConfluence向けに46個のツールを、以下のカテゴリに整理して提供しています。ページ
ページ
confluence_list_pages, confluence_get_page, confluence_get_page_children, confluence_create_page, confluence_update_page, confluence_delete_page, confluence_update_page_title, confluence_get_page_ancestors, confluence_get_page_descendantsブログ記事
ブログ記事
confluence_list_blogposts, confluence_get_blogpost, confluence_create_blogpost, confluence_update_blogpost, confluence_delete_blogpostコメント
コメント
confluence_create_comment, confluence_list_page_comments, confluence_get_comment, confluence_update_comment, confluence_delete_comment, confluence_create_inline_comment, confluence_list_inline_commentsラベル
ラベル
confluence_get_page_labels, confluence_add_label, confluence_remove_label, confluence_list_labels, confluence_get_label_pages, confluence_get_space_labels添付ファイル
添付ファイル
confluence_list_attachments, confluence_get_attachment, confluence_delete_attachment, confluence_upload_attachmentスペース
スペース
confluence_list_spaces, confluence_get_space, confluence_create_spaceタスク
タスク
confluence_list_tasks, confluence_get_task, confluence_update_taskプロパティ・権限 & バージョン
プロパティ・権限 & バージョン
confluence_get_page_properties, confluence_create_page_property, confluence_get_space_properties, confluence_get_space_permissions, confluence_get_page_operations, confluence_get_page_versions, confluence_get_page_version_details検索 & ユーザー
検索 & ユーザー
confluence_search, confluence_bulk_user_lookupよくあるユースケース
ドキュメントの保守
古くなったページを更新し、バージョン管理された変更コメントを追加する
ナレッジ検索
新しいコンテンツを書く前に、スペース内の過去の決定事項やドキュメントを検索する
スペースのオンボーディング
初期ページ構成と権限概要を持つ新しいスペースを作成する
レビューワークフロー
ページの草稿にインラインコメントを追加し、対応済みになったら解決する
トラブルシューティング
トークンは有効に見えるのにツールが401で失敗する
トークンは有効に見えるのにツールが401で失敗する
Confluence Cloudでは、トークン単体ではなくアカウントのメールアドレスとAPIトークンの組み合わせ(Basic認証)が必要です。連携ページの両方のフィールドが保存されているか確認してください。
confluence_create_pageが本文フォーマットのエラーで失敗する
confluence_create_pageが本文フォーマットのエラーで失敗する
Confluenceのページ本文は、APIバージョンによってAtlassian Document Format(ADF)またはstorage形式のXHTMLを使用します。リッチコンテンツを送信する前に、
confluence_create_pageについてshanone_get_tool_schemaでどちらの形式が期待されているか確認してください。confluence_searchの結果が想定より少ない
confluence_searchの結果が想定より少ない
confluence_searchは内部でCQL(Confluence Query Language)を使用します。単純なキーワードでも動作しますが、スペース・ラベル・タイプなどで正確に絞り込むにはフリーテキストではなく適切なCQL式を組み立ててください。