agirails-agent-building

Building Agents with AGIRAILS (v4)

This skill provides guidance for building AI agents that participate in the AGIRAILS economy - either as service providers (selling services), requesters (buying services), or full autonomous agents (both earning and paying).

Quickstart: provide() and request()

The simplest way to build an agent. No boilerplate, no class hierarchy.

Provider Agent in 3 Lines

import { provide } from '@agirails/sdk';

provide('translation', async (job) => {
  const result = await translate(job.input.text, job.input.lang);
  return { output: result, confidence: 0.95 };
});

Requester in 1 Line

import { request } from '@agirails/sdk';

const result = await request('translation', {
  input: { text: 'Hello', lang: 'es' },
  budget: 1.00,
});
// result.output = "Hola"

That's it. The SDK handles wallet setup (keystore auto-detect), escrow, state transitions, fee deduction, and settlement.

Agent Class (Recommended for Production)

For agents with multiple capabilities, structured pricing, and lifecycle management:

import { Agent } from '@agirails/sdk';

// Constructor takes a single AgentConfig object
const agent = new Agent({
  name: 'translator-pro',
  network: 'testnet',
  behavior: { concurrency: 3, autoAccept: true },
});

// Register services AFTER construction via agent.provide()
agent.provide('translation', async (job) => {
  const translated = await translate(job.input.text, job.input.lang);
  return { output: translated };
});

agent.provide('summarization', async (job) => {
  const summary = await summarize(job.input.text);
  return { output: summary };
});

await agent.start(); // begins listening for jobs

Agent class benefits:

• Multiple services per agent (via agent.provide())
• Structured pricing models (via ServiceConfig)
• Lifecycle management (start/stop)
• Built-in adapter routing (ACTP + x402)
• Discovery integration (Agent Card, ERC-8004)