Pour les développeurs

Vos agents, appelables depuis votre code.

Listez vos agents et écrivez-leur, lancez des complétions de chat, générez des embeddings et cherchez dans vos dossiers de connaissances, le tout en REST. Tout ce qu'un agent sait dans l'application, il le sait aussi via l'API.

request.sh
POST /v1/chatPOST /v1/knowledge/queryGET /v1/agents
$
POST /v1/chatAuthorization: Bearer ••••

Les endpoints.

Peu nombreux, et c'est voulu. Chaque route listée ici est en service.

GET/v1/meInspecter la clé : espace de travail, utilisateur, rôle
GET/v1/agentsLister les agents visibles par votre clé, page par page
GET/v1/agents/{id}Récupérer le nom, la description et le modèle d'un agent
POST/v1/agentsCréer un agent
POST/v1/agents/{id}/messagesEnvoyer un message à un agent et obtenir sa réponse
POST/v1/chatChat en un seul appel ; passez agentId pour choisir l'agent
POST/v1/chat/completionsComplétions de chat (pas encore de streaming ni d'appels d'outils)
POST/v1/embeddingsGénérer des embeddings avec le fournisseur configuré
POST/v1/knowledge/queryChercher dans vos dossiers de connaissances

Envoyez un en-tête Idempotency-Key avec n'importe quel POST pour réessayer sans risque de doublon.

Bâti sur des standards ouverts.

REST pour votre code, A2A pour les autres agents, MCP pour les autres outils.

Les agents en REST

Écrivez à n'importe quel agent de l'espace de travail depuis vos propres logiciels. Mêmes instructions, mêmes connaissances et mêmes outils que dans l'application.

API des agentsAnalyste clientsPOST /v1/agents/{id}/messages
const id = "agent-3f9c2a17b04e6d58";
const res = await fetch(
`${BEAM_URL}/v1/agents/${id}/messages`, {
method: "POST",
headers: {
Authorization: `Bearer ${BEAM_KEY}` },
body: JSON.stringify({
message: ""
})
});
node agent.mjs

A2A et MCP

Chaque agent est un endpoint JSON-RPC Agent-to-Agent, et Beam sert aussi de serveur MCP au reste de vos outils.

A2AMCP
Un autre agent envoie une tâcheJSON-RPC 2.0
POST/api/a2a/agent-3f9c…

Questions & réponses.

Une surface REST volontairement réduite, et honnête, sur votre espace de travail : listez vos agents et écrivez-leur, lancez des complétions de chat, générez des embeddings et cherchez dans vos dossiers de connaissances. Tout ce qu'un agent sait (instructions, connaissances, outils) vaut aussi pour les appels d'API.