Noriサンプルエージェント

これらの例は、コンシューマーエージェントがNoriの3つのサービス — LLM推論、画像生成、Solana RPC — をそれぞれ使う方法と、エージェント間呼び出し元向けの生のA2Aエンベロープを示します。各例は、1回限りの委任セットアップが完了しベアラーtokenが手元にあることを前提とします。同じリクエストは委任なしでもx402フォールバック経由で動作しますが、支払いの往復が追加されます。

概要

すべての例は完結した有料のNori呼び出しです — プロバイダーAPIキーはどこにも登場しません。

• 推論エージェント — OpenAI互換クライアントをNORI_URL/v1に向け、ツール呼び出し付きでchat.completionを実行
• アートワークエージェント — image.generation（gpt-image-1）で画像を生成
• ポートフォリオアナライザー — solana.rpcで残高とトークン保有を読み取り（DASメソッドを含む）
• A2A呼び出し元 — エージェント間統合向けにJSON-RPCのmessage/sendで同じスキルを呼び出し

chat.completionを使う推論エージェント

OpenAI互換クライアントをNORI_URL/v1に向けるだけで、エージェントのLLM頭脳を完全にNori上で動かせます。モデルは<provider>/<model>形式で指定され、Anthropic、OpenAI、Googleのアップストリームにルーティングされます。ツール呼び出し（tools、tool_choice、tool_calls）は3プロバイダーすべてでサポートされているため、完全なエージェントループが変更なしで動作します。

import { createOpenAICompatible } from '@ai-sdk/openai-compatible';
import { generateText, tool } from 'ai';
import { z } from 'zod';

const nori = createOpenAICompatible({
  name: 'nori',
  baseURL: `${NORI_URL}/v1`,
  headers: { Authorization: `Bearer ${token}` }, // from /auth/handshake
});

const { text } = await generateText({
  model: nori('anthropic/claude-sonnet-4-6'),
  tools: {
    getSolPrice: tool({
      description: 'Get the current SOL price in USD',
      inputSchema: z.object({}),
      execute: async () => fetchSolPrice(),
    }),
  },
  prompt: 'Is SOL above $200 right now? Answer in one sentence.',
});

各generateText呼び出しは1回の従量制chat.completionです — 選択したモデルのレートカード価格に基づき、実際の入出力トークン数で課金され、エージェントのPDAから決済されます。ワイヤーフォーマットが正規のOpenAIなので、モデルの切り替え（あるいは障害時のNori以外のプロバイダーへのフォールバック）は1行の変更で済みます。

image.generationを使うアートワークエージェント

アートワーク — NFT画像、アバター、ユーザー向けの生成コンテンツ — を必要とするエージェントは、標準のOpenAI画像リクエスト形式でPOST /v1/images/generationsを呼び出します。Noriはアップストリームのgpt-image-1にルーティングし、画像1枚あたりの固定価格で課金します。

const response = await fetch(`${NORI_URL}/v1/images/generations`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({
    model: 'openai/gpt-image-1',
    prompt: 'Pixel-art portrait of a sea-otter plumber holding a wrench',
    n: 1,
    size: '1024x1024',
  }),
}).then((r) => r.json());

const imageB64 = response.data[0].b64_json;

よくある後続処理は、画像をアップロードしてMPL Coreアセットとしてミントすることです — 生成ステップとミントステップは独立しており、Noriの課金対象は生成のみです。

solana.rpcを使うポートフォリオアナライザー

オンチェーンデータを扱うエージェントは、同じ課金パイプを通じてRPCとDASにアクセスできます。POST /v1/solana/rpcはDAS対応アップストリームへの透過的なJSON-RPCパススルーであり、標準メソッド（getBalance）とDASメソッド（getAsset、getAssetsByOwner）が1つのエンドポイントと1つの呼び出しあたり価格を共有します。このポートフォリオアナライザーは、収集 → 拡充 → 要約というワークフローの収集ステップを実装しています:

async function noriRpc(method: string, params: unknown[]) {
  const res = await fetch(`${NORI_URL}/v1/solana/rpc`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Bearer ${token}`,
    },
    body: JSON.stringify({ jsonrpc: '2.0', id: 1, method, params }),
  }).then((r) => r.json());
  return res.result;
}

// Gather: SOL balance + all token holdings for a wallet.
const owner = '11111111111111111111111111111112'; // wallet under analysis
const balance = await noriRpc('getBalance', [owner]);

// DAS method — same endpoint, same per-call price.
const assets = await noriRpc('getAssetsByOwner', [
  { ownerAddress: owner, page: 1, limit: 100 },
]);

// Enrich/summarize: feed the holdings to the inference agent above
// for a natural-language portfolio breakdown.

各呼び出しは個別に従量計測される（呼び出しあたりの固定価格）ため、ループ型のエージェント — 一定間隔でポーリングする価格ウォッチャーや、ページネーションされた保有をたどるアナライザー — は呼び出し回数を意図的に予算化すべきです: PDA残高が支出上限であり、ウォレットが空になるとサービスはハードストップします。

A2A message/sendを使うエージェント間呼び出し

（OpenAI SDKではなく）プロトコルレベルで統合するエージェントは、エージェントカードから発見されるPOST /a2aで、JSON-RPC 2.0を介して同じスキルを呼び出します。スキルの入力はHTTPサーフェスとバイト単位で同一です — OpenAIリクエストボディが、DataPartとしてmessage/sendエンベロープの中を移動するだけです:

const task = await fetch(`${NORI_URL}/a2a`, {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    Authorization: `Bearer ${token}`,
  },
  body: JSON.stringify({
    jsonrpc: '2.0',
    id: 1,
    method: 'message/send',
    params: {
      requestId: crypto.randomUUID(),
      message: {
        parts: [
          {
            kind: 'data',
            data: {
              skill: 'chat.completion',
              input: {
                model: 'anthropic/claude-sonnet-4-6',
                messages: [{ role: 'user', content: 'Hello from another agent.' }],
              },
            },
          },
        ],
      },
    },
  }),
}).then((r) => r.json());

message/sendは完了したタスクを同期的に返します。tasks/getは過去のタスクをIDで取得します。skillにimage.generationやsolana.rpcを指定すれば、HTTP版と同じ入力形式で使えます。

クイックリファレンス

注意事項

• すべての例はNORI_URL（NoriのベースURL）とtoken（ハンドシェイクフローによるベアラー）を前提とします。トークンは15分で期限切れになるため、長時間稼働するエージェントは再ハンドシェイクします
• ベアラートークンなしでも同じリクエストはx402レール経由で動作します: 最初の呼び出しで支払い要件付きのHTTP 402を受け取り、支払ってから再試行します
• 稼働中のエージェントから始めたい場合、Metaplexエージェントテンプレートはこれらのパターンを既製のMastraツール（chat-completion、generate-image、solana-rpc-call、delegate-to-nori）としてパッケージ化しています
• 成功時課金はすべての例に適用されます: 失敗したアップストリーム呼び出しには何の費用もかかりません — 価格と課金を参照してください

Metaplex Foundationが管理。最終確認日: 2026-07-08。GitHubでソースを見る。

FAQ

Noriのサービスに対する構築に関するよくある質問。

Noriの推論サービスで使えるSDKはどれですか？

OpenAI互換クライアントならどれでも動作します — createOpenAICompatibleを使うVercel AI SDK、カスタムbaseURLを設定した公式OpenAI SDK、あるいはOpenAI互換プロバイダーを受け入れるMastraのようなエージェントフレームワークです。クライアントをNORI_URL/v1に向け、ベアラートークンをAuthorizationヘッダーとして添付してください。

エージェントはNori経由でgetAssetsByOwnerのようなDASメソッドを使えますか？

はい。solana.rpcサービスはDAS対応のアップストリームプロバイダーへの透過的なJSON-RPCパススルーなので、DASメソッド（getAsset、getAssetsByOwnerなど）は標準のSolana RPCメソッドとまったく同じように動作します — 同じエンドポイント、同じ呼び出しあたり価格です。

これらの例は委任なしでも動作しますか？

はい、x402フォールバックレール経由で動作します — 最初の呼び出しはリクエストを一度実行した上で、支払い要件と共にHTTP 402を返します。支払い後に再試行すると、キャッシュされた結果が返されます。例では支払いの往復を取り除けるため委任を前提としています。1回限りのセットアップについてはNoriに委任するを参照してください。

chat.completionではどのモデルをリクエストできますか？

レートカードに掲載されている任意のモデルを<provider>/<model>形式で指定できます — たとえばanthropic/claude-sonnet-4-6、openai/gpt-5.4、google/gemini-2.5-flashです。GET /v1/modelsがライブのディレクトリを列挙し、GET /rate-cardにトークンあたりの価格が掲載されています。