AiSwiftAssist

AISwiftAssist

Une bibliothèque Swift Package Manager (SPM) pour iOS 13 et supérieur, conçue pour simplifier l'intégration avec l'API Assistants d'OpenAI dans les applications iOS. Cette bibliothèque vous permet de créer des assistants basés sur l'IA de manière efficace et interactive.

Caractéristiques

• Intégration transparente avec l'API Assistants d'OpenAI.
• Créez et gérez facilement des assistants IA avec divers modèles et outils.
• Gérez les conversations via des fils de discussion et des messages.
• Utilisez les outils d'interprétation de code, de récupération et d'appel de fonctions.
• Optimisé pour iOS 13+ avec Swift.

Installation

Utiliser Xcode

Pour ajouter AISwiftAssist à votre projet Xcode, suivez ces étapes :

1. Ouvrez votre projet dans Xcode.
2. Cliquez sur "Fichier" dans la barre de menu, puis sélectionnez "Swift Packages" puis "Ajouter une dépendance de package..."
3. Dans la boîte de dialogue qui apparaît, saisissez l'URL du référentiel de packages : https://github.com/DeveloperZelentsov/AiSwiftAssist.git .
4. Choisissez la dernière version à intégrer et cliquez sur "Suivant".
5. Confirmez les produits et les cibles du package et cliquez sur "Terminer".

Usage

Étape 1 : Importer la bibliothèque

Importez AISwiftAssist dans votre fichier Swift là où vous souhaitez l'utiliser :

import AISwiftAssist

Étape 2 : initialiser le client

Créez une instance d'AISwiftAssistClient à l'aide de votre clé API et de votre ID d'organisation :

 let config = AISwiftAssistConfig ( apiKey : " your-api-key " , organizationId : " your-org-id " )
let aiSwiftAssistClient = AISwiftAssistClient ( config : config )

Étape 3 : Créer un assistant

Pour créer un assistant IA, définissez ses paramètres tels que le modèle, le nom, la description et les instructions. Vous pouvez également spécifier des outils et des ID de fichiers si nécessaire :

 let assistantParams = AssistantCreationParams (
    modelName : " gpt-4-1106-preview " ,
    name : " Math Tutor " ,
    description : " Your personal math tutor. " ,
    instructions : " Solve math problems and explain solutions. "
)

let creationAssistantParams = try await aiSwiftAssistClient . createAssistantAndThread ( with : assistantParams )
let assistantId = creationParams . assistant . id
let threadId = creationParams . thread . id

Étape 4 : Gérer les conversations

Envoi de messages

Envoyez un message à votre assistant via un fil de discussion créé :

 let messageRequest : ASACreateMessageRequest = . init ( role : " user " , content : content )
try await aiSwiftAssistClient . messagesApi . create ( by : threadId , createMessage : messageRequest )

Lancer une course

Pour traiter le message et recevoir une réponse, lancez une exécution :

 let runRequest = ASACreateRunRequest ( assistantId : assistantId )
try await aiSwiftAssistClient . runsApi . create ( by : threadId , createRun : runRequest )

Récupération des réponses

Récupérez la réponse de l'assistant :

 let messages = try await aiSwiftAssistClient . messagesApi . list ( threadId : threadId )
// Process and display these messages, including the assistant's response.

Étape 5 : Interaction continue

Poursuivez la conversation en envoyant des messages supplémentaires, en lançant des exécutions et en récupérant des réponses. Cela crée un flux de communication dynamique et interactif avec l’assistant.

Au-delà des bases

Ceci est un exemple de l'utilisation la plus basique de l'API Assistants. Il existe un potentiel pour des assistants beaucoup plus complexes et intéressants, et je continuerai à faire évoluer cette API Swift pour vous permettre de tirer parti de ces fonctionnalités avancées.

Commentaires et contributions

Nous apprécions vos commentaires et contributions pour améliorer AISwiftAssist . N'hésitez pas à signaler des problèmes ou à soumettre des demandes d'extraction sur notre référentiel GitHub.

Licence

Cette bibliothèque est distribuée sous la licence MIT.