Airweave : permettre aux applications d'intégrer rapidement des bases de connaissances pour une recherche intelligente

Introduction générale

Airweave est un outil open source conçu pour rendre n'importe quelle application interrogeable en synchronisant les données de l'application de l'utilisateur, les API, les bases de données et les sites Web avec des bases de données graphiques et vectorielles. Airweave a été conçu dans le but de fournir une solution simple, évolutive et transparente qui permet aux utilisateurs d'effectuer facilement des recherches sémantiques dans leurs données.

Liste des fonctions

• Synchronisation des données : permet de synchroniser les données des applications, des API, des bases de données et des sites web des utilisateurs avec les bases de données cartographiques et vectorielles.
• Intégration de sources de données multiples : prise en charge de plus de 20 types d'intégration de sources de données, en constante augmentation.
• Prise en charge des bases de données vectorielles : les instances Weaviate sont utilisées par défaut, mais les utilisateurs peuvent également configurer leurs propres bases de données vectorielles.
• Configuration sans code : les utilisateurs peuvent rendre les applications consultables en quelques clics sans écrire de code.
• Traitement asynchrone : prend en charge le traitement asynchrone de la synchronisation des données à grande échelle.
• Open source core : la fonction principale de l'open source, l'avenir fournira des fonctions commerciales plus avancées.

Utiliser l'aide

Processus d'installation

1. Entrepôt de clonage :

   git clone https://github.com/airweave-ai/airweave.git
cd airweave

2. En marche :

   chmod +x start.sh
./start.sh

Après avoir exécuté la commande ci-dessus, Airweave démarrera localement.

Processus d'utilisation

Utilisation frontale

1. entretiens Réagir UI : Ouvrez votre navigateur et visitez http://localhost:8080.
2. Ajouter une nouvelle source de données : Accédez à la page "Sources" et ajoutez une nouvelle source de données.
3. Configurer un calendrier de synchronisation : configurez ou affichez un calendrier de synchronisation sur la page Calendrier.
4. Surveiller les tâches de synchronisation : Surveiller l'état des tâches de synchronisation sur la page Travaux.

Utilisation de l'API

1. Pour accéder à la documentation Swagger : Ouvrez un navigateur et visitez le site http://localhost:8001/docs Consulter la documentation de l'API.
2. Obtenir toutes les sources de données :

   GET /sources

3. Se connecter à la source de données :

   POST /connections/{short_name}

Configuration avancée

• Configuration d'une base de données vectorielle personnalisée : les utilisateurs peuvent configurer leur propre base de données vectorielle dans l'interface utilisateur de l'application ou via l'API.
• Client asynchrone : Airweave fournit un client asynchrone qui prend en charge les appels non bloquants à l'API.

  import asyncio
from airweave import AsyncAirweaveSDK
client = AsyncAirweaveSDK(api_key="YOUR_API_KEY", base_url="https://yourhost.com/path/to/api")
async def main():
await client.api_keys.create_api_key()
asyncio.run(main())

Gestion des exceptions

L'exception ApiError est déclenchée lorsque l'API renvoie un code d'état non satisfaisant (réponse 4xx ou 5xx).

from airweave.core.api_error import ApiError
try:
client.api_keys.create_api_key()
except ApiError as e:
print(e.status_code)
print(e.body)

tentative automatique

Le SDK est configuré avec un mécanisme de tentatives automatiques et le nombre de tentatives par défaut est de 2. Les utilisateurs peuvent utiliser la fonction max_retries permet de configurer le comportement des tentatives.

client.api_keys.create_api_key(..., request_options={"max_retries": 1})

réglage du délai d'attente

Le délai par défaut du SDK est de 60 secondes, et les utilisateurs peuvent configurer le délai au niveau du client ou de la requête.

client = AirweaveSDK(..., timeout=20.0)
client.api_keys.create_api_key(..., request_options={"timeout_in_seconds": 1})

Clients sur mesure

Les utilisateurs peuvent remplacer le client httpx pour répondre à des besoins spécifiques tels que les proxys et les transports.

import httpx
from airweave import AirweaveSDK
client = AirweaveSDK(
...,
httpx_client=httpx.Client(proxies="http://my.test.proxy.example.com", transport=httpx.HTTPTransport(local_address="0.0.0.0")),
)