Docs / Intégration ChatGPT

Intégration ChatGPT

Connectez ChatGPT à votre base de connaissances aqoon en utilisant les GPTs personnalisés. Une fois configuré, ChatGPT peut rechercher vos documents et répondre aux questions en s'appuyant sur les connaissances de votre organisation.

Cela fonctionne avec les forfaits ChatGPT Plus, Team et Enterprise.

Étape 1 : Obtenir une clé API

  1. Allez dans Clés API et créez une nouvelle clé
  2. Choisissez Accès complet (ou limitez à des collections spécifiques)
  3. Copiez la clé — elle commence par aqn_ et ne sera plus affichée

Étape 2 : Créer un GPT personnalisé

  1. Ouvrez ChatGPT
  2. Cliquez sur votre nom → Mes GPTs → Créer un GPT
  3. Allez dans l'onglet Configurer
  4. Donnez un nom, par ex. « Assistant de connaissances »
  5. Ajoutez les instructions : 
    You are a knowledge assistant for [Your Company]. When the user asks a question, use the searchKnowledge action to find relevant documents, then answer based on the results. Always cite which document the information came from.

Étape 3 : Ajouter l'action aqoon

  1. Descendez jusqu'à Actions → Créer une nouvelle action
  2. Définissez Authentification sur Clé API, type Bearer
  3. Collez votre clé API aqn_
  4. Dans le champ Schéma, collez le schéma OpenAPI suivant :
openapi: 3.0.0
info:
  title: aqoon Knowledge Search
  description: Search your organization's knowledge base
  version: "1.0"
servers:
  - url: https://aqoon.ai
paths:
  /api/v1/search/:
    post:
      operationId: searchKnowledge
      summary: Search the knowledge base for relevant documents
      description: Returns document chunks matching the query, ranked by relevance
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                query:
                  type: string
                  description: The search query
                limit:
                  type: integer
                  description: Number of results (1-50)
                  default: 5
              required:
                - query
      responses:
        "200":
          description: Search results
          content:
            application/json:
              schema:
                type: object
                properties:
                  query:
                    type: string
                  count:
                    type: integer
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        content:
                          type: string
                        title:
                          type: string
                        document_id:
                          type: string
                        score:
                          type: number
  /api/v1/collections/:
    get:
      operationId: listCollections
      summary: List available collections
      description: Returns all collections the API key can access
      responses:
        "200":
          description: Collection list
  1. Cliquez sur Tester pour vérifier que la connexion fonctionne
  2. Cliquez sur Enregistrer (ou Publier pour partager avec votre équipe)

Étape 4 : Utilisation

Ouvrez votre GPT personnalisé et posez une question sur vos documents :

  • « Quelle est notre politique de congés ? »
  • « Résumez le dernier rapport trimestriel »
  • « Que dit l'article 12 du code du travail ? »

ChatGPT recherchera dans votre base de connaissances aqoon, récupérera les documents pertinents et répondra avec des citations.

Conseils

  • Limitez votre clé : Pour la sécurité, créez une clé API limitée avec un accès en lecture seule à des collections spécifiques, plutôt qu'une clé à accès complet.
  • Instructions système : Soyez précis sur votre organisation et le type de questions que le GPT doit traiter. Cela aide ChatGPT à formuler de meilleures requêtes de recherche.
  • Partagez avec votre équipe : Publiez le GPT personnalisé dans votre espace ChatGPT Team pour que tout le monde puisse l'utiliser.
  • Mettez à jour l'URL du serveur : Si vous utilisez une instance aqoon auto-hébergée, remplacez https://aqoon.ai dans le schéma par l'URL de votre instance.