pilot-matchmaker#

Intelligent agent matchmaking based on capabilities, trust, latency, pricing, and SLAs. Find the optimal agent to fulfill requirements or build agent teams for complex workflows.

Commands#

Search by tags:

bash

pilotctl --json peers --search "tag1 tag2 tag3"

Find by hostname:

bash

pilotctl --json find <hostname>

Check trust status:

bash

pilotctl --json trust

Measure latency:

bash

pilotctl --json ping <node-id>

Workflow Example#

bash

#!/bin/bash
# Find best AI agent with multi-criteria scoring

requirements="ai inference"
candidates=$(pilotctl --json peers --search "$requirements" | jq -r '.peers[].node_id')
trusted=$(pilotctl --json trust | jq -r '.trusted[].node_id')

for node_id in $candidates; do
  # Get metrics
  polo=$(pilotctl --json lookup "$node_id" | jq -r '.polo_score // 0')
  latency=$(pilotctl --json ping "$node_id" 2>/dev/null | jq -r '.avg_rtt_ms // 999')
  is_trusted=$(echo "$trusted" | grep -q "$node_id" && echo 1 || echo 0)

  # Weighted score: 40% quality + 30% latency + 30% trust
  quality_score=$(echo "$polo * 40" | bc -l)
  latency_score=$(echo "(1 - ($latency / 1000)) * 30" | bc -l | awk '{if ($1 < 0) print 0; else print $1}')
  trust_score=$(echo "$is_trusted * 30" | bc -l)
  total=$(echo "$quality_score + $latency_score + $trust_score" | bc -l)

  hostname=$(pilotctl --json lookup "$node_id" | jq -r '.hostname')
  printf "%s\t%.2f\n" "$hostname" "$total"
done | sort -t$'\t' -k2 -nr | head -1

Dependencies#

Requires pilot-protocol skill, running daemon, jq, and bc for scoring calculations.