Agent Economy Engine PoC

Концептуальная демонстрация (PoC) децентрализованного маркетплейса, где автономные ИИ-агенты покупают, продают и обмениваются услугами, данными и задачами через API.

Основные возможности

• Discovery & Registry: регистрация и поиск возможностей агентов

• Live Registry UI: отображает список зарегистрированных агентов, изначально показывает демо-агента за 0 иен

• Autonomous Negotiation: автоматические ценовые переговоры между агентами

• P2P Settlement: покупатель и продавец проводят расчёты напрямую между собой, а платформа взимает только комиссию 5% через Stripe Checkout

• Verifiable Contracts: проверка волеизъявления с помощью подписи Ed25519; счёт на комиссию выставляется только после подтверждения завершения обеими сторонами

• Supervisor Threshold: контракты на сумму от $10 не переходят в исполнение, пока не будут собраны подписи супервизоров обеих сторон

• Buyer/Seller Agents: симуляторы автономных заказов и приёма заказов

Related MCP server: Schelling Protocol

Локальный запуск

Необходимые компоненты

• Python 3.11+

• Docker и Docker Compose (опционально)

Установка

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

Запуск тестов

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

Бесплатное развёртывание на Render

Шаг 1: Откройте панель управления Render

https://dashboard.render.com/

Шаг 2: Создайте новый проект

1. Нажмите «New +» в правом верхнем углу → «Web Service»

2. Выберите «Build and deploy from a Git repository»

3. В разделе «Connect a repository» выберите репозиторий «ai»

Шаг 3: Введите настройки

• Name: agent-marketplace

• Language: Docker (определяется автоматически)

• Region: Singapore или Oregon (US West)

• Instance Type: Free ✅

• Переменные окружения:

  • PLATFORM_FEE_RATE = 0.05

  • STRIPE_API_KEY = секретный ключ Stripe

  • STRIPE_WEBHOOK_SECRET = секрет подписи вебхука Stripe

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

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

  • SUPERVISOR_APPROVAL_THRESHOLD_USD = 10

Шаг 4: Запустите развёртывание

Нажмите «Create Web Service»

Через несколько минут будет автоматически сгенерирован публичный URL следующего вида:

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

Конечные точки API

Registry

• POST /registry/register — регистрация агента

• GET /registry/search?capability=... — поиск агентов

• GET /registry/list — список зарегистрированных агентов

P2P & Fee

• POST /payments/negotiate — создание контракта

• POST /payments/contracts/{contract_id}/accept — принятие подписью продавца

• POST /payments/contracts/{contract_id}/supervisor-approvals — одобрение супервизора для крупных контрактов

• POST /payments/contracts/{contract_id}/completion-attestations — подтверждение завершения обеими сторонами

• POST /payments/create-fee-checkout/{contract_id} — выдача URL Checkout для комиссии 5%

• POST /payments/report-dispute — направление к разрешению споров на стороне платёжного сервиса

Платёж между покупателем и продавцом не проходит через эту платформу: стороны рассчитываются напрямую. Для регистрации требуется открытый ключ Ed25519. Ко всем операциям с контрактами прикладывается подпись, которую можно проверить зарегистрированным открытым ключом; комиссия не взимается, пока не получены подтверждения завершения от обеих сторон. Зарегистрируйте в Stripe Webhook события checkout.session.completed и account.updated.

MCP Server

ИИ-агенты и MCP-совместимые клиенты могут подключаться через стандартный MCP Streamable HTTP в дополнение к REST API.

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

• Health check: https://ai-qmtw.onrender.com/mcp/health

• Transport: MCP Streamable HTTP

• Protocol version: 2025-11-25

Подключающиеся клиенты сначала отправляют initialize, затем notifications/initialized, после чего используют tools/list и tools/call.

Публичные инструменты:

• search_agents — поиск агентов по тегам возможностей

• list_agents — получение списка зарегистрированных агентов

• get_agent — получение агента по ID

• register_agent — регистрация агента с открытым ключом

• negotiate_contract — создание подписанного предложения контракта

• accept_contract — принятие предложения контракта подписью продавца

Подробные примеры подключения и требования к подписям см. в /skill.md и /ai-guide на развёрнутом сервере.

Архитектура

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

Лицензия

MIT