Datastores
Buscar en datastore
Realizar búsquedas semánticas en tu base de conocimiento.
POST
/
api
/
datastores
/
{datastoreId}
/
query
curl -X POST https://app.horneross.com/api/datastores/ds_abc123/query \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"query": "política de devoluciones",
"topK": 3
}'
const response = await fetch(
'https://app.horneross.com/api/datastores/ds_abc123/query',
{
method: 'POST',
headers: {
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
query: 'política de devoluciones',
topK: 3,
}),
}
);
const results = await response.json();
import requests
response = requests.post(
'https://app.horneross.com/api/datastores/ds_abc123/query',
headers={
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json',
},
json={
'query': 'política de devoluciones',
'topK': 3
}
)
results = response.json()
[
{
"text": "Podés devolver tu producto dentro de los 30 días desde la compra. El producto debe estar sin uso y en su empaque original.",
"score": 0.95,
"source": "https://ejemplo.com/politicas",
"datasource_name": "Políticas de la empresa",
"datasource_id": "datasource_xyz",
"custom_id": "politica_devoluciones",
"offset": 0
}
]
{
"error": {
"code": "NOT_FOUND",
"message": "Datastore no encontrado"
}
}
Endpoint
POST /api/datastores/{datastoreId}/query
Path Parameters
string
required
ID único del datastore donde realizar la búsqueda.
Headers
string
required
Bearer token con tu API key o API key del datastore.
string
required
Siempre
application/jsonRequest Body
string
required
Texto de búsqueda. El sistema encuentra documentos semánticamente similares.
number
default:"5"
Cantidad de resultados a retornar. Máximo 20.
object
curl -X POST https://app.horneross.com/api/datastores/ds_abc123/query \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"query": "política de devoluciones",
"topK": 3
}'
const response = await fetch(
'https://app.horneross.com/api/datastores/ds_abc123/query',
{
method: 'POST',
headers: {
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
query: 'política de devoluciones',
topK: 3,
}),
}
);
const results = await response.json();
import requests
response = requests.post(
'https://app.horneross.com/api/datastores/ds_abc123/query',
headers={
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json',
},
json={
'query': 'política de devoluciones',
'topK': 3
}
)
results = response.json()
Response
array
required
Array de documentos encontrados ordenados por relevancia.
Show Propiedades de cada resultado
Show Propiedades de cada resultado
string
required
Contenido del fragmento de texto encontrado
number
required
Score de similitud (0-1). Mayor es más relevante.
string
URL o nombre de la fuente original
string
Nombre del datasource de origen
string
ID del datasource de origen
string
ID personalizado si fue asignado
number
Offset del chunk dentro del documento
[
{
"text": "Podés devolver tu producto dentro de los 30 días desde la compra. El producto debe estar sin uso y en su empaque original.",
"score": 0.95,
"source": "https://ejemplo.com/politicas",
"datasource_name": "Políticas de la empresa",
"datasource_id": "datasource_xyz",
"custom_id": "politica_devoluciones",
"offset": 0
}
]
{
"error": {
"code": "NOT_FOUND",
"message": "Datastore no encontrado"
}
}
Was this page helpful?
⌘I
curl -X POST https://app.horneross.com/api/datastores/ds_abc123/query \
-H "Authorization: Bearer sk_live_xxx" \
-H "Content-Type: application/json" \
-d '{
"query": "política de devoluciones",
"topK": 3
}'
const response = await fetch(
'https://app.horneross.com/api/datastores/ds_abc123/query',
{
method: 'POST',
headers: {
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json',
},
body: JSON.stringify({
query: 'política de devoluciones',
topK: 3,
}),
}
);
const results = await response.json();
import requests
response = requests.post(
'https://app.horneross.com/api/datastores/ds_abc123/query',
headers={
'Authorization': 'Bearer sk_live_xxx',
'Content-Type': 'application/json',
},
json={
'query': 'política de devoluciones',
'topK': 3
}
)
results = response.json()
[
{
"text": "Podés devolver tu producto dentro de los 30 días desde la compra. El producto debe estar sin uso y en su empaque original.",
"score": 0.95,
"source": "https://ejemplo.com/politicas",
"datasource_name": "Políticas de la empresa",
"datasource_id": "datasource_xyz",
"custom_id": "politica_devoluciones",
"offset": 0
}
]
{
"error": {
"code": "NOT_FOUND",
"message": "Datastore no encontrado"
}
}