Feishu Document Tool

単一ツール feishu_doc はアクションパラメータを持ち、コメント管理を含む全てのドキュメント操作に対応しています。

トークン抽出

URL https://xxx.feishu.cn/docx/ABC123def から → doc_token = ABC123def URL https://xxx.feishu.cn/docs/doccn123c から → doc_token = doccn123c

アクション

ドキュメント読み込み

{ "action": "read", "doc_token": "ABC123def" }

戻り値: タイトル、プレーンテキストコンテンツ、ブロック統計。hint フィールドを確認してください - 存在する場合、list_blocks が必要な構造化コンテンツ（テーブル、画像）が存在します。

ドキュメント書き込み（全置換）

{ "action": "write", "doc_token": "ABC123def", "content": "# Title\n\nMarkdown content..." }

ドキュメント全体をMarkdownコンテンツで置換します。対応形式: 見出し、リスト、コードブロック、引用、リンク、画像（![](url) は自動アップロード）、太字/斜体/打消し線。

制限事項: Markdownテーブルは非対応です。

作成 + 書き込み（アトミック、推奨）

{
  "action": "create_and_write",
  "title": "New Document",
  "content": "# Title\n\nMarkdown content..."
}

フォルダ指定時:

{
  "action": "create_and_write",
  "title": "New Document",
  "content": "# Title\n\nMarkdown content...",
  "folder_token": "fldcnXXX"
}

ドキュメント作成と書き込みを1回で実行します。別々の create + write より優先してください。

コンテンツ追記

{ "action": "append", "doc_token": "ABC123def", "content": "Additional content" }

ドキュメントの末尾にMarkdownを追記します。

ドキュメント作成

{ "action": "create", "title": "New Document" }

フォルダ指定時:

{ "action": "create", "title": "New Document", "folder_token": "fldcnXXX" }

空のドキュメント（タイトルのみ）を作成します。

ブロック一覧表示

{ "action": "list_blocks", "doc_token": "ABC123def" }

テーブル、画像を含む完全なブロックデータを返します。構造化コンテンツを読み込む場合はこちらを使用してください。

単一ブロック取得

{ "action": "get_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }

ブロックテキスト更新

{ "action": "update_block", "doc_token": "ABC123def", "block_id": "doxcnXXX", "content": "New text" }

ブロック削除

{ "action": "delete_block", "doc_token": "ABC123def", "block_id": "doxcnXXX" }

コメント一覧表示

{ "action": "list_comments", "doc_token": "ABC123def", "page_size": 50 }

ドキュメント内の全コメントを返します。ページネーション時は page_token を使用してください。コメントには is_whole フィールドが含まれており、ドキュメント全体へのコメント（true）とブロックレベルのコメント（false）を区別できます。

単一コメント取得

{ "action": "get_comment", "doc_token": "ABC123def", "comment_id": "comment_xxx" }

コメント作成

{ "action": "create_comment", "doc_token": "ABC123def", "content": "Comment text" }

コメント返信一覧表示

{ "action": "list_comment_replies", "doc_token": "ABC123def", "comment_id": "comment_xxx", "page_size": 50 }

page_size は正の整数である必要があります。省略時は、ツールはデフォルトの 50 を使用します。

コメント書き込みスコープ

現在のツールは、ドキュメント化されたコメント書き込みアクション create_comment（グローバルコメント作成）を提供します。 返信については、list_comment_replies を取得に使用してください。返信作成エンドポイントは現在の SDK サーフェスでは公開されていません。

読み込みワークフロー

1. action: "read" で開始 - プレーンテキスト + 統計を取得
2. レスポンスの block_types でテーブル、画像、コードなどを確認
3. 構造化コンテンツが存在する場合、action: "list_blocks" で完全なデータを取得

設定

channels:
  feishu:
    tools:
      doc: true  # default: true

注: feishu_wiki はこのツールに依存します - Wikiページコンテンツは feishu_doc 経由で読み書きされます。

権限

必須: docx:document, docx:document:readonly, docx:document.block:convert, drive:drive

コメント操作時:

• コメント読み込み: docx:document.comment:read
• コメント書き込み: docx:document.comment（オプション、create_comment 用）