Setup und Integration

Richten Sie Topsort Prompts ein und integrieren Sie uber Agent API oder MCP.

​

Integrationsoptionen

• Agent API: fur Chat-Interfaces und Multi-Turn-Konversationen
• MCP Server: fur individuelle Integrationen und direkten Tool-Zugriff

​

Option 1: Agent API

​

Endpoint

POST /topsort_prompts/chat

​

Header

X-API-Key: YOUR_API_KEY
Content-Type: application/json

​

Request-Beispiel

{
  "query": "I need running shoes under $150",
  "session_id": "user-session-123",
  "max_results": 10,
  "max_sponsored": 3,
  "streaming": false
}

Wichtige Felder: query, session_id, max_results, max_sponsored, streaming.

​

Option 2: MCP Server

​

Verbindung

URL: https://mcp-server.api.topsort.ai/mcp
Transport: Streamable HTTP

X-API-Key: YOUR_API_KEY

Nutzen Sie das Tool search_products mit Parametern wie query, max_results und max_sponsored.

​

Best Practices

• Kennzeichnen Sie Sponsored-Produkte klar (is_sponsored: true)
• Tracken Sie resolvedBidId fur Attribution
• Nutzen Sie dieselbe session_id fur Follow-up-Fragen
• Implementieren Sie Retry mit Backoff fur 5xx-Fehler