Agentes

Execução de agentes, WebChat e multicanal

Gerar áudio TTS para um agente

post

Autorizações

ApiKeyAuth

AuthorizationstringObrigatório

Corpo

application/json

textstringObrigatório

Texto a sintetizar

agent_idstringObrigatório

ID do agente (aceita "agent_" ou apenas "")

slugstringObrigatório

Nome do arquivo de saída (será salvo como .mp3)

Respostas

200

Áudio gerado com sucesso

application/json

400

Requisição inválida (campos obrigatórios ou TTS ausente)

application/json

401

Falha de autenticação

application/json

404

Agente ou configuração TTS não encontrada

application/json

500

Erro interno ao gerar áudio

application/json

post

/api/v3/agent_voice

HTTPcURLJavaScriptPython

POST /my-tenant/api/v3/agent_voice HTTP/1.1
Host: app.genier.ai
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "text": "Olá, este é o script do bot.",
  "agent_id": "agent_1234abcd",
  "slug": "saudacao"
}

{
  "result": "ok",
  "message": "Áudio gerado com sucesso",
  "public_url": "/agent_voice/1234abcd/saudacao.mp3"
}

Executar agente (texto) com histórico

post

Autorizações

ApiKeyAuth

AuthorizationstringObrigatório

Parâmetros de rota

agent_idstringObrigatório

ID do agente (ex.: agent_1234abcd)

Corpo

application/json

querystringObrigatório

Pergunta do usuário

ttsbooleanOpcionalDefault: false

user_promptstringOpcional

Instruções adicionais para o agente

voice_prioritybooleanOpcionalDefault: false

ask_humanbooleanOpcionalDefault: false

Respostas

200

Resposta do agente

application/json

400

Parâmetros obrigatórios ausentes

application/json

401

Falha de autenticação

application/json

post

/api/v3/agent/{agent_id}

HTTPcURLJavaScriptPython

POST /my-tenant/api/v3/agent/{agent_id} HTTP/1.1
Host: app.genier.ai
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 181

{
  "query": "Como funciona o produto?",
  "history": [
    {
      "input": "Oi",
      "output": "Olá, posso ajudar."
    }
  ],
  "tts": false,
  "user_prompt": "Use tom amigável",
  "voice_priority": false,
  "ask_human": false
}

{
  "status": 0,
  "history": [
    {
      "output": "Olá, posso ajudar."
    },
    {
      "output": "O produto funciona assim..."
    }
  ],
  "response": "O produto funciona assim...",
  "entity": false,
  "entity_content": {},
  "tts_audio_mp3_encoded_base64": "NA"
}

Executar agente para WebChat

post

Autorizações

ApiKeyAuth

AuthorizationstringObrigatório

Parâmetros de rota

agent_idstringObrigatório

ID do agente (ex.: agent_1234abcd)

Corpo

application/json

querystringObrigatório

ttsbooleanOpcionalDefault: false

Respostas

200

Resposta do agente para WebChat

application/json

400

Parâmetros obrigatórios ausentes

application/json

401

Falha de autenticação

application/json

post

/api/v3/webchat/{agent_id}

HTTPcURLJavaScriptPython

POST /my-tenant/api/v3/webchat/{agent_id} HTTP/1.1
Host: app.genier.ai
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 114

{
  "query": "Qual o status do meu pedido?",
  "history": [
    {
      "input": "Oi",
      "output": "Olá, como posso ajudar?"
    }
  ],
  "tts": true
}

{
  "status": 0,
  "history": [
    {
      "output": "Olá, como posso ajudar?"
    },
    {
      "output": "Seu pedido está em separação."
    }
  ],
  "response": "Seu pedido está em separação.",
  "entity": false,
  "entity_content": {},
  "tts_audio_mp3_encoded_base64": "<base64>"
}

Executar agente multimodal (texto, áudio, OCR, upload)

post

Autorizações

ApiKeyAuth

AuthorizationstringObrigatório

Parâmetros de rota

agent_idstringObrigatório

ID do agente (ex.: agent_1234abcd)

Corpo

application/jsonmultipart/form-data

textstringObrigatório

Texto a ser processado (quando não usar arquivos)

ttsbooleanOpcionalDefault: false

hashtagbooleanOpcional

Se true, remove e retorna hashtags encontradas

Default: false

ask_humanbooleanOpcionalDefault: false

user_promptstringOpcional

voice_prioritybooleanOpcionalDefault: false

session_idstring · uuidOpcional

Respostas

200

Resposta do agente multimodal

application/json

400

Parâmetros obrigatórios ausentes ou entrada inválida

application/json

401

Falha de autenticação

application/json

403

Conteúdo não suportado para o modo do agente

application/json

413

Arquivo muito grande

application/json

415

Tipo de arquivo não suportado

application/json

500

Erro interno ao processar conteúdo

application/json

post

/api/v3/agent_mm/{agent_id}

HTTPcURLJavaScriptPython

POST /my-tenant/api/v3/agent_mm/{agent_id} HTTP/1.1
Host: app.genier.ai
Authorization: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 186

{
  "history": [
    {
      "input": "Oi",
      "output": "Olá"
    }
  ],
  "text": "Analise o texto do PDF.",
  "tts": false,
  "hashtag": false,
  "ask_human": false,
  "user_prompt": "Resuma em bullet points",
  "voice_priority": false
}

application/jsonmultipart/form-data

{
  "status": 0,
  "history": [
    {
      "output": "Processado com sucesso"
    }
  ],
  "response": "Resumo do conteúdo",
  "entity": true,
  "entity_content": {
    "hashtags": [
      "#promo",
      "#lancamento"
    ]
  },
  "tts_audio_mp3_encoded_base64": "<base64>",
  "file_encoded_base64": "<base64>",
  "session_id": "c9d5b1d4-0e3b-4a6f-9a8d-1234567890ab"
}

Listar agentes disponíveis

get

Autorizações

ApiKeyAuth

AuthorizationstringObrigatório

Respostas

200

Lista de agentes

application/json

401

Falha de autenticação

application/json

get

/api/v3/agent_list

HTTPcURLJavaScriptPython

GET /my-tenant/api/v3/agent_list HTTP/1.1
Host: app.genier.ai
Authorization: YOUR_API_KEY
Accept: */*

[
  {
    "name": "Atendimento Geral",
    "id": "agent_1234abcd"
  },
  {
    "name": "Suporte Técnico",
    "id": "agent_5678efgh"
  }
]

Executar agente multimodal via WebChat

post

Parâmetros de rota

agent_idstringObrigatório

Corpo

application/jsonmultipart/form-data

textstringObrigatório

Texto a ser processado (quando não usar arquivos)

ttsbooleanOpcionalDefault: false

hashtagbooleanOpcional

Se true, remove e retorna hashtags encontradas

Default: false

ask_humanbooleanOpcionalDefault: false

user_promptstringOpcional

voice_prioritybooleanOpcionalDefault: false

session_idstring · uuidOpcional

Respostas

200

Resposta do agente multimodal

application/json

400

Falha de autenticação ou corpo inválido

application/json

post

/api/v3/webchat_mm/{agent_id}

HTTPcURLJavaScriptPython

POST /my-tenant/api/v3/webchat_mm/{agent_id} HTTP/1.1
Host: app.genier.ai
Content-Type: application/json
Accept: */*
Content-Length: 216

{
  "history": [
    {
      "input": "text",
      "output": "text",
      "role": "text"
    }
  ],
  "text": "text",
  "tts": false,
  "hashtag": false,
  "ask_human": false,
  "user_prompt": "text",
  "voice_priority": false,
  "session_id": "123e4567-e89b-12d3-a456-426614174000"
}

application/jsonmultipart/form-data

{
  "status": 1,
  "history": [
    {
      "input": "text",
      "output": "text",
      "role": "text"
    }
  ],
  "response": "text",
  "entity": true,
  "entity_content": {},
  "tts_audio_mp3_encoded_base64": "text",
  "file_encoded_base64": "text",
  "session_id": "text"
}