> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Crear base de conocimiento

> Crea una nueva base de conocimiento en Famulor a través de la API para dotar a tus asistentes de voz con IA de información de la empresa, preguntas frecuentes, detalles de productos y documentos de referencia.

<Warning>
  **API de Famulor 1.0 (legado).** Esta página se aplica únicamente a Famulor 1.0 (`app.famulor.de`) y se conserva por compatibilidad. Para la plataforma actual, usa la [referencia de la API de Famulor 2.0](/es/api-reference/introduction).
</Warning>

Este endpoint crea una nueva base de conocimiento. Después de crearla, puedes añadir documentos usando el endpoint [Crear documento](/es/api-v1/knowledgebases/create-document).

### Cuerpo de la solicitud

<ParamField body="name" type="string" required>
  El nombre de la base de conocimiento (máx. 255 caracteres)
</ParamField>

<ParamField body="description" type="string">
  Descripción opcional de la base de conocimiento (máx. 255 caracteres)
</ParamField>

### Campos de respuesta

<ResponseField name="message" type="string">
  Mensaje de éxito
</ResponseField>

<ResponseField name="data" type="object">
  El objeto de base de conocimiento creado

  <Expandable title="Propiedades de los datos">
    <ResponseField name="id" type="integer">
      El identificador único de la base de conocimiento
    </ResponseField>

    <ResponseField name="name" type="string">
      El nombre de la base de conocimiento
    </ResponseField>

    <ResponseField name="description" type="string">
      Descripción de la base de conocimiento
    </ResponseField>

    <ResponseField name="status" type="string">
      Estado actual (será `empty` para bases de conocimiento nuevas)
    </ResponseField>

    <ResponseField name="status_label" type="string">
      Etiqueta de estado legible por humanos
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Marca de tiempo ISO 8601 de creación
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Marca de tiempo ISO 8601 de la última actualización
    </ResponseField>
  </Expandable>
</ResponseField>

### Próximos pasos

Después de crear una base de conocimiento, deberías:

1. **Añadir documentos** - Usa el endpoint [Crear documento](/es/api-v1/knowledgebases/create-document) para añadir contenido
2. **Esperar el procesamiento** - Los documentos se procesan de forma asíncrona
3. **Adjuntarla a asistentes** - Usa el endpoint [Actualizar asistente](/es/api-v1/assistants/update) para adjuntar la base de conocimiento

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "message": "Knowledgebase created successfully.",
    "data": {
      "id": 1,
      "name": "Product Documentation",
      "description": "Technical documentation for our products",
      "status": "empty",
      "status_label": "Empty",
      "created_at": "2025-01-08T10:30:00.000000Z",
      "updated_at": "2025-01-08T10:30:00.000000Z"
    }
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "message": "The name field is required.",
    "errors": {
      "name": [
        "The name field is required."
      ]
    }
  }
  ```

  ```json 500 Error theme={null}
  {
    "error": "Failed to create knowledgebase. Please try again."
  }
  ```
</ResponseExample>
