> 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/tech/ja/api-integration.md).

# API 連携

- [クイックスタート](https://docs.maiagent.ai/tech/ja/api-integration/quickstart.md)
- [AI アシスタント一覧](https://docs.maiagent.ai/tech/ja/api-integration/qu-de-ji-qi-ren-lie-biao-bing-dui-hua.md)
- [会話とメッセージ応答（ストリーミング／同期）](https://docs.maiagent.ai/tech/ja/api-integration/dui-hua-yu-xun-xi-hui-fu-chuan-liu-tong-bu.md): 会話と同期
- [会話とメッセージの作成](https://docs.maiagent.ai/tech/ja/api-integration/dui-hua-yu-xun-xi.md)
- [Webhook](https://docs.maiagent.ai/tech/ja/api-integration/webhook.md): 会話プラットフォームのWebhook：訪問者のメッセージとAI／有人担当者の返信をリアルタイムでシステムにプッシュし、MaiAgent標準形式、Genesys Cloud、カスタムJinja2テンプレートに対応します
- [サードパーティのカスタマーサポートシステム連携（有人対応への転送を含む）](https://docs.maiagent.ai/tech/ja/api-integration/customer-service-system-integration.md): カスタマーサポートシステムやチャットプラットフォームが API 経由で MaiAgent を AI エンジンとして組み込む方法：メッセージの送受信、AI が有人対応への転送を判定した際の有人オペレーターへの引き継ぎ、対応終了後の AI への復帰までのエンドツーエンド仕様
- [Presigned ファイルアップロードモード](https://docs.maiagent.ai/tech/ja/api-integration/api_knowledge.md): ファイル連携によるファイルアップロード
- [ナレッジベースの利用—作成と操作](https://docs.maiagent.ai/tech/ja/api-integration/shi-yong-zhi-shi-ku-jian-li-yu-hu-dong.md): 本ガイドでは、公開 REST API を使用してナレッジベース内のファイルを管理する方法と、統合アプリケーションの例について説明します。
- [Web Chat の埋め込みと SDK](https://docs.maiagent.ai/tech/ja/api-integration/web-chat-sdk.md): MaiAgent Web Chat を任意のウェブサイトに埋め込む：埋め込みコード、ウィンドウモード、ユーザー識別、完全な設定リファレンスと JavaScript SDK API
- [MaiGPT モードの埋め込み](https://docs.maiagent.ai/tech/ja/api-integration/web-chat-sdk/web-chat-maigpt-mode.md): ChatGPTライクなMaiGPTの完全な対話インターフェースをウェブサイトや製品に埋め込みます。指定コンテナとフローティング全画面の2つのレイアウトに対応しています
- [ページ Context の注入](https://docs.maiagent.ai/tech/ja/api-integration/web-chat-sdk/web-chat-context-data.md): embed SDK の auth.contextData を通じて、ページの context（商品 ID、チケット番号、ユーザー識別子など）を AI アシスタントの LLM System Prompt に注入します
- [API ツールエンジニアリングガイド](https://docs.maiagent.ai/tech/ja/api-integration/api-tool-engineering-guide.md): REST API を MaiAgent AI アシスタントのツールとして接続する方法：リクエストの組み立て方、認証の渡し方、タイムアウトとリトライ、モデルへのエラーの返し方、ログの確認方法。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/tech/ja/api-integration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.