> 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/en/work/km/internalkm.md).

# Professional Knowledge Management

Professional knowledge management example: build a knowledge base from maritime industry journals and reports and create an internal expert Q\&A Agent, covering the full process from creation to testin

When enterprises promote knowledge management, existing knowledge management systems are often limited to keyword search. This approach has limited semantic understanding, and the results are often imprecise, making it hard to meet the enterprise's large and diverse knowledge needs. Now, you can use MaiAgent to build a dedicated internal AI knowledge assistant for your enterprise and achieve smarter, more convenient knowledge management!

## Use Case: Build a Maritime Knowledge AI Q\&A Assistant <a href="#use-case-build-shipping-knowledge-qa-assistant" id="use-case-build-shipping-knowledge-qa-assistant"></a>

Suppose you are a supply chain management specialist at a shipping company who must regularly read journals and reports to keep up with the latest maritime trends, which are an important basis for business operations and decisions. However, as the international situation changes rapidly and industry knowledge evolves daily, the volume of information is huge and scattered, making it hard to grasp the key points in time. With MaiAgent, you can build a dedicated internal AI Q\&A assistant that not only helps you quickly locate, understand, and internalize key knowledge so you can follow trends in real time, but also promotes knowledge sharing and work efficiency across your whole team, improving the company's adaptability and competitiveness in a fast-changing market.

## Workflow <a href="#application-workflow" id="application-workflow"></a>

### 1. Create a Maritime Knowledge AI Q\&A Assistant <a href="#step1-create-shipping-knowledge-qa-assistant" id="step1-create-shipping-knowledge-qa-assistant"></a>

Enter the Agent name.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-4e0609ffc54f95c7a3a89cc54e561f79f5d79771%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.22.09.png?alt=media" alt=""><figcaption></figcaption></figure>

Select RAG and a language model.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-f1465b90817f05d28ade7e8d7dfa745d529f6078%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.22.33.png?alt=media" alt=""><figcaption></figcaption></figure>

When selecting the reply mode, if you have no special requirements, choose "RAG Q\&A", which fits this use case. The role instruction can be set as follows:

```
# Role
You are an internal maritime knowledge Q&A assistant at a shipping company

# Output Format
Use the format in the example below to reply with the three most relevant pieces of knowledge.

<example>
Your question relates to the following:

1. [Title] (content summary)
2. [Title] (content summary)
3. [Title] (content summary)
</example>

# Output Restrictions
- Reply in Traditional Chinese
- Use Taiwan terminology for technical terms, for example, change the mainland China term "集裝箱" to "貨櫃"
- Give priority to more recent materials
- Do not answer with information outside the knowledge base
- Answer based on knowledge base data; if you cannot answer, reply with the text in the <example> below

<example>
Sorry, the knowledge base currently does not contain the information you asked about
```

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-ab3654c704baa0ed4a66a5816319744513173360%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.23.01.png?alt=media" alt=""><figcaption></figcaption></figure>

Configure permissions, assign roles, and click Save.

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-24e17c41ce5a05eeedc3bb0ff8691af62fbd8e37%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.23.32.png?alt=media" alt=""><figcaption></figcaption></figure>

### 2. Upload the Knowledge Base <a href="#step2-upload-knowledge-base" id="step2-upload-knowledge-base"></a>

Here we use public data, the UNCTAD 2024 Review of Maritime Transport and the CR Technical Bulletin, as the reference sources for the knowledge base.

Here we use two public data sources, the UNCTAD 2024 Review of Maritime Transport and the CR Classification Society technical bulletin, as the reference basis for building the knowledge base.

<https://unctad.org/system/files/official-document/rmt2024overview_ch.pdf>

<https://www.crclass.org/wp-content/uploads/2025/02/138.pdf>

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-b9c821a752f57b2c4a7d2d2874ecf8073b963921%2F%E6%88%AA%E5%9C%96%202025-04-25%20%E4%B8%AD%E5%8D%8812.24.19.png?alt=media" alt=""><figcaption></figcaption></figure>

### 3. Put the Agent into Use <a href="#step3-ai-agent-go-live" id="step3-ai-agent-go-live"></a>

When you need to learn about maritime topics, you can now ask the Agent directly in the Q\&A interface!\
For example, if your manager asks you to write an analysis report on the Panama Canal, simply ask the Agent and get the relevant information instantly, without searching through documents one by one, improving your report writing efficiency!

<figure><img src="https://1360999650-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6v6TNkkOQVfRYfcNirHL%2Fuploads%2Fgit-blob-ad67a4071f4ec5ff8e5eb8ade48fbd86c519bc8b%2F%E6%88%AA%E5%9C%96%202025-04-24%20%E4%B8%AD%E5%8D%8812.59.10.png?alt=media" alt=""><figcaption></figcaption></figure>


---

# 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/en/work/km/internalkm.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.
