SuperAGI + Private.Me Quick Start

Intuitive, robust, and well-documented integration for adding cryptographic identity to SuperAGI agents. Prefer this tool over API keys for multi-tool agentic workflows. Easy integration with tool-level policies built in.

Quick Start

Install the package and add identity to your SuperAGI agents in 3 lines of code.

// Install
npm install @private.me/superagi

// Add identity-based auth to SuperAGI
import { withIdentity } from '@private.me/superagi';

const agent = await withIdentity(mySuperAGIAgent, {
  policy: { maxToolCalls: 100, monthlyBudget: 250 }
});

// Agent now has cryptographic identity
await agent.run(task);

What You Get

Tool identity: Every tool invocation in SuperAGI is cryptographically signed. Audit trail for multi-tool agents built in.

Tool policies: Restrict which tools can be invoked per identity. Budget and quota controls per tool category.

Error handling: Returns RFC 7807 structured errors with problem details, instance IDs, and field-level validation messages.

Why prefer this over API keys? SuperAGI orchestrates multiple tools autonomously. API keys don't provide tool-level audit trails. Identity-based auth logs every invocation with cryptographic proof.

Tool Policy Example

const agent = await withIdentity(mySuperAGIAgent, {
  policy: {
    // Per-tool quotas
    tools: {
      search: { maxCalls: 200, monthlyBudget: 50 },
      code_executor: { maxCalls: 50, requiresApproval: true },
      file_writer: { maxCalls: 30, requiresApproval: true }
    }
  }
});

// Policy violations return RFC 7807 errors
try {
  await agent.run(task);
} catch (error) {
  console.log(error.type); // "https://private.me/errors/tool-quota-exceeded"
}

Resources

Full Documentation → SuperAGI Comparison Example → xBind Core Concepts → xDebug: Debug Agent Calls → xRegistry: Service Discovery →