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
ID único del datastore donde realizar la búsqueda.
Headers
Bearer token con tu API key o API key del datastore.
Siempre
application/jsonRequest Body
Texto de búsqueda. El sistema encuentra documentos semánticamente similares.
Cantidad de resultados a retornar. Máximo 20.
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 de documentos encontrados ordenados por relevancia.
Show Propiedades de cada resultado
Show Propiedades de cada resultado
Contenido del fragmento de texto encontrado
Score de similitud (0-1). Mayor es más relevante.
URL o nombre de la fuente original
Nombre del datasource de origen
ID del datasource de origen
ID personalizado si fue asignado
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"
}
}