Datasets
Criar Dataset
Cria um novo dataset e opcionalmente vincula a avatares
Você pode testar esta rota diretamente em nossa documentação interativa.
Cria um novo dataset. Se enviar avatarIds, o dataset já é vinculado aos avatares indicados.
Endpoint
POST /api/externalAPIs/public/tolkyReasoning/datasets/create
Parâmetros
hostId
string
requiredUUID do host.
datasetName
string
requiredNome do dataset.
datasetType
string
requiredTipo do dataset: common_rag (RAG comum) ou filtered_rag (RAG filtrado).
avatarIds
array
Lista opcional de UUIDs dos avatares a vincular ao dataset.
Exemplo
curl -X POST {{BASE_URL}}/api/externalAPIs/public/tolkyReasoning/datasets/create \
-H "Authorization: Bearer {TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"hostId": "uuid-do-host",
"datasetName": "Meu Dataset",
"datasetType": "common_rag",
"avatarIds": ["uuid-do-avatar-1", "uuid-do-avatar-2"]
}'
Resposta
{
"code": 200,
"message": "Success",
"data": {
"id": "uuid-do-dataset",
"dataset_name": "Meu Dataset",
"dataset_type": "common_rag",
"created_at": "2025-05-12T01:39:34.904317+00:00",
"updated_at": "2025-05-12T01:39:34.904317+00:00",
"visible": true,
"deleted": false,
"expires": "2026-05-12T01:39:34.904317+00:00"
}
}
Campos da Resposta
data
object
Erros
| Código | Descrição |
|---|---|
400 | Campos obrigatórios ausentes ou inválidos |
403 | Credenciais inválidas ou sem permissão de acesso |
408 | Requisição excedeu o limite de 60 segundos |
500 | Erro interno do servidor |