Gerar sumarização de atendimentos

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://api-docs.neppo.com.br/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Neppo API MCP server": {
    "url": "https://api-docs.neppo.com.br/mcp"
  }
}
Close
POST /transformersapi/1.0/text_summarization/{hostname}/{document}
Bearer auth
Campo Obrigatório Descrição
provider Sim Provider de LLM: OpenAI, IAN, AWS
model Sim Identificador do modelo a ser utilizado
token Sim Objeto com access_key, secret_key e token
query Não Filtros da busca histórica. Aceita os seguintes formatos:

  • String: Busca por um termo exato (ex: "CTE = 30237").
  • Array de Strings: Busca por múltiplos termos simultâneos (ex: ["CTE = 30237", "CTE = 30238"]).
  • Objeto: Filtros estruturados start_period, finished_period e size.

    Os campos de data devem seguir o padrão YYYY-MM-DD, por exemplo:
    "start_period": "2026-04-01"
    "finished_period": "2026-05-01"

    Para o campo size, o limite máximo é 1000 e o padrão é 100.
prompt Não Prompt para orientar a sumarização. Se omitido, usa prompt padrão
include_user_chat_history Não true usa histórico consolidado; false busca histórico bruto no banco (padrão: true)

Path parameters

  • hostname string Required

    Hostname do ambiente do cliente

  • document string Required

    Documento do cliente (CPF, telefone ou e-mail)

application/json

Body

  • provider string
  • model string
  • token array[object]
    Hide token attributes Show token attributes object
    • access_key string
    • secret_key string
    • token string
  • prompt string
  • include_user_chat_history boolean
  • query object
    Hide query attributes Show query attributes object
    • start_period string
    • end_period string
    • size number

Responses

  • 200 application/json

    Requisição processada com sucesso. Retorna os dados correspondentes ao filtro informado.

    Hide response attributes Show response attributes object
    • provider string
    • model string
    • summary string
    • token_usage object
      Hide token_usage attributes Show token_usage attributes object
      • prompt_tokens number
      • completion_tokens number
      • total_tokens number
  • 400 application/json

    Requisição inválida. Verifique a sintaxe do corpo e os campos obrigatórios.

    Hide response attribute Show response attribute object
    • detail string
  • 401 application/json

    Token de autenticação ausente ou inválido. Envie o header Authorization: Bearer {token}.

    Hide response attribute Show response attribute object
    • status string
  • 406 application/json

    Formato de requisição não aceito. Verifique os cabeçalhos Content-Type/Accept.

    Hide response attribute Show response attribute object
    • detail string
  • 500 application/json

    Erro interno no servidor. Tente novamente mais tarde ou contate o suporte Neppo.

    Hide response attribute Show response attribute object
    • detail string
POST /transformersapi/1.0/text_summarization/{hostname}/{document} 
curl \
 --request POST 'https://api.neppo.com.br/transformersapi/1.0/text_summarization/{hostname}/{document}' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{"provider":"IAN","model":"neppo-model","token":[{"access_key":"SUA_ACCESS_KEY","secret_key":"SUA_SECRET_KEY","token":""}],"prompt":"Resuma os principais problemas relatados pelo cliente e como foram resolvidos.","include_user_chat_history":true,"query":{"start_period":"2026-04-01","end_period":"2026-05-01","size":100}}'
Request example 
{
  "provider": "IAN",
  "model": "neppo-model",
  "token": [
    {
      "access_key": "SUA_ACCESS_KEY",
      "secret_key": "SUA_SECRET_KEY",
      "token": ""
    }
  ],
  "prompt": "Resuma os principais problemas relatados pelo cliente e como foram resolvidos.",
  "include_user_chat_history": true,
  "query": {
    "start_period": "2026-04-01",
    "end_period": "2026-05-01",
    "size": 100
  }
}
Response examples (200) 
{
  "provider": "IAN",
  "model": "neppo-model",
  "summary": "O cliente entrou em contato 3 vezes no último mês. Na primeira ocorrência reportou problemas de acesso; o agente redefiniu a senha com sucesso. Na segunda, solicitou informações sobre faturamento. Na terceira, relatou lentidão no sistema que foi escalada para o time técnico.",
  "token_usage": {
    "prompt_tokens": 1024,
    "completion_tokens": 256,
    "total_tokens": 1280
  }
}
Response examples (400) 
{
  "detail": "Requisição inválida."
}
Response examples (401) 
{
  "status": "Unauthorized"
}
Response examples (406) 
{
  "detail": "Provider ou modelo inválido."
}
Response examples (500) 
{
  "detail": "Erro ao gerar sumarização."
}