---
title: "学習素材の追加"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/convokraft/add-training-material/
description: "このAPIは、ConvoKraftのSmartTrain機能に学習用URLを追加するために使用されます。"
last_updated: 2026-02-23T12:39:41Z
service: ConvoKraft
type: api
---

# 学習素材の追加

このAPIを使用すると、SmartTrainにカスタム学習素材をアップロードし、ConvoKraftボットを自動的にトレーニングさせることができます。HTMLまたはTXT形式でサードパーティプラットフォームにホストされている学習素材のWebURLを提供できます。アップロードされると、ボットはコンテンツを処理し、関連するクエリへの応答に使用します。

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

### リクエスト詳細

#### リクエストURL

`POST` {api-domain}/convokraft/api/v1/bots/{botid}/rag_training_data?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.CREATE

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

 **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プロパティ

- **rag_training_data** (String, mandatory): **.html**または**.txt**を指す学習素材の完全なURLを指定します。 

- **title** (String, optional): 学習素材のタイトルを指定します。 

### レスポンス詳細

このAPIは、ステータスコードとメッセージを含む学習素材のアップロードプロセスのステータスを提供します。また、アップロードされた素材のURLと、ConvoKraftが各URLに割り当てた一意のIDも返します。

**リクエスト例**

```bash
curl -X POST  \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/convokraft/api/v1/bots/92738220219110/rag_training_data?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 '{
    "rag_training_data": [
        {
            "url": "https://www.apple.com/iphone-15",
            "title": "Iphone 15 Specifications"
        },
        {
            "url": "https://www.apple.com/iphone-11/",
            "title": "Iphone 11 Specifications"
        }
    ]
}'

```

**レスポンス例**

```json

    {
    "status": "SUCCESS",
    "code": "SUCCESS",
    "message": "File upload in progress",
    "info": {
        "files": [
            {
                "id": "2000000028005",
                "url": "https://www.apple.com/iphone-15/"
            },
            {
                "id": "2000000028007",
                "url": "https://www.apple.com/iphone-11/"
            },
        ]
    }
}
```