Saltar para o conteúdo principal

Opções de integração

  • Agent API: melhor para chat e conversas multi-turno
  • MCP Server: melhor para integrações customizadas e acesso direto às ferramentas

Opção 1: Agent API

Endpoint

POST /catalog/search

Headers

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

Exemplo de request

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

Opção 2: MCP Server

Conexão

URL: https://your-mcp-server.example.com/mcp
Transport: Streamable HTTP
X-API-Key: YOUR_API_KEY
Use a ferramenta search_products com parâmetros como query, max_results e max_sponsored.

Boas práticas

  • Identifique claramente produtos patrocinados (is_sponsored: true)
  • Rastreie resolvedBidId para atribuição
  • Reuse session_id para manter contexto
  • Implemente retry com backoff para erros 5xx