> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/ja/work/writing-assistants.md).

# 活用事例：文書作成とコンテンツ制作

ロール指示で文書・コンテンツ作成 Agent を作る：翻訳、公文書作成、内容証明郵便の草案作成、広告コピー、コピー診断、SEO チェック、教材設計、会話練習を、社内の質問応答で同僚が利用できます。

翻訳、公文書、マーケティングコピーといった業務には、決まった形式やチェックポイントがあるため、専用の Agent に任せるのに向いています。ユーザーに何を提供してもらうか、出力はどのような形か、してはいけないことは何かをロール指示に書いておけば、同僚は会話を開いて求められた情報を渡すだけで、形式の統一された初稿を得られます。

{% hint style="info" %}
自分で構築する前に、[Agent マーケット](https://docs.maiagent.ai/maiagent-user-guide/ja/work/built-in-agents.md#available-scenarios)と [Agent テンプレートライブラリ](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/agent-templates.md)をご確認ください。人事、法務、総務、小売などのシーンには、職務記述書の作成、社内通知の作成、プレスリリースの草案作成、商品掲載用コピーなど、公式の Agent がすでに用意されています。そのまま有効にするか、テンプレートを適用してから修正できます。適したものが見つからない場合に、このページに沿って自作してください。
{% endhint %}

## 適用シーン <a href="#scenarios" id="scenarios"></a>

| Agent                                                                                                             | ユーザーが提供するもの                                     | ロール指示で明確にしておくポイント                                  |
| ----------------------------------------------------------------------------------------------------------------- | ----------------------------------------------- | -------------------------------------------------- |
| [**翻訳**](https://docs.maiagent.ai/maiagent-user-guide/ja/work/writing-assistants/translation.md)                  | テキストまたはアップロードした文書、翻訳先の言語                        | 言語が指定されていない場合にどの言語へ翻訳するか、固有名詞の対訳、原文の段落と書式の保持       |
| [**公文書作成**](https://docs.maiagent.ai/maiagent-user-guide/ja/work/writing-assistants/official-document.md)         | 公文書の種類（簽、函、会議通知書など）、発信部署と受信部署、件名と説明の要点、日付、添付資料  | 公文書の構成と用語、情報が不足している場合は先に質問すること、既存の原稿も受け付けて修正案を示すこと |
| [**内容証明郵便の草案作成**](https://docs.maiagent.ai/maiagent-user-guide/ja/work/writing-assistants/legal-attest-letter.md) | 差出人と受取人の情報、経緯、具体的な要求と期限、相手が履行しない場合のその後の対応、裏付け資料 | 草案のみを作成し、発送前に法務担当者または弁護士に確認してもらうよう促すこと             |
| [**広告のアイデアとコピー**](https://docs.maiagent.ai/maiagent-user-guide/ja/work/writing-assistants/ad-copywriting.md)      | 商品またはキャンペーン、ターゲット層、掲載チャネルと文字数の制限                | 複数の切り口を一度に提案し、各案の訴求ポイントを明記すること                     |
| **コピー診断**                                                                                                         | コピーの種類、ターゲット層、期待する目標、見出しと本文                     | 固定の評価項目（例：訴求力、説得力、読みやすさ）、良い点、改善点、書き直しの例            |
| **SEO チェック**                                                                                                      | ウェブページの内容または URL、ターゲットキーワード、ターゲット層              | チェック項目（タイトル、ディスクリプション、段落構成、キーワードの配置）とレポートの形式       |
| **教材設計**                                                                                                          | 講座のテーマ、学習者と習熟度、講座の時間数                           | 指導案の構成、授業内のアクティビティ、練習問題とテストの形式                     |
| **会話練習コーチ**                                                                                                       | 練習のシチュエーション（新人研修、営業トーク、クレーム対応）と演じる役割            | 先に相手役を演じて会話を行い、ユーザーが「終了」と言ったあとにフィードバックと改善案を示すこと    |

最初の 4 種類の Agent については、それぞれ構築事例のページがあり、そのまま貼り付けられるロール指示、ナレッジベースとツールの設定、テスト用の質問、よくある質問を掲載しています。

* [公文書作成アシスタント](https://docs.maiagent.ai/maiagent-user-guide/ja/work/writing-assistants/official-document.md)
* [法的な内容証明郵便の草案作成](https://docs.maiagent.ai/maiagent-user-guide/ja/work/writing-assistants/legal-attest-letter.md)
* [AI スマート翻訳](https://docs.maiagent.ai/maiagent-user-guide/ja/work/writing-assistants/translation.md)
* [広告コピーとアイデア発想](https://docs.maiagent.ai/maiagent-user-guide/ja/work/writing-assistants/ad-copywriting.md)

## 構築の流れ <a href="#setup-workflow" id="setup-workflow"></a>

### 1. Agent を作成する <a href="#step1-create-agent" id="step1-create-agent"></a>

[Agent を作成](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/setup.md)します。名前には用途をそのまま書き、たとえば「公文書作成アシスタント」のようにして、同僚がひと目でどれを使えばよいかわかるようにします。

### 2. ロール指示を書く <a href="#step2-write-instructions" id="step2-write-instructions"></a>

上の表に沿って、ユーザーからどの情報を集めるか、出力の形式、してはいけないことの 3 点を書きます。書き方は[ロール指示設計ガイド](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/system-prompt.md)を参考にしてください。公文書作成を例にすると、次のようになります。

```
## ロール
あなたは公文書作成アシスタントです。同僚が政府機関とやり取りする公文書の作成を支援します。

## 先に情報を集める
作成を始める前に、次の情報を確認してください。不足している項目は 1 つずつ質問し、勝手に推測しないでください。
1. 公文書の種類（簽、函、書函、会議通知書など）
2. 発信部署と受信部署
3. 件名と説明の要点
4. 関連する日付と期限
5. 添付資料（ある場合）

## 出力
- 公文書の種類に応じた構成を使用し、件名は簡潔に、説明は項目ごとに箇条書きにする
- ユーザーが既存の原稿を提供した場合は、先に修正案を列挙し、そのあとに修正後の全文を付ける

## 制限
- 法令の条番号、文書番号、日付を捏造しない。不確かな場合は「要確認」と表示する
```

### 3. 参考資料を準備する（任意） <a href="#step3-knowledge-base" id="step3-knowledge-base"></a>

社内規定に沿って作成する必要がある場合は、テンプレート、用語対応表、ブランドのトーンガイド、過去の優れた事例を[ナレッジベース](https://docs.maiagent.ai/maiagent-user-guide/ja/build/knowledge-base/km-basic-settings.md)にアップロードし、Agent に紐づけます。翻訳 Agent には固有名詞の対訳表、公文書 Agent には部署でよく使うテンプレートを入れておくとよいでしょう。

### 4. 必要な機能を有効にする <a href="#step4-enable-features" id="step4-enable-features"></a>

* 同僚が文書（翻訳、コピー診断、内容証明郵便の裏付け資料）をアップロードできるようにするには、この Agent の「内部」チャットプラットフォームの[機能設定](https://docs.maiagent.ai/maiagent-user-guide/ja/build/conversation-settings/platform-settings/function-settings.md#basic-functions)で<mark style="color:blue;">ファイルのアップロードを許可</mark>を有効にします。
* SEO チェック Agent が URL を自分で読み取れるようにするには、[Browser Tool](https://docs.maiagent.ai/maiagent-user-guide/ja/build/agent/browser-tool.md) を追加します。ツールを追加していない場合は、ユーザーにウェブページの内容を直接貼り付けてもらってください。
* PDF 全体をレイアウトを保ったまま翻訳したい場合は、代わりにナレッジベースの [PDF 文書翻訳](https://docs.maiagent.ai/maiagent-user-guide/ja/build/knowledge-base/translate-pdf.md)を使用します。

### 5. 同僚に公開する <a href="#step5-share" id="step5-share"></a>

[ロール権限](https://docs.maiagent.ai/maiagent-user-guide/ja/org/roles/role-permission.md)で、この Agent の「内部」チャットプラットフォームを必要なロールに割り当てると、同僚は [Agent マーケット](https://docs.maiagent.ai/maiagent-user-guide/ja/work/explain.md)の組織自作タブから選んで会話を始められます。メンバーに Agent が表示されない場合は、[組織自作タブに表示される Agent](https://docs.maiagent.ai/maiagent-user-guide/ja/work/built-in-agents.md#self-built-tab-conditions)を参照して原因を調べてください。

## ご利用上の注意 <a href="#notes" id="notes"></a>

{% hint style="warning" %}

* 内容証明郵便や公文書などの正式な文書について、AI が作成するのはあくまで草案です。発送前に、責任者が事実関係、法令、用語を確認してください。
* 契約書や規程などの文書を翻訳する場合は、重要な条文を両言語に精通した同僚が再確認してください。
  {% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/maiagent-user-guide/ja/work/writing-assistants.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
