Atualizar Multi-Agente

Endpoint para atualizar um Multi-Agente

PUT /api/v1/bot/update-multi/{id}

Atualizar Multi-Agente

cURL

curl --request PUT \
  --url https://chat.api.toolzz.com.br/api/v1/bot/update-multi/{id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "agentIds": [
    "<string>"
  ]
}
'

200

{
  "id": "<string>",
  "name": "<string>",
  "prompt": "<string>",
  "metaprompt": "<string>",
  "description": "<string>",
  "assistantId": "<string>",
  "tags": [
    "<string>"
  ],
  "unityId": "<string>",
  "progressStatus": "<string>",
  "safeMode": true,
  "institutionId": "<string>",
  "isActivated": true,
  "botMonetization": {},
  "hasMonetization": true,
  "hasAnalytics": true,
  "hasMulti": true,
  "isAdvancedBot": true,
  "hasTools": true,
  "hasVoice": true,
  "hasPlugins": true,
  "hasWhatsapp": true,
  "hasInstagram": true,
  "hasMessenger": true,
  "botMultiAgents": [
    {}
  ],
  "favorites": [
    "<any>"
  ],
  "botFallBack": [
    "<any>"
  ]
}

Descrição dos Parâmetros

Authorization · string

Token de acesso (“Bearer” deve estar antes do token)

id · string

ID do agente

prompt · string

Prompt de como chamar o agente (Ex: Quando falar sobre finanças chame o @FinaceiroAI).

agentIds · uuid[]

ID dos agentes relacionados.

Descrição da Resposta

Abaixo você verá a descrição da resposta do agente utilizando multi-agentes

id · string · required

ID único do bot.

name · string · required

Nome atribuído ao bot.

prompt · string · required

Texto descritivo que define o comportamento, personalidade e funcionalidades do bot.

metaprompt · string

Configurações adicionais e instruções de customização para comportamento do agente.

description · string · required

Descrição breve da finalidade ou propósito do bot.

assistantId · string

ID do assistente vinculado (pode ser nulo).

tags · string[]

Lista de tags associadas ao bot.

unityId · string · required

ID da unidade organizacional à qual o bot pertence.

progressStatus · string

Status atual do progresso do bot (exemplo: “FINISHED”).

safeMode · boolean

Indica se o modo seguro está ativado.

institutionId · string · required

ID da instituição responsável pelo bot.

isActivated · boolean · required

Indica se o bot está ativo.

botMonetization · object

Objeto com informações sobre monetização do bot.

hasMonetization · boolean

Indica se o bot possui monetização habilitada.

hasAnalytics · boolean

Indica se o bot possui recursos analíticos habilitados.

hasMulti · boolean

Indica se o bot suporta múltiplos agentes.

isAdvancedBot · boolean

Indica se o bot é classificado como avançado.

hasTools · boolean

Indica se o bot possui ferramentas integradas.

hasVoice · boolean

Indica se o bot tem suporte a voz.

hasPlugins · boolean

Indica se o bot possui plugins integrados.

hasWhatsapp · boolean

Indica se o bot possui integração com WhatsApp.

hasInstagram · boolean

Indica se o bot possui integração com Instagram.

hasMessenger · boolean

Indica se o bot possui integração com Messenger.

botMultiAgents · object[] · required

Lista de agentes vinculados ao bot, com seus respectivos prompts e metadados.

favorites · any[]

Lista de favoritos associados ao bot.

botFallBack · any[]

Configurações de fallback do bot.

Segurança

Para acessar este endpoint, é necessário enviar um token de acesso válido através do cabeçalho de autorização (Authorization) da requisição. Além disso, a API é protegida por outras medidas de segurança para proteger os dados dos usuários.