Agents hébergés | EmpirioLabs AI Docs

Les agents hébergés vous offrent un runtime d’agent privé qui se connecte à vos outils et s’exécute sur les modèles EmpirioLabs. Chaque agent est isolé, conserve son propre stockage persistant et est accessible via l’API EmpirioLabs ou depuis vos canaux connectés.

Pourquoi les agents hébergés

Vit dans vos applications

Connectez-vous à Telegram, Discord, Slack, Matrix, Teams, WhatsApp, et bien plus encore.

Utilise des outils connectés

Ajoutez Gmail, Drive, GitHub, Notion, Slack, des connecteurs MCP personnalisés, et plus encore.

Exécute le code en toute sécurité

Exécutez Python, des paquets, des commandes et des fichiers générés dans des bacs à sable isolés.

Parcourez visuellement

Ouvrez des pages web, cliquez sur vous, tapez, faites défiler et enregistrez des captures d’écran.

Génére des médias

Créez des images, des vidéos, des dialogues, de la musique, des éléments 3D, des transcriptions, et plus encore.

Modèles gérés

Utilisez les modèles EmpirioLabs, Poe ou votre propre fournisseur compatible.

OpenClaw et Hermes

OpenClaw

Un assistant populaire pour tout faire. Un défaut fort quand on veut un agent général compétent dès la sortie de la boîte.

Hermes

Un agent qui apprend et se souvient avec le temps, donc cela devient plus utile à votre équipe à mesure que vous l’utilisez.

Projets

Niveau de base

Un temps de démarrage pour un seul agent à 15 USD par mois.

Pro

Plus de ressources d’exécution et de marge de manœuvre à 30 USD par mois.

Démarrage rapide

Déploiement d’un agent

Choisissez un temps d’exécution (openclaw ou hermes) et un plan, puis déployez. La réponse inclut un agent id et un status.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "name": "My Assistant",
>     "agent_type": "openclaw",
>     "plan_slug": "hosted-agent-basic"
>   }'

Attendez qu'il fonctionne.

Interrogez l’agent jusqu’à ce que son status soit running.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Connectez-vous et utilisez-le

Envoyez un message à l’agent via l’API, ou connectez un canal et communiquez avec lui à partir de là.

Déploie et gère avec l’API

Toutes les requêtes utilisent votre clé API EmpirioLabs comme jeton porteur. L’URL de base est https://api.empiriolabs.ai, et chaque point de terminaison d’agent est sous /v1/hosted-agents.

Déploiement d’un agent

agent_type est openclaw ou hermes; plan_slug est hosted-agent-basic ou hosted-agent-pro. Par défaut, l’agent fonctionne sur des modèles EmpirioLabs; Configurez default_model pour en choisir un spécifique, ou default_provider poe ou custom de le diriger vers votre propre prestataire.

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "name": "My Assistant",
>     "agent_type": "openclaw",
>     "plan_slug": "hosted-agent-basic",
>     "default_model": "qwen3-7-plus"
>   }'

Listez vos agents

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Trouve un agent

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Envoyez un message

$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/message \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "messages": [{ "role": "user", "content": "What is on my calendar today?" }]
>   }'

Démarrez, arrêtez, redémarrez

L’action est le dernier segment de chemin: start, stop, restart ou refresh.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/restart \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Renommer un agent

$ curl -X PATCH https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "name": "Renamed Assistant" }'

Supprimer un agent

$ curl -X DELETE https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Configurez chaque réglage depuis l’API

Tout ce que vous pouvez modifier dans le tableau de bord est aussi contrôlable depuis l’API, donc vous pouvez gérer les agents entièrement de façon programmatique.

Changer de modèle ou de fournisseur

Changez le modèle de l’agent en place (pas de redéploiement). provider est empirio, poe ou custom.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/model \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "provider": "empirio", "model": "qwen3-7-plus" }'

Compétences

Les compétences sont des livres de jeu réutilisables que l’agent suit. Cherchez dans le registre officiel (OpenClaw utilise ClawHub, Hermes utilise skills.sh) et ajoutez une compétence à sa référence, ou collez la vôtre.

$ # List installed skills
$ curl https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
$ 
$ # Add an official skill (OpenClaw: clawhub:<slug>, Hermes: hermes:<id>)
$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "slug": "hermes:openai/skills/pdf" }'
$ 
$ # Add your own pasted skill
$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "custom": { "name": "House Style", "body": "Always answer in a concise, friendly tone." } }'
$ 
$ # Remove a skill
$ curl -X DELETE "https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/skills?slug=hermes:openai/skills/pdf" \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

Connecteurs (MCP)

Connectez un serveur MCP distant pour fournir à l’agent des outils et des données.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/mcp \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "name": "my-tools", "url": "https://example.com/mcp" }'

Chaînes

Connectez un canal de messagerie basé sur des jetons (par exemple telegram, discord ou slack) afin que les gens puissent parler à l’agent présent. Telegram, Discord, Slack et Matrix fonctionnent sur OpenClaw et les agents Hermès. Mattermost et Microsoft Teams sont uniquement OpenClaw. WhatsApp est associé depuis le tableau de bord à un QR code au lieu de ce token endpoint.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/integrations \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "kind": "telegram", "secret": "YOUR_BOT_TOKEN" }'

Le comportement du canal contrôle les petits signaux de chat sur chaque connecteur. Par défaut, les indicateurs de saisie et les réactions de traitement minimales sont activés, les accusés de lecture désactivés, et l’aperçu des réponses en temps réel est désactivé. L’aperçu des réponses en direct utilise un support natif de la plateforme pour l’édition ou la version preview de brouillon lorsque cela est disponible; il est distinct du streaming d’API de modèles.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/integrations/telegram/behavior \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "behavior": {
>       "reaction_level": "minimal",
>       "typing": true,
>       "read_receipts": false,
>       "streaming": false
>     }
>   }'

Qui peut envoyer un message au bot

mode est open (n’importe qui) ou restricted (seulement les identifiants de messagerie que vous autorisez). Avec restricted et sans pièce d’identité, la première personne à envoyer un message devient le propriétaire. Incluez kind pour définir la règle pour un canal connecté.

$ curl -X POST https://api.empiriolabs.ai/v1/hosted-agents/instances/AGENT_ID/access \
>   -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
>   -H "Content-Type: application/json" \
>   -d '{ "kind": "telegram", "mode": "restricted", "allow": { "telegram": ["123456789"] } }'

Tarification

Les agents hébergés sont facturés mensuellement par agent selon le forfait que vous choisissez. Le Basic coûte 15 USD par mois et le Pro 30 USD par mois. Le plan couvre le temps d’exécution de l’agent. Les modèles utilisés par l’agent sont facturés séparément aux tarifs standards des modèles.

Limites

Chaque compte peut exécuter un nombre limité d’agents déployés simultanément. Les paramètres de votre tableau de bord affichent votre limite effective. Contacte us pour augmenter ta limite.

Étiquetage blanc

Vous pouvez intégrer des agents hébergés dans votre propre produit et les gérer entièrement sous votre propre marque. L’API n’est pas marquée: vous appelez /v1/hosted-agents/* avec votre clé API EmpirioLabs et vous faites apparaître l’agent comme vous le souhaitez, afin que vos utilisateurs finaux interagissent avec votre produit, pas avec le nôtre. Il n’y a pas de marque EmpirioLabs dans les réponses API ni dans celles des agents. Pour des limites plus élevées d’agents, une capacité dédiée ou un accord commercial personnalisé, envoyez un e-mail à support@empiriolabs.ai.

Prochaines étapes

Référence API des agents hébergés

Des schémas complets de requête et de réponse pour chaque point de terminaison agent hébergé.

Modèles et prix

Parcourez les modèles que votre agent peut utiliser.