---
title: "SmartTrainの有効化・無効化"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/convokraft/enable-or-disable-smarttrain/
description: "このAPIは、ConvoKraftのSmartTrain機能を有効化または無効化するために使用されます。"
last_updated: 2026-02-23T12:39:41Z
service: ConvoKraft
type: api
---

# Catalyst ConvoKraft

Catalyst ConvoKraftは、インテリジェントなチャットボットを構築してCatalystアプリケーションにデプロイできるAI搭載サービスです。これらのボットは自然言語理解（NLU）を活用してメッセージを解釈し、自然な会話形式の英語で応答します。アプリケーションの要件に基づいて、[独自のロジックを設定](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/bot-logic/catalyst-integration-functions/)したり、[簡単な質問と回答のペアを提供](https://docs.catalyst.zoho.com/ja/convokraft/help/actions/define-sample-sentences/)したり、[カスタムリソースでトレーニング](https://docs.catalyst.zoho.com/ja/convokraft/help/smarttrain)したりして、ボットをカスタマイズできます。

[SmartTrain](https://docs.catalyst.zoho.com/ja/convokraft/help/smarttrain)は、Catalyst ConvoKraftサービスのコンポーネントで、独自のリソースを使用してチャットボットをトレーニングできます。リソースがホストされているWebURLを設定することで、ボットがトレーニング済みコンテンツに関連するユーザーのクエリに迅速かつ正確に回答できるようになります。

Catalyst ConvoKraftサービスの詳細については、[こちらのヘルプドキュメント](https://docs.catalyst.zoho.com/ja/convokraft/)を参照してください。

# SmartTrainの有効化・無効化

このAPIは、Catalyst ConvoKraftサービスの**SmartTrain**を有効化または無効化します。有効化すると、ボットの応答を向上させるための学習素材を追加できます。無効化すると、ボットのトレーニング済み知識が一時的に停止され、トレーニングデータに基づくクエリに回答できなくなります。再度有効化すると、トレーニングが自動的に復元され、以前にアップロードされた素材を使用してボットが応答できるようになります。

以下のAPIを使用して、この機能をCatalystアプリケーションに導入できます。

### リクエスト詳細

#### リクエストURL

`PATCH` {api-domain}/convokraft/api/v1/bots/{botid}?
type=DEVELOPED

- **api-domain** (URL): Catalyst APIにアクセスするためのDC固有ドメイン

- **project_id** (Numerical): ボットが作成されたプロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

- **botid** (Numerical): ConvoKraftボットの一意のID

> **注意:** 

1. クエリパラメーター`type=DEVELOPED`は、ボットがConvoKraftサービス内で開発状態であることを示すために使用されます。

2. `botid`は、コンソールで環境がDevelopmentに設定されている場合、ConvoKraftサービスのURLから直接取得できます。

例: <span style="pointer-events: none;word-break: break-all;">https://console.catalyst.zoho.com/baas/v1/project/183272829220/Development#/convokraft/bots/3828281991118</span>

ここで、**3828281991118**が`botid`です。

#### スコープ

ZIAPlatform.Convokraft.RAG.UPDATE

#### リクエストヘッダー

 **Authorization:** Zoho-oauthtoken {oauth_token} 

**Content-Type:** application/json 

**CATALYST-ORG:** {org_id} 

**X-CATALYST-projectid:** {project id} 

**X-CATALYST-Environment:** Development 

> **注意:** リクエストヘッダー`CATALYST-Environment: Development`は、API操作が[Catalyst開発環境](https://docs.catalyst.zoho.com/ja/deployment-and-billing/environments/development-environment/)内のボットに対して実行されることを示します。

#### リクエストJSONプロパティ

- **is_rag_enabled** (boolean, mandatory): RAG機能を有効にするには`true`、無効にするには`false`を渡します。

 デフォルト: `true` 

### レスポンス詳細

レスポンスには、SmartTrainの有効化・無効化操作のステータスが、ステータスメッセージおよびステータスコードとともに返されます。

**リクエスト例**

```bash
curl -X PATCH  \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/convokraft/api/v1/bots/92738220219110?type=DEVELOPED \
-H 'Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57' \
-H 'Content-Type: application/json' \
-H 'CATALYST-ORG: 372822922' \
-H 'X-CATALYST-projectid: 2728172727718' \
-H 'X-CATALYST-Environment: "Development"' \
-\-data '{
    "bots": {
        "is_rag_enabled": true 
    }
}'

```

**レスポンス例**

```json

    {
    "status": "SUCCESS",
    "code": "SUCCESS",
    "message": "Updated Successfully."
    }
```