Démarrage rapide

Installez Rikoo, connectez un fournisseur de modèles, construisez et publiez un agent dans le Studio, puis exposez-le sur votre site ou par l'API publique.

Ce qu'il vous faut

Une machine ou un cluster Kubernetes pour héberger Rikoo, et l'accès à un modèle : une clé d'API chez un fournisseur hébergé, ou un serveur compatible OpenAI comme Ollama ou vLLM.

Préparer le Studio

1. Installer Rikoo

L'installation est décrite dans les guides d'auto-hébergement : Docker Compose fait tout tourner sur une machine, et Kubernetes (Helm) déploie sur un cluster. Revenez ici quand le Studio répond à PUBLIC_URL, l'adresse publique de votre instance (http://localhost:3000 avec les valeurs par défaut de Compose).

2. Créer le premier compte

Ouvrez PUBLIC_URL et inscrivez-vous. Tant que l'instance n'a aucune organisation, le premier compte peut s'inscrire et en créer une, dont il devient propriétaire. Ensuite, par défaut, on rejoint l'instance sur invitation (voir Rôles et permissions). L'édition Community contient une seule organisation, et le serveur refuse d'en créer une seconde.

3. Utiliser le premier projet

Créer l'organisation crée aussi un premier projet, dont vous êtes propriétaire. Un projet est l'espace de travail d'une équipe, avec ses propres agents, collections de connaissances, serveurs MCP, skills, clés d'API et membres. Pour en ajouter un, utilisez Nouveau projet sur l'écran Organisation.

4. Connecter un fournisseur de modèles

Ouvrez LLM APIs, cliquez sur Ajouter un provider, choisissez le fournisseur, collez sa clé d'API et cliquez sur Connecter le provider. La clé est scellée dans le coffre de secrets et le Studio ne l'affiche plus jamais. Le worker teste ensuite la connexion et découvre les modèles servis par le fournisseur, qui deviennent disponibles pour vos agents. Connecter un fournisseur demande le rôle Admin ou Propriétaire.

5. Construire l'agent et enregistrer une version

Ouvrez Agents et cliquez sur Nouvel agent. Dans Config, écrivez les instructions et choisissez le modèle principal et, si besoin, des modèles de repli chez d'autres fournisseurs. Attachez une collection de connaissances dans Knowledge et accordez des outils dans Tools si l'agent en a besoin. Enregistrer une version fige la configuration dans une version numérotée et immuable. Essayez-la dans Playground, qui exécute n'importe quelle version enregistrée et tient ces exécutions à l'écart des métriques de production.

6. Publier

Dans l'onglet Deploy de l'agent, choisissez l'environnement dans le sélecteur en haut de la page (Test ou Production) et activez au moins une surface : le widget depuis Configurer le widget →, ou l'interrupteur API headless. Slack ne répond qu'en Production. Cliquez ensuite sur Publier…, sélectionnez la version, choisissez l'environnement sous Déployer cette version sur et cliquez sur Déployer. La version est épinglée sur toutes les surfaces actives de cet environnement, et les exécutions déjà démarrées gardent la version avec laquelle elles ont démarré. Voir Environnements.

Exposer l'agent

Le widget et l'API publique atteignent chacun la version publiée dans un environnement.

<!-- one script tag; the allowed origins are enforced server-side -->
<script src="$PUBLIC_URL/widget/widget.js"
        data-rikoo-token="rk_wgt_..." defer></script>

Dans l'onglet Deploy, Configurer le widget → réunit le design, les origines autorisées, le jeton et ce snippet pour l'environnement sélectionné. Le jeton rk_wgt_ désigne un déploiement : l'agent, la surface et l'environnement. Détails dans Widget et SDK JavaScript.

# a key with the full scope; its prefix (rk_test_ or rk_live_) selects the environment
curl -X POST "$PUBLIC_URL/api/v1/agents/$AGENT_ID/conversations" \
  -H "Authorization: Bearer $RIKOO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"message":"My invoice is wrong","sync":true}'

Configurer l'API →, dans le même onglet, affiche le point d'accès, où $AGENT_ID est l'UUID de l'agent, et crée une clé limitée à cet agent et à l'environnement sélectionné. Sa valeur n'est affichée qu'une fois. Avec sync, l'appel attend l'exécution et renvoie la réponse. Sans lui, l'appel renvoie aussitôt les identifiants de la conversation et de l'exécution, et la réponse arrive en flux SSE depuis /api/v1/agents/{agentId}/conversations/{conversationId}/runs/{runId}/stream. La page API publique couvre le reste.

L'exécution apparaît ensuite sous Surveillance → Traces avec sa version, ses appels de modèle et d'outils, ses jetons et son coût. Si l'exploitant a configuré un collecteur OpenTelemetry, la trace y est aussi exportée.

• Concepts fondamentaux : organisation, projet, agent, version et exécution, les cinq mots que le reste de la documentation suppose acquis.
• Auto-hébergement : ce qui tourne, quelle édition choisir et comment la déployer.