> 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/build/integrate.md).

# 活用事例：外部データ連携

外部データ連携

実際の運用シーンでは、AI アシスタントが正確かつタイムリーな回答を提供するために、ナレッジベース以外の「リアルタイムデータ」や「外部システムのデータ」へアクセスする必要が生じることがよくあります。MaiAgent のツール（API ツール、MCP ツール）機能を利用すれば、社内システムやサードパーティプラットフォームのデータソースを AI アシスタントに連携でき、システムをまたいだ検索やリアルタイム応答が可能なスマートアプリケーションを構築できます。

### 活用シーン <a href="#use-cases" id="use-cases"></a>

* **公開データプラットフォームとの連携**：たとえば政府のオープンデータ（農業、気象、交通、財政）と連携し、AI アシスタントが最新の公開データをリアルタイムで取得できるようにします。
* **社内システムの照会**：ERP、CRM、HR、チケットシステムなどの社内 API と連携し、AI アシスタントが従業員や顧客の属性に応じてパーソナライズされた情報を提供できるようにします。
* **サードパーティ SaaS との統合**：Slack、Notion、Google Drive、Salesforce などのサービスと連携し、AI アシスタントを既存のワークフローに組み込みます。
* **動的な照会とレポート**：データ量が多い、または変動が頻繁でナレッジベースに格納するのが適さない場合は、API によるリアルタイム照会で回答する方式に切り替えられます。

### 連携フロー <a href="#integration-workflow" id="integration-workflow"></a>

1. **データソースの取得**：連携したい API または MCP サービスを確認し、エンドポイント、HTTP メソッド、ヘッダー、パラメータ構造を準備します。
2. **ツールの作成**：MaiAgent プラットフォームの <mark style="color:blue;">ツール</mark> ページで <mark style="color:blue;">API ツールを新規追加</mark> または <mark style="color:blue;">MCP ツールを新規追加</mark> をクリックします。API ツールを新規追加する際は cURL コマンドをそのまま貼り付けることができ、システムが URL、ヘッダー、HTTP メソッドを自動的に解析します。
3. **AI アシスタントの設定**：ツールを AI アシスタントの利用可能なツール一覧に追加し、ロール指示を通じて適切なタイミングでツールを呼び出すよう AI アシスタントを誘導します。
4. **テストと公開**：対話を通じてツール呼び出しのフローをテストし、AgentOps 配下の <mark style="color:blue;">ツール実行履歴</mark> で実行状況やエラーメッセージを確認します。回答が正しいことを確認できたら、公開して利用を開始できます。

### 活用例 <a href="#examples" id="examples"></a>

* [農業データの照会](/maiagent-user-guide/ja/build/integrate/farmingsearch.md)：農業部の公開 API と連携し、農産物の取引相場をリアルタイムで照会できるアシスタントを構築します。

以降の各セクションでは、実際のケースを通じて外部データ連携の手順を示し、ご自身の業務シーンへ素早く応用していただけるようサポートします。


---

# 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/build/integrate.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.