Crear una fuente de conocimiento e indexarla

POST

/knowledge/sources

const url = 'https://api.matiasimpulso.com/knowledge/sources';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"type":"document","name":"example","agentId":1,"text":"example","faqs":[{"question":"¿Cuánto dura la garantía?","answer":"La garantía cubre doce meses desde la compra.","productKey":"example"}],"url":"https://example.com","productKey":"example","chunkSize":800,"chunkOverlap":120}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.matiasimpulso.com/knowledge/sources \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "type": "document", "name": "example", "agentId": 1, "text": "example", "faqs": [ { "question": "¿Cuánto dura la garantía?", "answer": "La garantía cubre doce meses desde la compra.", "productKey": "example" } ], "url": "https://example.com", "productKey": "example", "chunkSize": 800, "chunkOverlap": 120 }'

Tipos: document (campo text), faq (lista de pares), url (se descarga y extrae el texto). Sin agentId el conocimiento lo comparte toda la empresa; con agentId queda privado de ese agente.

Authorizations

bearer

Request Body^required

application/json

object

type

required

string

Allowed values: document faq url catalog

name

required

Nombre visible de la fuente

string

<= 255 characters

agentId

Agente dueño. Si se indica, el conocimiento es privado de ese agente; si no, lo comparte toda la empresa.

number

>= 1

text

Texto a indexar. Obligatorio para el tipo document sin archivo.

string

<= 500000 characters

faqs

Pares pregunta y respuesta, para el tipo faq

Array<object>

<= 200 items

object

question

required

string

<= 500 characters

Example

¿Cuánto dura la garantía?

answer

required

string

<= 5000 characters

Example

La garantía cubre doce meses desde la compra.

productKey

Producto al que aplica

string

<= 120 characters

url

Dirección a descargar, para el tipo url

string format: uri

<= 2000 characters

productKey

Producto al que aplica todo el contenido

string

<= 120 characters

chunkSize

Caracteres por fragmento

number

default: 800 >= 100 <= 4000

chunkOverlap

Caracteres de solapamiento

number

default: 120 <= 1000

Responses

201

Fuente creada e indexada

400

Contenido ausente o dirección no admitida

402

Límite de fuentes o de tamaño del plan alcanzado

Crear una fuente de conocimiento e indexarla

Authorizations

Request Bodyrequired

Example

Example

Responses

201

400

402

Request Body^required