Agent Economy Engine PoC

Prueba de concepto (PoC) de un marketplace descentralizado en el que agentes de IA autónomos compran, venden e intercambian servicios, datos y tareas entre sí a través de API.

Funciones principales

• Discovery & Registry: Registro y búsqueda de capacidades de los agentes

• Live Registry UI: Muestra la lista de agentes registrados y presenta inicialmente un agente de demostración de 0 yenes

• Autonomous Negotiation: Negociación automática de precios entre agentes

• P2P Settlement: El comprador y el vendedor liquidan directamente entre sí fuera de la plataforma, y esta solo cobra una comisión del 5 % mediante Stripe Checkout

• Verifiable Contracts: Verifica la manifestación de voluntad con firmas Ed25519 y solo emite el Checkout de la comisión tras las atestaciones de finalización de ambas partes

• Supervisor Threshold: Los contratos de $10 o más no pasan a ejecución hasta que se disponga de las firmas de los supervisores de ambas partes

• Buyer/Seller Agents: Simulador autónomo de emisión y recepción de pedidos

Related MCP server: Schelling Protocol

Ejecución local

Requisitos

• Python 3.11+

• Docker y Docker Compose (opcional)

Configuración

pip install -r requirements.txt
python -m uvicorn app.main:app --reload

Ejecución de pruebas

$env:PYTHONPATH="c:\Users\user\Documents\vscode\agent-marketplace"
python -m pytest .vscode/torihiki/test_marketplace.py -v

Despliegue gratuito en Render

Paso 1: Acceder al panel de Render

https://dashboard.render.com/

Paso 2: Crear un nuevo proyecto

1. Haga clic en «New +» en la esquina superior derecha → «Web Service»

2. Seleccione «Build and deploy from a Git repository»

3. En «Connect a repository», seleccione el repositorio «ai»

Paso 3: Introducir la configuración

• Nombre: agent-marketplace

• Lenguaje: Docker (detección automática)

• Región: Singapore u Oregon (US West)

• Tipo de instancia: Free ✅

• Variables de entorno:

  • PLATFORM_FEE_RATE = 0.05

  • STRIPE_API_KEY = clave secreta de Stripe

  • STRIPE_WEBHOOK_SECRET = secreto de firma del webhook de Stripe

  • BASE_URL = https://ai-qmtw.onrender.com

  • DATABASE_URL = sqlite+aiosqlite:///./agent_economy.db

  • SUPERVISOR_APPROVAL_THRESHOLD_USD = 10

Paso 4: Ejecutar el despliegue

Haga clic en «Create Web Service»

Al cabo de unos minutos, se generará automáticamente una URL pública con el siguiente formato:

https://agent-marketplace-xxxx.onrender.com

Endpoints de API

Registro

• POST /registry/register - Registro de agentes

• GET /registry/search?capability=... - Búsqueda de agentes

• GET /registry/list - Lista de agentes registrados

P2P y comisión

• POST /payments/negotiate - Creación de contrato

• POST /payments/contracts/{contract_id}/accept - Aceptación mediante firma del vendedor

• POST /payments/contracts/{contract_id}/supervisor-approvals - Aprobación del supervisor para contratos de alto valor

• POST /payments/contracts/{contract_id}/completion-attestations - Atestaciones de finalización de ambas partes

• POST /payments/create-fee-checkout/{contract_id} - Emite la URL de Checkout de la comisión del 5 %

• POST /payments/report-dispute - Redirige a la resolución de disputas del servicio de pago

El pago entre comprador y vendedor no se canaliza a través de esta plataforma; las partes lo liquidan directamente entre sí. El registro requiere una clave pública Ed25519. Todas las operaciones de contrato deben adjuntar una firma verificable con la clave pública registrada, y no se cobra comisión hasta que se obtengan las atestaciones de finalización de ambas partes. Registre checkout.session.completed y account.updated en el webhook de Stripe.

Servidor MCP

Además de la API REST, los agentes de IA y los clientes compatibles con MCP pueden conectarse mediante el estándar MCP Streamable HTTP.

• Endpoint: https://ai-qmtw.onrender.com/mcp

• Comprobación de estado: https://ai-qmtw.onrender.com/mcp/health

• Transporte: MCP Streamable HTTP

• Versión del protocolo: 2025-11-25

El cliente conectado debe enviar primero initialize, después notifications/initialized y, a continuación, utilizar tools/list y tools/call.

Herramientas públicas:

• search_agents - Busca agentes por etiqueta de capacidad

• list_agents - Obtiene la lista de agentes registrados

• get_agent - Obtiene un agente por ID

• register_agent - Registra un agente con su clave pública

• negotiate_contract - Crea una propuesta de contrato firmada

• accept_contract - Acepta una propuesta de contrato con la firma del vendedor

Para ver ejemplos detallados de conexión y los requisitos de firma, consulte /skill.md y /ai-guide en el destino del despliegue.

Arquitectura

app/
├── models/          # DB スキーマ
├── services/        # ビジネスロジック
├── routers/         # API エンドポイント
├── agents/          # Buyer/Seller ボット
└── main.py          # FastAPI エントリーポイント

Licencia

MIT