OpenServ Agent SDK

Ce qu'il fait

L'OpenServ Agent SDK est un framework TypeScript pour construire des agents IA autonomes et non déterministes sur la plateforme OpenServ. Les agents construits avec ce SDK peuvent raisonner, prendre des décisions, collaborer avec d'autres agents, gérer des tâches, effectuer des opérations sur des fichiers et appeler des intégrations externes — le tout au sein d'un runtime structuré et fortement typé.

Crucialement, les agents peuvent consommer des serveurs MCP comme sources d'outils : configurez tout serveur MCP stdio, http ou sse dans le constructeur de l'agent et ses outils sont automatiquement enregistrés comme capacités de l'agent.

Outils

Le SDK n'est pas un serveur MCP autonome qui expose des outils ; il fournit plutôt un runtime pour construire des agents qui utilisent des serveurs MCP. Les capacités clés exposées par les agents construits avec le SDK incluent :

• addCapability / addCapabilities — enregistre des fonctions d'outils typées
• generate() — délègue l'inférence LLM au runtime OpenServ (aucune clé OpenAI requise)
• createTask / updateTaskStatus / addLogToTask — gestion complète du cycle de vie des tâches
• uploadFile / getFiles / deleteFile — opérations sur les fichiers de l'espace de travail
• getSecrets / getSecretValue — accès sécurisé aux secrets
• callIntegration — proxy d'appels vers des intégrations tierces (Twitter, GitHub, etc.)
• sendChatMessage / requestHumanAssistance — flux de chat et d'intervention humaine
• config mcpServers — enregistrement automatique des outils de serveurs MCP comme capacités d'agent

Installation

// claude_desktop_config.json — exécuter un agent personnalisé construit avec le SDK en tant que serveur MCP
{
  "mcpServers": {
    "my-openserv-agent": {
      "command": "npx",
      "args": ["-y", "my-openserv-agent-package"]
    }
  }
}

Installez le SDK dans votre projet :

npm install @openserv-labs/sdk

Hôtes supportés

Le SDK construit des serveurs d'agents basés sur HTTP déployables partout. La connectivité MCP via la config mcpServers supporte tout hôte compatible MCP.