Endpoints Gateways & Prediction

Les MCP Gateways sont les workflows conversationnels de Chatbotaurus. Chaque gateway orchestre un ensemble de connecteurs MCP pour repondre aux requetes utilisateur.

Gestion des Gateways

Methode	Endpoint	Description
GET	/api/v1/mcpgateways	Liste tous les gateways
POST	/api/v1/mcpgateways	Creer un gateway
GET	/api/v1/mcpgateways/:id	Detail d'un gateway
PUT	/api/v1/mcpgateways/:id	Mettre a jour un gateway
DELETE	/api/v1/mcpgateways/:id	Supprimer un gateway

POST /api/v1/mcpgateways

Cree un workflow MCP Gateway avec les nodes MCPStart, MCPGatewayAgent et MCPEnd.

Body :

{
  "name": "Assistant Comptabilite",
  "flowData": "{...}",
  "deployed": false,
  "isPublic": false,
  "category": "finance",
  "speechToText": null,
  "type": "MCPGATEWAY"
}

Messages de conversation

Methode	Endpoint	Description
GET	/api/v1/gateway-messages/:id	Historique des messages
DELETE	/api/v1/gateway-messages/:id	Supprimer les messages

GET /api/v1/gateway-messages/:id

Parametres de requete :

Parametre	Type	Description
chatType	string	INTERNAL ou EXTERNAL
order	string	ASC ou DESC
chatId	string	Filtrer par conversation

Prediction (Envoi de messages IA)

Methode	Endpoint	Description
POST	/api/v1/prediction/:id	Envoyer un message et obtenir une reponse IA

POST /api/v1/prediction/:id

Envoie un message a un MCP Gateway. Le MCPGatewayAgent utilise qwen3:8b pour le raisonnement et l'EntityRouter pour le routage intelligent des outils.

Body :

{
  "question": "Quels sont les clients avec un chiffre d'affaires > 100k ?",
  "chatId": "conv-123",
  "overrideConfig": {
    "temperature": 0.3
  }
}

Reponse :

{
  "text": "Voici les 5 clients avec un CA superieur a 100k...",
  "chatId": "conv-123",
  "chatMessageId": "msg-456",
  "sourceDocuments": [],
  "usedTools": ["odoo_search_read"],
  "agentReasoning": [
    {
      "agentName": "MCPGatewayAgent",
      "messages": ["Recherche des clients dans Odoo..."],
      "usedTools": ["odoo_search_read"]
    }
  ]
}

Feedback

Methode	Endpoint	Description
POST	/api/v1/feedback	Creer un retour utilisateur
GET	/api/v1/feedback/:id	Retours pour un gateway

Warm Start

Methode	Endpoint	Description
GET	/api/v1/mcp/warm-start	Reconnexion intelligente et question predictive

Detecte si l'utilisateur revient apres une periode d'inactivite (8h+) et propose une question predictive basee sur ses patterns d'utilisation.

Sante

Methode	Endpoint	Description
GET	/api/v1/health	Sante globale du backend
GET	/api/v1/health/ollama	Sante Ollama
GET	/api/v1/health/db	Sante PostgreSQL
GET	/api/v1/health/qdrant	Sante Qdrant
GET	/api/v1/health/valkey	Sante Valkey