---
title: "Agregar material de entrenamiento"
url: https://docs.catalyst.zoho.com/es/api/code-reference/convokraft/add-training-material/
description: "Esta API se usa para agregar URLs de entrenamiento a la función SmartTrain en ConvoKraft."
last_updated: 2026-03-20T16:21:56Z
service: ConvoKraft
type: api
---

# Agregar material de entrenamiento

Esta API te permite cargar materiales de entrenamiento personalizados a SmartTrain, permitiendo que el bot de ConvoKraft se entrene automáticamente. Puedes proporcionar URLs web de los materiales de entrenamiento alojados en cualquier plataforma de terceros en formato HTML o TXT. Una vez cargados, el bot procesa el contenido y lo usa para responder a consultas relevantes.

Puedes introducir esta funcionalidad en tu aplicación de Catalyst usando la API a continuación.

### Detalles de la solicitud

#### URL de solicitud

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

- **api-domain** (URL): El dominio específico del DC para acceder a Catalyst API

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto en el que se ha creado el bot

- **botid** (Numerical): El ID único del bot de ConvoKraft 

> **Nota:** 

1. El parámetro de consulta `type=DEVELOPED` se usa para indicar que el bot está en estado de desarrollo dentro del servicio ConvoKraft.

2. Puedes obtener el `botid` directamente desde la URL en el servicio ConvoKraft cuando el entorno está configurado en Development en la consola. 

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

Aquí, **3828281991118** es el `botid`.

#### Scope

ZIAPlatform.Convokraft.RAG.CREATE

#### Encabezados de solicitud

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

**Content-Type:** application/json 

**CATALYST-ORG:** {org_id} 

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

**X-CATALYST-Environment:** Development 

> **Nota:** El encabezado de solicitud `CATALYST-Environment: Development` indica que la operación de la API debe realizarse en el bot dentro del [entorno de desarrollo de Catalyst](https://docs.catalyst.zoho.com/es/deployment-and-billing/environments/development-environment/).

#### Propiedades JSON de la solicitud

- **rag_training_data** (String, mandatory): Proporciona la URL completa del material de entrenamiento apuntando a **.html** o **.txt**. 

- **title** (String, optional): Proporciona el título del material de entrenamiento. 

### Detalles de la respuesta

Esta API proporciona el estado del proceso de carga del material de entrenamiento, incluyendo el código de estado y el mensaje. También devuelve las URLs de los materiales cargados junto con un ID único asignado por ConvoKraft para cada URL.

**Sample Request**

```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"
        }
    ]
}'

```

**Sample Response**

```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/"
            },
        ]
    }
}
```