---
title: "Conclusões"
method: POST
path: "/completions"
tags: ["Completions"]
---

# Conclusões

`POST /completions`

Gera uma resposta baseada no modelo de linguagem treinado.

## Request body

- object — Parâmetros para criação de uma conclusão com o modelo de IA
  - `model` 'gpt-3.5-turbo' | 'gpt-4o' | 'gpt-4o-mini' — Modelos de linguagem disponíveis para gerar respostas
  - `system` string — Prompt para guiar o comportamento do modelo
  - `messages` union[] — Histórico completo de mensagens trocadas nesta conversa, ordenadas cronologicamente. Cada item da lista é uma mensagem que pode ter um dos seguintes papéis (`role`): `system`, `user`, `assistant` ou `tool`.
    - union — Mensagem da conversa
      - object — Mensagem gerada pelo modelo, que pode incluir chamadas de ferramentas
        - `role` 'assistant', required — Mensagem de assistente (IA)
        - `content` string, nullable, required — Conteúdo da mensagem
        - `toolCall` object — Chamada de ferramenta feita pelo assistente
          - `id` string, required — ID da chamada da ferramenta
          - `name` string, required — Nome da ferramenta
          - `arguments` string, required — Argumentos enviados para a ferramenta, serializados em formato JSON
      - object — Mensagem enviada pelo usuário
        - `role` 'user', required — Mensagem de usuário
        - `content` string, required — Conteúdo da mensagem
      - object — Mensagem contendo a resposta de uma ferramenta
        - `role` 'tool', required — Mensagem de retorno de uma ferramenta
        - `content` string, required — Resultado retornado pela ferramenta
        - `id` string, required — Identificador único da chamada de ferramenta
      - object — Mensagem de sistema, geralmente utilizada para configurar o comportamento do modelo (prompt)
        - `role` 'system', required — Mensagem de sistema
        - `content` string, required — Conteúdo da mensagem
  - `frequencyPenalty` number — Penalidade para frequência de palavras repetidas
  - `logitBias` object — Ajuste de probabilidade para determinados tokens
  - `maxTokens` integer — Número máximo de tokens na resposta
  - `n` integer — Quantas opções de conclusão de bate-papo gerar para cada mensagem de entrada.
  - `presencePenalty` number — Penalidade para incentivar o uso de novas palavras
  - `responseFormat` union — Formato desejado da resposta (ex: markdown, plain)
    - object — Objeto JSON
      - `type` 'json_object', required — Objeto JSON
    - object — Schema JSON
      - `type` 'json_schema', required — Schema JSON
      - `schema` object, required — Schema utilizado pelo modelo ao gerar a conclusão
        - `name` string, required — Nome da ferramenta, usado pelo modelo para invocar
        - `description` string — Descrição breve da função da ferramenta
        - `parameters` object, required — Parâmetros esperados pela ferramenta, em formato JSON Schema
        - `strict` boolean — Se true, só permite os parâmetros definidos no schema
    - object — Texto plano
      - `type` 'text', required — Texto plano
  - `stop` string[] — Sequências de parada para interrupção da geração
  - `temperature` number — Controle de aleatoriedade na geração de texto
  - `topP` number — Amostragem baseada em núcleo (nucleus sampling)
  - `toolChoice` union — Escolha específica de ferramenta a ser usada pela IA
    - object
      - `name` string, required — Nome da ferramenta que deve ser usada na geração
    - 'auto' — O modelo escolha por conta própria se e qual ferramenta deve usar na geração
    - 'none' — O modelo não utiliza uma ferramenta na geração
  - `tools` object[] — Ferramentas disponíveis para o modelo utilizar
    - `name` string, required — Nome da ferramenta, usado pelo modelo para invocar
    - `description` string — Descrição breve da função da ferramenta
    - `parameters` object, required — Parâmetros esperados pela ferramenta, em formato JSON Schema
    - `strict` boolean — Se true, só permite os parâmetros definidos no schema
  - `kbs` union — Bases de conhecimento que podem ser usadas
    - boolean
    - string[]
  - `web` boolean — Indica se o modelo pode consultar a web durante a geração

## Response `200`

Successful response

- object
  - `completionId` string, required — Identificador do completion
  - `input` object, required — Parâmetros para criação de uma conclusão com o modelo de IA
    - `model` 'gpt-3.5-turbo' | 'gpt-4o' | 'gpt-4o-mini' — Modelos de linguagem disponíveis para gerar respostas
    - `system` string — Prompt para guiar o comportamento do modelo
    - `messages` union[] — Histórico completo de mensagens trocadas nesta conversa, ordenadas cronologicamente. Cada item da lista é uma mensagem que pode ter um dos seguintes papéis (`role`): `system`, `user`, `assistant` ou `tool`.
      - union — Mensagem da conversa
        - object — Mensagem gerada pelo modelo, que pode incluir chamadas de ferramentas
          - `role` 'assistant', required — Mensagem de assistente (IA)
          - `content` string, nullable, required — Conteúdo da mensagem
          - `toolCall` object — Chamada de ferramenta feita pelo assistente
            - `id` string, required — ID da chamada da ferramenta
            - `name` string, required — Nome da ferramenta
            - `arguments` string, required — Argumentos enviados para a ferramenta, serializados em formato JSON
        - object — Mensagem enviada pelo usuário
          - `role` 'user', required — Mensagem de usuário
          - `content` string, required — Conteúdo da mensagem
        - object — Mensagem contendo a resposta de uma ferramenta
          - `role` 'tool', required — Mensagem de retorno de uma ferramenta
          - `content` string, required — Resultado retornado pela ferramenta
          - `id` string, required — Identificador único da chamada de ferramenta
        - object — Mensagem de sistema, geralmente utilizada para configurar o comportamento do modelo (prompt)
          - `role` 'system', required — Mensagem de sistema
          - `content` string, required — Conteúdo da mensagem
    - `frequencyPenalty` number — Penalidade para frequência de palavras repetidas
    - `logitBias` object — Ajuste de probabilidade para determinados tokens
    - `maxTokens` integer — Número máximo de tokens na resposta
    - `n` integer — Quantas opções de conclusão de bate-papo gerar para cada mensagem de entrada.
    - `presencePenalty` number — Penalidade para incentivar o uso de novas palavras
    - `responseFormat` union — Formato desejado da resposta (ex: markdown, plain)
      - object — Objeto JSON
        - `type` 'json_object', required — Objeto JSON
      - object — Schema JSON
        - `type` 'json_schema', required — Schema JSON
        - `schema` object, required — Schema utilizado pelo modelo ao gerar a conclusão
          - `name` string, required — Nome da ferramenta, usado pelo modelo para invocar
          - `description` string — Descrição breve da função da ferramenta
          - `parameters` object, required — Parâmetros esperados pela ferramenta, em formato JSON Schema
          - `strict` boolean — Se true, só permite os parâmetros definidos no schema
      - object — Texto plano
        - `type` 'text', required — Texto plano
    - `stop` string[] — Sequências de parada para interrupção da geração
    - `temperature` number — Controle de aleatoriedade na geração de texto
    - `topP` number — Amostragem baseada em núcleo (nucleus sampling)
    - `toolChoice` union — Escolha específica de ferramenta a ser usada pela IA
      - object
        - `name` string, required — Nome da ferramenta que deve ser usada na geração
      - 'auto' — O modelo escolha por conta própria se e qual ferramenta deve usar na geração
      - 'none' — O modelo não utiliza uma ferramenta na geração
    - `tools` object[] — Ferramentas disponíveis para o modelo utilizar
      - `name` string, required — Nome da ferramenta, usado pelo modelo para invocar
      - `description` string — Descrição breve da função da ferramenta
      - `parameters` object, required — Parâmetros esperados pela ferramenta, em formato JSON Schema
      - `strict` boolean — Se true, só permite os parâmetros definidos no schema
    - `kbs` union — Bases de conhecimento que podem ser usadas
      - boolean
      - string[]
    - `web` boolean — Indica se o modelo pode consultar a web durante a geração
  - `output` union, required — Mensagem da conversa
    - object — Mensagem gerada pelo modelo, que pode incluir chamadas de ferramentas
      - `role` 'assistant', required — Mensagem de assistente (IA)
      - `content` string, nullable, required — Conteúdo da mensagem
      - `toolCall` object — Chamada de ferramenta feita pelo assistente
        - `id` string, required — ID da chamada da ferramenta
        - `name` string, required — Nome da ferramenta
        - `arguments` string, required — Argumentos enviados para a ferramenta, serializados em formato JSON
    - object — Mensagem enviada pelo usuário
      - `role` 'user', required — Mensagem de usuário
      - `content` string, required — Conteúdo da mensagem
    - object — Mensagem contendo a resposta de uma ferramenta
      - `role` 'tool', required — Mensagem de retorno de uma ferramenta
      - `content` string, required — Resultado retornado pela ferramenta
      - `id` string, required — Identificador único da chamada de ferramenta
    - object — Mensagem de sistema, geralmente utilizada para configurar o comportamento do modelo (prompt)
      - `role` 'system', required — Mensagem de sistema
      - `content` string, required — Conteúdo da mensagem
  - `userId` string, required — Identificador do usuário
  - `workspaceId` string, required — Identificador do workspace
  - `createdAt` number, required — Data de criação
  - `updatedAt` number, required — Data da última atualização

## Other responses

- `default` — Error response

---

[API](https://skmtc.dev/rdstationmentoria/apis/content.md) · [All operations](https://skmtc.dev/rdstationmentoria/apis/content/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rdstationmentoria/content/revisions/a049c559cdce/schema)