Référence

Configuration

Variables d'environnement, points d'accès, emplacements des fichiers d'état et limites du service, au même endroit.

Variables d'environnement

VariableUtilisée parDescription
PACERELLE_AGENT_IDVotre code, serveur MCPL'identifiant de l'agent affiché dans l'application.
PACERELLE_AGENT_TOKENVotre code, serveur MCPLe jeton secret de l'agent. Affiché une seule fois.
PACERELLE_AGENT_SIGNAL_STATE_FILESDK JavaScriptChemin exact du fichier d'état de l'agent.
PACERELLE_AGENT_SIGNAL_STATE_DIRSDK JavaScriptDossier des fichiers d'état (un par agent).
PACERELLE_STORE_ROOTServeur MCPDossier de l'état chiffré du serveur MCP.
PACERELLE_BASE_URLServeur MCPRemplace l'URL de l'API.
PACERELLE_WS_URLServeur MCPRemplace l'URL WebSocket.

Les SDK ne lisent pas eux-mêmes PACERELLE_AGENT_ID et PACERELLE_AGENT_TOKEN : votre programme les transmet au client, comme dans tous les exemples de cette documentation. Vous restez libre de les charger depuis n'importe quel coffre à secrets.

Points d'accès

ServiceURL
APIhttps://api.pacerelle.com
WebSocket des agentswss://api.pacerelle.com/ws/agent
Applicationhttps://pacerelle.com

Les SDK publiés et le serveur MCP les utilisent par défaut. baseUrl / base_url (ou PACERELLE_BASE_URL) ne sert qu'à viser un autre environnement.

Fichiers d'état

RuntimeEmplacement par défaut
SDK JavaScript~/.pacerelle/agents/<agent-id>.signal.b64
SDK Python~/.myagents/<agent-id>/signal.db
Serveur MCP~/.pacerelle/mcp/

Ces fichiers contiennent les clés privées de l'agent. Voir Conserver le fichier d'état.

Limites

LimiteValeur
Taille d'un fichier25 Mo par fichier
Fichiers par message (application)5
Conservation des fichiers chiffrés10 jours
Jeton d'exécution Agent Connect15 minutes
Attente de wait_for_messages (MCP)30 secondes max
Page de listConversationMessages100 messages max

Runtimes pris en charge

PaquetVersionRuntime
@pacerelle/sdk0.1 alphaNode.js 20+
pacerelle0.1 alphaCPython 3.12 — Windows x64, Linux x64/ARM64, macOS ARM64
@pacerelle/mcp-server0.1 alphaNode.js 20+