技術ドキュメント
自動生成
API仕様 → AIが整形 → Word/PDFをエクスポート
// エージェントセッションログ
"OpenAPI仕様からAPIリファレンスを生成してください。エンタープライズ形式、PythonとJSのサンプル、changelogセクション、DOCXとPDFで出力。"
// 実行シーケンスの計画
- → openapi.yamlを解析 — エンドポイント&スキーマを抽出
- → エンタープライズ .dotx テンプレートを適用
- → パラメータ+レスポンス付きエンドポイントセクションを生成
- → Python + JS コードサンプルを挿入
- → 目次+索引+changelogを自動生成
$ ap-docs new --type api-reference --template enterprise-docs
✓ Document created from enterprise template
$ ap-docs parse-openapi --input openapi.yaml --sections endpoints,schemas
✓ Parsed: 42 endpoints, 18 request/response schemas
$ ap-docs generate-sections --code-examples python,javascript
✓ 42 endpoint sections with dual-language code blocks
$ ap-docs export --word --pdf --toc --index
✓ api-reference-v2.docx (84 pages) · api-reference-v2.pdf
// このシナリオでサポートされる機能
OpenAPI / Swaggerインポート
YAMLまたはJSON仕様ファイルを解析。エンドポイントセクションを自動生成。
多言語コードサンプル
全エンドポイントにcurl、Python、JavaScript、Go、Javaサンプルを自動生成。
自動目次+索引
見出しから目次とフルテキスト索引を生成。PDFでクリックナビゲーション可能。
エンタープライズテンプレート
ロゴ、ヘッダー、フッター付きの .dotx テンプレートを適用。
マルチフォーマット出力
DOCX、PDF、ODT、HTMLとしてエクスポート。
仕様変更の自動更新
更新された仕様で再実行 — ドキュメントが差分更新される。
// エージェントをデプロイ
API仕様から1分以内にエンタープライズドキュメント。
NotionからWordへのコピペは不要。AgentPuterが仕様から完璧に整形されたドキュメントを生成します。