コンテンツにスキップ
Escriba Suite Escriba Suite

Presentiaドキュメント

Presentiaは主にダッシュボードから使います：プロンプト、ドキュメント、データセット、markdownから デッキを作成し、（AIアシスタント付きの）エディターで仕上げ、PPTXまたはPDFにエクスポートします。 このページではフォーク独自の機能とAPIを扱います。日常のエディターは、アップストリームから期待される とおりに動きます。

Markdownからデッキへ（Gammaモード）

Section titled “Markdownからデッキへ（Gammaモード）”

Markdown ページには完全なエディターがあります — ツールバー、テキストがどのようにカードに 分割されるかを正確に示すライブプレビュー、カードカウンター、ドラッグ & ドロップ — に加えて、 テンプレート、言語、画像のソース / スタイル、エクスポートのピッカー。--- または #/## 見出しで区切られた各セクションがカードになります。

text_mode何が起きるか
preserveテキストは一字一句そのままデッキに入ります — AIはレイアウトの選択と画像の生成だけを行います。
condenseAIは構造を保ちながら各カードを要約します。
generateAIは各カードを書き直し、拡張します。

同じ力がAPI経由でも使えます：

Terminal window
curl -X POST http://localhost:5001/api/v1/ppt/presentation/generate-from-markdown \
  -H "Content-Type: application/json" \
  -d '{
        "markdown": "# Q3 Review\nIntro...\n\n---\n\n## Results\n- Revenue up 20%",
        "text_mode": "preserve",
        "template": "general",
        "export_as": "pptx"
      }'

実データからのグラフ

Section titled “実データからのグラフ”

POST /api/v1/ppt/presentation/generate-from-data は、CSV、TSV、JSONデータセットからデッキを 構築します（multipart：file、加えて content、n_slides、language、template、 instructions、export_as）。アンチ幻覚ガードはグラフのすべての数字をデータセットに対して チェックします — 正確な値、または列の正確な集計（合計、平均、最小、最大、件数）のみ。誤った数字は フィードバック付きで1回だけ再試行され、モデルが固執すれば却下されます。

Terminal window
curl -X POST http://localhost:5001/api/v1/ppt/presentation/generate-from-data \
  -F "file=@monthly_summary.csv" \
  -F "content=Monthly reconciliation report" \
  -F "n_slides=6" -F "language=English" -F "export_as=pdf"

データセットは事前に集計済みであることが期待されます。行数上限は DATASET_MAX_ROWS （既定200）です。既定のテンプレートはグラフレイアウトを備えた Report です。

コストとモデル

Section titled “コストとモデル”

アップストリームにはない2つのダッシュボードページ：

  • Models — テキストと画像のモデルカタログ。キュレーションされた品質ドット、100万トークン あたりのブレンド価格、あなたのキーから算出される利用可否、推奨バッジ付き。カードをクリックして 切り替えます。OpenRouterのキーがあれば、ほぼすべてが一度に点灯します。
  • Costs — サマリーカード（呼び出し数、入出力トークン、推定コスト）と、ステージ、スライド、 モデルごとのデッキ別内訳、加えてプロバイダー比較表。価格はリポジトリ内のバージョン管理された カタログに由来するため、コスト履歴は監査可能です。

Escribaスイートの統合

Section titled “Escribaスイートの統合”

Presentiaはスタンドアロンで動作します — これらの変数がなければ、素のPresentonとまったく 同じように振る舞います。各統合はオプトインで独立しており、リポジトリの docker-compose.yml には それらすべてのコメントアウトされたサービスブロックが同梱されています。

  • Escriba — OCR付きのドキュメント解析。 ESCRIBA_ENABLED=true + ESCRIBA_URL で、 ドキュメント → markdownの変換をEscribaサービスに委譲します（スキャンされたPDF、回転した ページ、画像、20以上の形式）。Escribaが落ちているか、あるファイルで失敗した場合、Presentiaは ローカルのパーサーに自動的にフォールバックします。
  • Anonimal — LLMの前のPII匿名化。 ANONIMAL_ENABLED=true + ANONIMAL_URL で、ユーザーの プロンプトと抽出されたドキュメントテキストを、LLMプロバイダーへ渡る前に匿名化します。 フェイルクローズ：サービスが応答しない場合、生のPIIを送る代わりに、明確なエラーとともに 生成が停止します。元のテキストがあなたのホストから出ることはありません。
  • Searchgirl — プライベートなWeb検索。 WEB_SEARCH_PROVIDER=searchgirl + SEARCHGIRL_BASE_URL で、サードパーティのAPIの代わりに自分のメタ検索インスタンスを通じて 生成をグラウンディングします（オプションのBearerトークン付き）。

テンプレート、テーマ、言語

Section titled “テンプレート、テーマ、言語”

組み込みのテンプレートファミリー（General、Modern、Standard、Swift、グラフ付きのReport、 es-ARのInstitucional）、自分のPPTXから生成するカスタムテンプレート、完全なテーマエディター （色、フォント、ロゴ）、そして文章のトーンを形作るテンプレートごとの style_instructions。 インターフェース全体が 7言語 — English、Español、Français、Português、Italiano、中文、 日本語 — で提供され、サイドバーから切り替えられ、ブラウザごとに記憶されます。

開発

Section titled “開発”
Terminal window
docker compose up -d --build development   # hot reload for both servers
cd servers/fastapi && python -m pytest tests/unit   # the fork adds 100+ unit tests
GitHubで見る