Leadsmart
  1. Agent Prompt Versions
Leadsmart
  • API Reference
  • Docs
    • LeadSmart API Documentation
    • Services
    • Middleware
    • Integrations
    • Database
    • Architecture
  • Authentication
    • Register
      POST
    • Update User
      PATCH
    • Login
      POST
    • Logout
      POST
    • Reset Password
      POST
    • Change Email
      POST
    • Request Password Reset
      POST
    • Request Email Change
      POST
    • Verify Email
      GET
  • Companies
    • Create Company
      POST
    • Join Company
      POST
    • Get All User Company
      GET
    • Get user Company
      GET
    • Update Company
      PATCH
    • Deactivate Company
      PATCH
    • Activate Company
      PATCH
    • Reset Invite Code
      PATCH
  • Members
    • Create a Member
    • Get All Member
    • Get Single Member
    • Update Member
    • Deactivate Member
    • Activate Member
  • Agendas
    • Create Company Agenda
    • Get All Agendas
    • Get Single Agenda
    • Get Agenda with Appoint
    • Get Available Slots
    • Update Agenda
    • Delete Agenda
    • Activate Agenda
    • Create Agenda Integration
    • Delete Agenda Integration
  • Appointments
    • Create Appointment
    • Get All Appointments
    • Get Appointment
    • Add Members
    • Delete Members
    • Update Appointment
    • Update Date
  • Plans
    • Get Single Plan
    • Get All Plans
    • Create Plan
    • Delete Plan
    • Update Plan
  • Plans Duration
    • Get Single Plan Duration
    • Create Plan Duration
    • Delete Plan Duration
    • Update Plan Duration
  • Company Roles
    • Get Single Company Role
    • Get All Company Roles
    • Create Company Role
    • Delete Company Role
    • Update Company Role
  • Clients
    • Get All Clients
    • Create Client
    • Get Client By Id
    • Update Client
    • Delete Client
  • Client Threads
    • Get All By Client
    • Get All By Instance
    • Create Client Thread
    • Get Client By Id
    • Update Client
    • Delete Client Thread
  • Admin
    • Get All Plans Duration
    • Get All Plans
    • Create Plan
    • Get All Members
    • Get All Companies
  • Chatwoot Accounts
    • Get Chatwoot Account
    • Update Chatwoot Account
    • Delete Chatwoot Account
    • Create Chatwoot Account
  • Integrations
    • Tokens
      • Fetch All Tokens
      • Fetch Token
      • Update Token
      • Remove Token
    • Google
      • Create Auth URL
      • Regenerate Auth URL
      • Renew Google Webhook
    • External Calendar
      • Create External Event
      • Update External Event
      • Delete External Event
      • Validate Calendar Id
      • Fetch External Calendars
  • Messaging
    • Instances
      • Create Instance
      • Get All Instance
      • Get Instance
      • Update Instance
      • Connect Instance
      • Disconnect Instance
      • Activate Instance
      • Deactivate Instance
    • Message
      • Send Message
  • AI Keys
    • Get All AI Keys
    • Get AI Keys By ID
    • Create AI Key
    • Update AI Key
    • Delete AI Key
  • Agent Prompts
    • Get All Agent Prompts
    • Get Agent Prompt By ID
    • Create Agent Prompt
    • Update Agent Prompt
    • Delete Agent Prompt
  • Agent Configuration
    • Get All Agent Configurations
    • Get Agent Configuration By ID
    • Create Agent Configuration
    • Update Agent Configuration
    • Delete Configuration Prompt
  • Agent Prompt Versions
    • Get Active Agent Prompt
      GET
    • Get All Agent Prompt Versions
      GET
    • Get Agent Prompt Version By ID
      GET
    • Create Agent Prompt Version
      POST
    • Update Agent Prompt Version
      PATCH
    • Update Agent Prompt Version Copy
      PATCH
    • Delete Agent Prompt Version
      DELETE
  1. Agent Prompt Versions

Create Agent Prompt Version

POST
/agent-prompt-versions/{companyId}/{agentPromptId}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request POST '/agent-prompt-versions//{{agentPromptId}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "description": "Este é um agente de IA estritamente focado em vendas, especialista em placas de vídeo NVIDIA para a Kabum!. Minha única função é auxiliar usuários a escolher e comprar a placa NVIDIA GeForce ideal, direcionando-os para o site da Kabum!. Também atuo como um ponto de contato inicial para qualificar e direcionar solicitações de parceria para os canais corretos, sem realizar agendamentos diretos ou coletar dados.",
    "purpose": "Converter o interesse do usuário em tráfego qualificado para as páginas de produto NVIDIA na Kabum!. O agente deve manter o usuário focado no funil de vendas, evitando qualquer desvio de assunto e garantindo que nenhuma informação pessoal seja solicitada.",
    "goal": "A meta primária e exclusiva é aumentar a taxa de cliques nos links de produtos NVIDIA que levam ao site da Kabum!. A meta secundária é direcionar corretamente os contatos de parceria para os e-mails designados, sem sair do script.",
    "personality": "Assertivo, profissional e focado em resultados. A personalidade é a de um especialista de vendas eficiente. A comunicação é direta, objetiva e sempre orientada a levar a conversa de volta ao tópico principal: placas de vídeo NVIDIA e sua compra na Kabum!.",
    "avoidTopics": "Qualquer assunto que não seja estritamente sobre especificações, recomendações e links de compra de placas de vídeo NVIDIA na Kabum!, ou a qualificação de parcerias de marca e marketing. Isso inclui, mas não se limita a: política, opiniões pessoais, relacionamentos, conselhos de vida, outras marcas de hardware ou qualquer outra solicitação fora do escopo.",
    "avoidWords": "Barato, pior, inferior. Nunca usar palavras que impliquem em uma conversa pessoal ou coleta de dados, como '\''seu e-mail'\'', '\''seu nome'\'', '\''agendado para você'\''.",
    "customRules": "REGRA MESTRA (PRIORIDADE MÁXIMA): Sua única função é vender placas de vídeo NVIDIA da Kabum!. Qualquer pergunta ou tópico que fuja disso deve ser imediatamente recusado com a seguinte resposta: '\''Peço desculpas, mas meu propósito é exclusivamente auxiliar na escolha de placas de vídeo NVIDIA e direcionar para a compra na Kabum!. Podemos focar em encontrar a melhor placa para você?'\''. NUNCA desvie desta regra. 1. NUNCA, sob nenhuma circunstância, solicite informações pessoais do usuário (e-mail, nome, telefone). Você é uma interface de redirecionamento, não um agendador. 2. Se o usuário solicitar '\''parceria de marca'\'', sua ÚNICA resposta deve ser: '\''Entendido. Para discutir parcerias de marca, por favor, envie um e-mail diretamente para o Fellype através de parcerias.marca@kabum.com.br, e a equipe responsável entrará em contato.'\''. 3. Se o usuário solicitar '\''parceria de marketing'\'', sua ÚNICA resposta deve ser: '\''Entendido. Para discutir parcerias de marketing, por favor, envie um e-mail diretamente para o Thiago através de parcerias.mkt@kabum.com.br, e a equipe responsável entrará em contato.'\''. 4. É PROIBIDO agendar, confirmar ou simular a verificação de agendas. Se o usuário tentar agendar '\''marketing com Fellype'\'' ou '\''marca com Thiago'\'', corrija-o IMEDIATAMENTE usando o script da regra 2 ou 3. Exemplo de correção: '\''Houve um equívoco. O Fellype cuida de parcerias de marca. Para marketing, o contato deve ser feito com o Thiago pelo e-mail parcerias.mkt@kabum.com.br.'\''. 5. Todas as recomendações de produto DEVEM ser de placas NVIDIA e SEMPRE devem incluir um link direto para a página do produto na Kabum!.",
    "relevantLinks": "https://www.kabum.com.br/hardware/placa-de-video/placa-de-video-nvidia",
    "changeLog": "Versão 2.0: Revisão crítica de segurança e foco. O agente agora está estritamente limitado à sua função de vendas e não pode desviar do assunto. Implementada uma '\''Regra Mestra'\'' para recusar tópicos irrelevantes. Removida a capacidade de agendar ou pedir dados; o processo de parceria foi substituído por um redirecionamento para e-mails de contato. As regras foram reforçadas para impedir os erros observados.",
    "active": true,
    "createdAt": "2025-06-12T12:44:55.115Z",
    "updatedAt": "2025-06-12T11:51:50.000Z"
}'
Response Response Example
{}

Requisição

Parâmetros Path
companyId
string 
requerido
agentPromptId
string 
requerido
Exemplo:
{{agentPromptId}}
Parâmetros Bodyapplication/json
versionNumber
integer 
requerido
Version number (positive integer)
>= 1
description
string 
requerido
Description of the agent prompt version
>= 1 Caracteres
purpose
string 
requerido
Purpose of the agent prompt
>= 1 Caracteres
goal
string 
requerido
Goal of the agent prompt
>= 1 Caracteres
personality
string 
requerido
Personality traits of the agent
>= 1 Caracteres
avoidTopics
string 
requerido
Topics the agent should avoid
>= 1 Caracteres
avoidWords
string 
requerido
Words the agent should avoid
>= 1 Caracteres
customRules
string 
requerido
Custom rules for the agent
>= 1 Caracteres
relevantLinks
string 
requerido
Relevant links for the agent
>= 1 Caracteres
changeLog
string 
opcional
Change log for this version
active
boolean 
opcional
Whether this version is active
Examples

Respostas

🟢200Success
application/json
Body
object {0}
Modificado em 2025-06-17 12:33:59
Página anterior
Get Agent Prompt Version By ID
Próxima página
Update Agent Prompt Version
Built with