Gerenciamento de Datasets
Criar Dataset
Gerenciamento de Datasets
Criar Dataset
Endpoint para criar um novo dataset.
Este endpoint permite criar um novo dataset e opcionalmente vinculá-lo a avatares específicos.
Endpoint
POST /api/externalAPIs/public/tolkyReasoning/createDatasetsHelper
Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
hostId | string (UUID) | UUID do host (obrigatório) |
datasetName | string | Nome do dataset (obrigatório) |
datasetType | string | Tipo do dataset (enum: common_rag, filtered_rag) |
avatarIds | array de string (UUID) | Lista de UUIDs dos avatares para vincular ao dataset |
Exemplo de Requisição
curl -X POST \
'{BASE_URL}/api/externalAPIs/public/tolkyReasoning/createDatasetsHelper' \
-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"]
}'
Exemplo de 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"
}
}
Funcionamento
A rota createDatasetsHelper cria um novo dataset com as informações fornecidas. Se a lista avatarIds for fornecida, o dataset será automaticamente vinculado aos avatares especificados.
Os tipos de dataset disponíveis são:
common_rag: Dataset de RAG comumfiltered_rag: Dataset de RAG filtrado
A requisição tem um timeout de 60 segundos para garantir uma resposta em tempo hábil.
Códigos de Erro
400: Campos obrigatórios ausentes ou inválidos403: Credenciais inválidas ou sem permissão de acesso408: A requisição excedeu o limite de tempo de 60 segundos500: Erro interno do servidor ao processar a requisição