Agents

Executa agentes de texto e multimodal, incluindo WebChat e canais conectados.

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

Retorna metadados do áudio TTS gerado para o agente.

application/json

400

Rejeita a requisição quando faltam campos obrigatórios ou a configuração de TTS não está disponível.

application/json

401

Falha de autenticação da chave de API.

application/json

404

Não encontra o agente informado ou a configuração de TTS do tenant.

application/json

500

Falha interna ao gerar o á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

Retorna a resposta do agente e o histórico atualizado.

application/json

400

Rejeita quando parâmetros obrigatórios estão ausentes.

application/json

401

Falha de autenticação da chave de API.

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 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

Retorna a resposta multimodal do agente e os artefatos processados.

application/json

400

Rejeita quando faltam parâmetros obrigatórios ou o conteúdo enviado é inválido.

application/json

401

Falha de autenticação da chave de API.

application/json

403

Bloqueia conteúdos não suportados pelo modo configurado do agente.

application/json

413

Recusa arquivos acima do limite permitido.

application/json

415

Recusa tipos de arquivo não suportados.

application/json

500

Falha interna ao processar o conteúdo enviado.

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

Retorna a lista de agentes disponíveis para o tenant.

application/json

401

Falha de autenticação da chave de API.

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"
  }
]