Toutes les façons d’entrer, sur une page
Toutes les façons d’entrer dans Autonomous Relay Agents : OpenAI SDK, Vercel AI SDK, LangChain, n8n, Cursor, Cline, Continue, le lanceur relay, MCP, et les documents OpenAPI et ARD.
Autonomous Relay Agents parle le format Chat Completions d’OpenAI à une seule adresse de base : les clients, éditeurs et cadriciels que vous utilisez déjà se branchent avec une clé et une adresse. Chaque guide ci-dessous est vérifié contre la passerelle; les documents lisibles par machine sont ceux que lisent les agents et les registres.
Deux lignes amènent un client OpenAI ici
export OPENAI_BASE_URL="https://autonomousrelay.com/v1" export OPENAI_API_KEY="$AUTONOMOUSRELAY_API_KEY"
Les SDK officiels d’OpenAI pour Python et Node lisent ces deux variables quand le client est créé sans arguments. Il n’y a pas de SDK distinct à installer : ce sont les bibliothèques clientes prises en charge.
Bibliothèques clientes et cadriciels
- OpenAI SDK: Python et Node, sans changement : pointez l’adresse de base vers /v1, utilisez une clé d’inférence et nommez n’importe quel modèle du catalogue par son identifiant auteur/slug.
- Vercel AI SDK: Le fournisseur compatible OpenAI du AI SDK, créé une fois avec notre adresse de base; la diffusion, les outils et les sorties structurées fonctionnent comme avec OpenAI.
- LangChain: ChatOpenAI en Python ou en JavaScript, avec l’adresse de base et la clé définies sur le client; le reste de la chaîne ne change pas.
- n8n: Un identifiant OpenAI avec notre adresse de base, puis le nœud de modèle de conversation choisit n’importe quel modèle du catalogue.
Agents de codage, éditeurs et MCP
- Lanceur relay: Une commande lance Claude Code avec vos propres clés de fournisseur, connexion par le navigateur, chaque requête marquée dans Activité. Pas encore sur npm.
- Cursor: N’importe quel modèle du catalogue depuis la conversation et l’agent de Cursor, avec vos propres clés de fournisseur, en remplaçant l’adresse de base OpenAI.
- Cline: Un fournisseur compatible OpenAI dans les réglages de Cline : l’adresse de base, une clé et un identifiant de modèle.
- Continue: Un bloc de modèle dans config.yaml avec l’adresse de base et la clé; un bloc par modèle voulu dans la liste.
- Serveurs MCP comme outils: Enregistrez les serveurs MCP de votre organisation une fois, puis offrez leurs outils à n’importe quel modèle dans une requête avec {"type": "autonomousrelay:mcp", "server": "<nom>"}.
- Carte de serveur MCP: Les métadonnées publiques de découverte du serveur MCP de la passerelle, à /v1/mcp/server-card, telles que l’extension de carte de serveur MCP (SEP-2127) les spécifie.
Ce que la passerelle fait pour chaque requête
- Acheminement: Les préférences de fournisseur réordonnent, les contraintes rejettent, et autonomousrelay/auto choisit un modèle qui convient à la requête selon son palier de prix.
- Basculement: Une liste models de replis, essayés dans l’ordre quand le premier est en panne ou limité, pour qu’un seul point d’accès tienne quand un fournisseur ne tient pas.
- Vos propres clés: Les requêtes s’exécutent avec vos propres clés de fournisseur, au prix catalogue du fournisseur, avec 0 % de frais; la clé est stockée chiffrée.
- Garde-fous: Caviardage des renseignements personnels, listes autorisées de modèles et de fournisseurs et contraintes de région, définis par organisation et appliqués avant qu’un fournisseur voie la requête.
- Plafonds de dépense: Un plafond par clé, par agent ou par espace de travail, annoncé au passage de 50 %, 80 % et 100 %, avec un grand livre qui rapproche chaque requête au cent près.
- Exportation d’observabilité: Un enregistrement de métadonnées de chaque requête diffusé vers un webhook, OTLP, S3, Langfuse ou Datadog; les invites et les réponses n’y figurent jamais.
- API de lots: POST /v1/batches soumet des requêtes de conversation au point d’accès de lots du fournisseur à la moitié du prix synchrone, les résultats étant relus à la fin du lot.
- Cache de réponses: Un cache à correspondance exacte des complétions non diffusées, activé par clé d’inférence; un succès est servi sans appel au fournisseur ni frais, et le dit dans x-cache.
- Sorties structurées: response_format avec json_object ou json_schema est transmis au modèle, et le plugiciel response-healing répare une réponse qui aurait dû être du JSON.
- SSO et SCIM: Connexion par votre fournisseur d’identité en OIDC ou SAML 2, et sièges approvisionnés depuis votre annuaire, au forfait Affaires et au-dessus.
- Déploiement auto-hébergé: Exécutez la passerelle dans votre propre réseau ou compte infonuagique, sans aucune télémétrie vers nous.
- Fédération d’identité de charge de travail: Une tâche automatisée échange le jeton OIDC de sa plateforme contre une clé de courte durée, pour que rien de durable ne soit stocké dans l’intégration continue.
Lisible par machine, et ce qui a changé
- OpenAPI: L’API publique sous forme de document, à /openapi.json et /openapi.yaml, générée des mêmes définitions que la passerelle valide.
- Manifeste ARD: Le manifeste Agentic Resource Discovery à /.well-known/ard.json répertorie l’API, la carte de serveur MCP et la documentation pour les agents et les registres.
- llms.txt: Un index en texte brut du site pour les modèles de langage, avec chaque section de la documentation et sa description d’une ligne.
- État du service: Disponibilité et incidents, par fournisseur, avec les incidents offerts par courriel.
- Journal des modifications: Les changements datés de l’API et du tableau de bord, avec un fil RSS.