> 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/endpoint-behaviors/workflow-reply-mode-retirement.md).

# 組み込みワークフロー回答モードの廃止

組み込みワークフローの応答モード廃止に伴い、Agent API 連携で変更が必要なフィールドとエンドポイントについて説明します。

{% hint style="warning" %}
**互換性に関する変更**：このページでは、既存の連携が動作しなくなる API の変更と対応方法を説明します。`replyMode` などのフィールドの現在の定義については、API ドキュメントの[新しい AI アシスタントの作成](https://docs.maiagent.ai/api/api-reference/ai-zhu-li#chatbots-create)と[AI アシスタントの更新](https://docs.maiagent.ai/api/api-reference/ai-zhu-li#chatbots-update)を参照してください。
{% endhint %}

連携プログラムで組み込みワークフローを使用して Agent を作成していた場合は、Agent の作成・更新リクエストを確認してください。現在の API では組み込みワークフローの一覧を提供していません。ワークフローの応答モードは無効になっており、組み込みワークフローのフィールドも Agent の設定を制御しません。

## 連携側で必要な変更 <a href="#integration-changes" id="integration-changes"></a>

1. `GET /api/built-in-workflows/` の呼び出しを停止してください。このルートは削除されています。
2. Agent の作成・更新時に `replyMode: "workflow"` を送信しないでください。この値は拒否されます。`replyMode` に定義されているモードは `normal`、`template`、`hybrid`、`agent` ですが、実際に利用できるモードは引き続きプランによって制限されます。Agent の作成時にこのフィールドを省略すると、デフォルトは `normal` になります。更新時に省略すると、既存のモードが維持されます。
3. リクエストから `builtInWorkflow` を削除し、レスポンス内のこのフィールドへの依存もやめてください。Agent の更新時にこのフィールドを送信しても、API は無視し、Agent の設定は変更しません。

{% hint style="info" %}
この廃止の対象は、MaiAgent の組み込みワークフローの応答モードのみです。外部の自動化サービスで複数の Agent を連携する方法については、[外部サービス連携](/tech/ja/api-integration/n8n.md)を参照してください。
{% 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/tech/ja/api-integration/endpoint-behaviors/workflow-reply-mode-retirement.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.