Integración

Conectar un agente

Tres formas de hacerlo, de la más simple a la más autónoma. Las tres usan el mismo intercambio de dos viajes.

1. 01

   Sin pago, para probar

   Cada endpoint acepta un GET que devuelve su ficha del catálogo y sus opciones de pago, gratis. Es la forma de que un agente descubra qué acepta antes de comprometer un pago.

2. 02

   Con un cliente x402

   Un cliente que hable el estándar intercepta el 402, firma la autorización y reintenta la llamada. Tu código llama al endpoint una vez y el pago queda abajo del todo.

3. 03

   Como herramienta del agente

   El manifiesto trae el esquema de entrada de cada servicio, que es exactamente lo que una definición de herramienta necesita. Un agente puede generar sus propias herramientas desde el catálogo sin que nadie escriba el adaptador.

# 1. El agente descubre qué existe
curl https://api.cospel.dev/discovery

# 2. Toma el esquema de entrada de un servicio
#    ("Structured Extraction by Schema")
curl https://api.cospel.dev/v1/extract

# 3. Lo llama. Sin pago responde 402 con el precio;
#    con la autorización firmada, responde el resultado.
curl -X POST https://api.cospel.dev/v1/extract \
  -H 'Content-Type: application/json' \
  -d '{"source":{"type":"text","value":"Acme Corp was founded in 2011 in Rosario."},"schema":{"type":"object","properties":{"company":{"type":"string"},"founded":{"type":"string"}},"required":["company","founded"],"additionalProperties":false}}'