Este endpoint permite vincular um dataset existente a um avatar específico.

Endpoint

POST /api/externalAPIs/public/tolkyReasoning/linkDatasetAvatarHelper

Parâmetros

ParâmetroTipoDescrição
datasetIdstring (UUID)UUID do dataset a ser vinculado (obrigatório)
avatarIdstring (UUID)UUID do avatar ao qual o dataset será vinculado (obrigatório)

Exemplo de Requisição

curl -X POST \
  '{BASE_URL}/api/externalAPIs/public/tolkyReasoning/linkDatasetAvatarHelper' \
  -H 'Content-Type: application/json' \
  -d '{
    "datasetId": "uuid-do-dataset",
    "avatarId": "uuid-do-avatar"
  }'

Exemplo de Resposta

{
  "code": 200,
  "message": "Success",
  "data": {
    "id": "uuid-do-vinculo",
    "dataset_name": "Nome do Dataset",
    "avatar_id": "uuid-do-avatar",
    "avatar_name": "Nome do Avatar",
    "dataset_id": "uuid-do-dataset",
    "created_at": "2025-05-12T01:39:34.904317+00:00",
    "updated_at": "2025-05-12T01:39:34.904317+00:00",
    "visible": true,
    "deleted": false
  }
}

Funcionamento

A rota linkDatasetAvatarHelper estabelece uma vinculação entre um dataset existente e um avatar específico. Esta vinculação permite que o avatar utilize o conhecimento contido no dataset durante suas interações.

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álidos
  • 403: Credenciais inválidas ou sem permissão de acesso
  • 408: A requisição excedeu o limite de tempo de 60 segundos
  • 500: Erro interno do servidor ao processar a requisição