API Agents

Documentation des endpoints pour la gestion des agents IA.

Base URL : https://api.devana.ai

📑 Table des matières

1. Authentification
2. Endpoints disponibles
3. Récupérer la liste des agents
4. Récupérer un agent (basique)
5. Récupérer un agent (détaillé)
6. Créer un agent
7. Mettre à jour un agent
8. Supprimer un agent
9. Récupérer les conversations
10. Ajouter des fichiers
11. Récupérer les tools

Authentification

Toutes les requêtes nécessitent une clé API dans le header Authorization.

Authorization: Bearer YOUR_API_KEY

Plus d'informations : OAuth 2.0

Endpoints disponibles

Endpoints

v1/agents

Récupérer la liste des agents

• URL : GET /v1/agents
• Description : Retourne la liste des agents associés à l'utilisateur.
• Réponse :

  {
    "success": true,
    "data": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "chatVersion": "string",
        "folderBaseId": "string",
        "model": "string",
        "publicChat": "boolean",
        "createdAt": "timestamp",
        "updatedAt": "timestamp",
        "folderIds" 
         
      
    
  
  

Récupérer un agent

• URL : GET /v1/agents/:id
• Paramètres :
  • id : Identifiant unique de l'agent.
• Description : Retourne les informations d'un agent spécifique.
• Réponse :

  {
    "success": true,
    "data": {
      "id": "string",
      "name": "string",
      "description": "string",
      "chatVersion": "string",
      "folderBaseId": "string",
      "model": "string",
      "publicChat": "boolean",
      "createdAt": "timestamp",
      "updatedAt" 
       
       
    
  
  

Récupérer un agent (détaillé)

• URL : GET /v1/agent/:id
• Paramètres :
  • id : Identifiant unique de l'agent (CUID).
• Description : Retourne les informations détaillées et complètes d'un agent spécifique, incluant toutes les propriétés de configuration.
• Note : Cet endpoint diffère de /v1/agents/:id en retournant l'ensemble des propriétés de l'agent, y compris les paramètres avancés de configuration.
• Réponse :

  {
    "success": true,
    "data": {
      "id": "string",
      "name": "string",
      "description": "string",
      "chatVersion": "string",
      "model": "string",
      "publicChat": "boolean",
      "createdAt" 
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
       
    
  
  

Créer un agent

• URL : POST /v1/agents
• Description : Crée un nouvel agent.
• Body :

  {
    "name": "string",
    "description": "string" | null,
    "model": "string" | null,
    "publicChat": "boolean" | null,
    "iaIdentity": "string" | null,
    "welcomeMessage": "string" | null,
    "target": "string" | null,
    "customModelId": "string" | null,
    "embedModel":  | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
  
  

Mettre à jour un agent

• URL : PUT /v1/agents/:id
• Paramètres :
  • id : Identifiant unique de l'agent.
• Body :

  {
    "name": "string" | null,
    "description": "string" | null,
    "model": "string" | null,
    "publicChat": "boolean" | null,
    "iaIdentity": "string" | null,
    "welcomeMessage": "string" | null,
    "target": "string" | null,
    "customModelId":  | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
      | 
  
  

Supprimer un agent

• URL : DELETE /v1/agents/:id
• Paramètres :
  • id : Identifiant unique de l'agent.
• Réponse :

  {
    "success": true,
    "data": {
      "message": "string"
    }
  }
  

• Erreurs possibles :
  • 400 : Requête invalide.
  • 403 : Accès non autorisé.
  • 500 : Erreur interne du serveur.

Récupérer les conversations d'un agent

• URL : GET /v1/agents/:id/conversations
• Paramètres :
  • id : Identifiant unique de l'agent.
• Description : Retourne les conversations associées à un agent spécifique.
• Réponse :

  {
    "success": true,
    "data": [
      {
        "id": "string",
        "date": "timestamp",
        "message": "string",
        "model": "string"
      }
    ]
  }
  

• Erreurs possibles :
  • 400 : Requête invalide.
  • 403 : Accès non autorisé.
  • 404 : Agent non trouvé.
  • 500 : Erreur interne du serveur.

Ajouter des fichiers à un agent

• URL : POST /v1/agents/:id/files
• Paramètres :
  • id : Identifiant unique de l'agent.
• Body :

  {
    "filesIds": ["string"]
  }
  

• Réponse :

  {
    "success": true,
    "data": ["string"]
  }
  

• Erreurs possibles :
  • 400 : Requête invalide.
  • 403 : Accès non autorisé.
  • 404 : Agent non trouvé.
  • 500 : Erreur interne du serveur.

Récupérer les tools actifs sur un agent

• URL : GET /v1/agents/:id/tools
• Paramètres :
  • id : Identifiant unique de l'agent.
• Réponse :

  {
    "success": true,
    "data": [
      {
        "id": "string",
        "name": "string",
        "description": "string",
        "url": "string",
        "method": "string",
        "advanced": "boolean",
        "authorization": "string",
        "authorizationKeyParams": "string",
        "authorizationType"