> ## Documentation Index
> Fetch the complete documentation index at: https://docs.suasofia.online/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar base de conhecimento

> Criar uma nova base de conhecimento

Este endpoint cria uma nova base de conhecimento. Após a criação, você pode adicionar documentos a ela usando o endpoint [create document](/api-reference/knowledgebases/create-document).

### Corpo da Requisição

<ParamField body="name" type="string" required>
  O nome da base de conhecimento (máx. 255 caracteres)
</ParamField>

<ParamField body="description" type="string">
  Descrição opcional da base de conhecimento (máx. 255 caracteres)
</ParamField>

### Resposta

<ResponseField name="message" type="string">
  Mensagem de sucesso
</ResponseField>

<ResponseField name="data" type="object">
  O objeto da base de conhecimento criada

  <Expandable title="data properties">
    <ResponseField name="id" type="integer">
      O identificador único da base de conhecimento
    </ResponseField>

    <ResponseField name="name" type="string">
      O nome da base de conhecimento
    </ResponseField>

    <ResponseField name="description" type="string">
      Descrição da base de conhecimento
    </ResponseField>

    <ResponseField name="status" type="string">
      Status atual (será `empty` para novas bases de conhecimento)
    </ResponseField>

    <ResponseField name="status_label" type="string">
      Rótulo de status legível para humanos
    </ResponseField>

    <ResponseField name="created_at" type="string">
      Timestamp ISO 8601 da criação
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      Timestamp ISO 8601 da última atualização
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json 201 Created theme={null}
  {
    "message": "Base de conhecimento criada com sucesso.",
    "data": {
      "id": 1,
      "name": "Documentação do Produto",
      "description": "Documentação técnica para nossos produtos",
      "status": "empty",
      "status_label": "Vazia",
      "created_at": "2025-01-08T10:30:00.000000Z",
      "updated_at": "2025-01-08T10:30:00.000000Z"
    }
  }
  ```

  ```json 422 Validation Error theme={null}
  {
    "message": "O campo nome é obrigatório.",
    "errors": {
      "name": [
        "O campo nome é obrigatório."
      ]
    }
  }
  ```

  ```json 500 Error theme={null}
  {
    "error": "Falha ao criar base de conhecimento. Tente novamente."
  }
  ```
</ResponseExample>

### Próximos Passos

Após criar uma base de conhecimento, você vai querer:

1. **Adicionar documentos** - Use o endpoint [create document](/api-reference/knowledgebases/create-document) para adicionar conteúdo
2. **Aguardar o processamento** - Documentos são processados de forma assíncrona
3. **Anexar ao assistente** - Use o endpoint [update assistant](/api-reference/assistants/update-assistant) para anexar a base de conhecimento