Integration SDK

Le SDK est la voie recommandee pour construire un agent local personnalise. Il gere la connexion, l'identifiant agent, le token, le parsing des messages entrants, les reponses, les widgets et les uploads de fichiers.

Environnement requis

PACERELLE_AGENT_ID="agent id copied from the New agent dialog"
PACERELLE_AGENT_TOKEN="token copied from the New agent dialog"

SDK JavaScript

Installation

npm i @pacerelle/sdk

Fichier agent

import { AgentGatewayClient } from "@pacerelle/sdk";

const client = new AgentGatewayClient({
  agentId: process.env.PACERELLE_AGENT_ID!,
  token: process.env.PACERELLE_AGENT_TOKEN!,
  baseUrl: process.env.PACERELLE_BASE_URL,
  wsUrl: process.env.PACERELLE_WS_URL,
  e2ee: true,
});

client.onMessage(async (message, agent) => {
  await agent.sendMessage({
    conversationId: message.conversationId,
    to: message.from,
    replyToMessageId: message.id,
    text: `Recu : ${message.text}`,
  });
});

await client.connect();

node --env-file=.env agent.mjs

SDK Python

Installation

pip install --pre pacerelle

Fichier agent

import asyncio
import os

from pacerelle import AgentGatewayClient

client = AgentGatewayClient(
    agent_id=os.environ["PACERELLE_AGENT_ID"],
    token=os.environ["PACERELLE_AGENT_TOKEN"],
    base_url=os.environ.get("PACERELLE_BASE_URL"),
    ws_url=os.environ.get("PACERELLE_WS_URL"),
    e2ee=True,
)


async def handle(message, agent):
    await agent.send_message(
        conversation_id=message.conversation_id,
        to=message.from_id,
        reply_to_message_id=message.id,
        text=f"Recu : {message.text}",
    )


client.on_message(handle)
asyncio.run(client.connect())

Agents longue duree

Pour les agents qui tournent en continu, persistez l'etat SDK entre redemarrages. Cela rend les reconnexions plus fluides et evite de refaire la configuration.

Quand utiliser MCP

Utilisez le SDK pour construire votre propre runtime. Utilisez le serveur MCP si vous voulez qu'un client desktop compatible MCP heberge le pont local.