---
title: "PUT /v2/agent/{agentId}/settings"
method: PUT
path: "/v2/agent/{agentId}/settings"
---

# PUT /v2/agent/{agentId}/settings

`PUT /v2/agent/{agentId}/settings`

Atualiza as configurações de um agente existente

## Path parameters

- `agentId` string, required

## Request body

- object
  - `prefferModel` 'GPT_5' | 'GPT_5_MINI' | 'GPT_5_1' | 'GPT_5_2' | 'GPT_5_MINI_V2' | 'GPT_4_TURBO' | 'OPEN_AI_04' | 'OPEN_AI_03_MINI_BETA' | 'GPT_4_1' | 'GPT_4_1_MINI' | 'GPT_4_O_MINI' | 'GPT_4_O' | 'OPEN_AI_O3_MINI' | 'OPEN_AI_O4_MINI' | 'OPEN_AI_O3' | 'OPEN_AI_O1' | 'GPT_4' | 'CLAUDE_4_5_SONNET' | 'CLAUDE_3_5_SONNET' | 'CLAUDE_3_7_SONNET' | 'CLAUDE_3_5_HAIKU' | 'DEEPINFRA_LLAMA3_3' | 'QWEN_2_5_MAX' | 'DEEPSEEK_CHAT' | 'SABIA_3' | 'SABIA_3_1' — Modelo de LLM preferido
  - `timezone` string — Timezone do agente
  - `enabledHumanTransfer` boolean — Define se o agente pode transferir para humano
  - `enabledReminder` boolean — Define se pode agendar lembretes
  - `splitMessages` boolean — Define se a mensagem será dividida em várias, caso seja muito grande
  - `enabledEmoji` boolean — Define se pode usar emojis nas respostas
  - `limitSubjects` boolean — Define se pode falar de outros assuntos ou apenas relacionado à empresa ou produto
  - `messageGroupingTime` 'NO_GROUP' | 'FIVE_SEC' | 'TEN_SEC' | 'THIRD_SEC' | 'ONE_MINUTE' — Modelo de LLM preferido
  - `signMessages` boolean — Define se a mensagem do agente vai ser assinada ou não
  - `maxDailyMessages` integer — É o limite de interações por atendimento aonde temos as opções (null) que representa sem limite, (20,50,100,200,500,1000) interações qualquer valor além desses não será aceito
  - `maxDailyMessagesLimitAction` 'TEMP_BLOCK_30S' | 'TEMP_BLOCK_5M' | 'TEMP_BLOCK_10M' | 'TEMP_BLOCK_30M' | 'TEMP_BLOCK_1H' | 'BLOCK' | 'TRANSFER' — Vai ser usado apenas quando maxDailyMessages for diferente de null
  - `knowledgeByFunction` boolean — É reponsável por ativar a busca inteligênte do treinamento aonde o agente consulta a base de treinamentos no momento certo, para trazer respostas mais precisas
  - `onLackKnowLedge` string — Na falta de conhecimento o agente lança um weebhook

## Response `200`

Configurações atualizadas com sucesso

- object
  - `success` boolean

## Other responses

- `400` — Erro inesperado
- `403` — Erro de token

---

[API](https://skmtc.net/gptmaker/apis/openapi-gpt-maker.md) · [All operations](https://skmtc.net/gptmaker/apis/openapi-gpt-maker/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gptmaker/openapi-gpt-maker/revisions/bda09b3eba6e/schema)