Skip to main content

このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。

構築するもの#

会話を一般的なドキュメント形式にエクスポートする実用的な Dify プラグインを構築します。最終的に、プラグインは以下の機能を持ちます:

  • MarkdownテキストをWord文書(.docx)に変換
  • 会話をPDFファイルとしてエクスポート
  • 適切なフォーマットでファイル作成を処理
  • ドキュメントエクスポートのためのクリーンなユーザー体験を提供
所要時間

15分

前提条件

基本的なPython知識とドキュメント操作ライブラリへの習熟

ステップ1:環境のセットアップ#

Dify プラグイン CLIのインストール

インストールの確認:

プラグインプロジェクトの作成

新しいプラグインプロジェクトを初期化します:

プロンプトに従って入力してください:

  • Name: md_exporter
  • Type: tool
  • その他の詳細は指示に従って完了してください

ステップ2:プラグインマニフェストの定義#

manifest.yamlファイルを作成してプラグインのメタデータを定義します:

ステップ3:Wordエクスポートツールの定義#

word_export.yamlファイルを作成してWord文書エクスポートツールを定義します:

ステップ4:PDFエクスポートツールの定義#

PDFエクスポート用のpdf_export.yamlファイルを作成します:

ステップ5:必要な依存関係のインストール#

必要なライブラリを含むrequirements.txtを作成または更新します:

ステップ6:Wordエクスポート機能の実装#

utils/docx_utils.pyにユーティリティモジュールを作成します:

ステップ7:PDFエクスポート機能の実装#

utils/pdf_utils.pyにユーティリティモジュールを作成します:

ステップ8:ツール実装の作成#

まず、tools/word_export.pyにWordエクスポートツールを作成します:

次に、tools/pdf_export.pyにPDFエクスポートツールを作成します:

ステップ9:エントリーポイントの作成#

プロジェクトのルートにmain.pyファイルを作成します:

ステップ10:プラグインのテスト#

デバッグ環境のセットアップ

まず、テンプレートから .env ファイルを作成します:

Dify 環境の詳細を設定します:

依存関係のインストール

デバッグモードでプラグインを起動

ステップ11:配布用にパッケージ化#

プラグインを共有する準備ができたら:

これにより、配布用のplugin.difypkgファイルが作成されます。

クリエイティブな活用例#

レポート生成

このプラグインを使用して、分析サマリーをクライアント向けのプロフェッショナルなレポートに変換

セッションドキュメント化

コーチングやコンサルティングセッションのノートをフォーマットされたドキュメントとしてエクスポート

基本を超えて#

このプラグインを拡張するための興味深い方法をいくつか紹介します:

  • カスタムテンプレート:企業ブランディングやパーソナライズされたスタイルを追加
  • マルチフォーマットサポート:HTML、Markdown、その他のフォーマットへのエクスポートを拡張
  • 画像処理:会話からの画像を処理して含める
  • テーブルサポート:データテーブルの適切なフォーマットを実装
  • コラボレーティブ編集:Google Docsや類似のプラットフォームとの統合を追加
技術的な洞察

ドキュメント変換の核心的な課題は、フォーマットと構造を維持することです。このプラグインはまず Markdown を中間形式の HTML に変換し、その後その HTML をターゲット形式に処理します。

この 2 段階のプロセスは柔軟性をもたらします。HTML 表現で動作する新しい出力モジュールを追加するだけで、より多くのフォーマットをサポートできます。

PDF 生成では、CSS をサポートする高品質な PDF レンダリングを提供する WeasyPrint を使用します。Word 文書では、python-docx がドキュメント構造に対する詳細な制御を提供します。

まとめ#

会話をプロフェッショナルなドキュメント形式でエクスポートできる実用的なプラグインを構築し、AI 会話と従来のドキュメントワークフローの間のギャップを埋めました。

ドキュメント

機能、セットアップ、使用例を説明するREADME.mdを英語(en_US)で作成してください

ローカライゼーション

他の言語用にreadme/README_zh_Hans.mdなどの追加READMEファイルを作成してください