AiSwiftAssist

AISwiftAssist

Eine Swift Package Manager (SPM)-Bibliothek für iOS 13 und höher, die die Integration mit der Assistants-API von OpenAI in iOS-Anwendungen vereinfachen soll. Mit dieser Bibliothek können Sie KI-gestützte Assistenten effizient und interaktiv erstellen.

Merkmale

• Nahtlose Integration mit der Assistants API von OpenAI.
• Erstellen und verwalten Sie ganz einfach KI-Assistenten mit verschiedenen Modellen und Tools.
• Behandeln Sie Konversationen über Threads und Nachrichten.
• Nutzen Sie Code-Interpreter-, Retrieval- und Funktionsaufruf-Tools.
• Optimiert für iOS 13+ mit Swift.

Installation

Verwenden von Xcode

Um AISwiftAssist zu Ihrem Xcode-Projekt hinzuzufügen, führen Sie die folgenden Schritte aus:

1. Öffnen Sie Ihr Projekt in Xcode.
2. Klicken Sie in der Menüleiste auf „Datei“, wählen Sie dann „Swift-Pakete“ und dann „Paketabhängigkeit hinzufügen …“
3. Geben Sie im angezeigten Dialogfeld die Paket-Repository-URL ein: https://github.com/DeveloperZelentsov/AiSwiftAssist.git .
4. Wählen Sie die letzte zu integrierende Version und klicken Sie auf „Weiter“.
5. Bestätigen Sie die Paketprodukte und -ziele und klicken Sie auf „Fertig stellen“.

Verwendung

Schritt 1: Importieren Sie die Bibliothek

Importieren Sie AISwiftAssist in Ihre Swift-Datei, wo Sie es verwenden möchten:

import AISwiftAssist

Schritt 2: Initialisieren Sie den Client

Erstellen Sie eine Instanz von AISwiftAssistClient mit Ihrem API-Schlüssel und Ihrer Organisations-ID:

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

Schritt 3: Erstellen Sie einen Assistenten

Um einen KI-Assistenten zu erstellen, definieren Sie dessen Parameter wie Modell, Name, Beschreibung und Anweisungen. Bei Bedarf können Sie auch Tools und Datei-IDs angeben:

 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

Schritt 4: Gespräche verwalten

Senden von Nachrichten

Senden Sie über einen erstellten Thread eine Nachricht an Ihren Assistenten:

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

Einen Lauf starten

Um die Nachricht zu verarbeiten und eine Antwort zu erhalten, initiieren Sie einen Lauf:

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

Antworten abrufen

Rufen Sie die Antwort des Assistenten ab:

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

Schritt 5: Kontinuierliche Interaktion

Setzen Sie die Konversation fort, indem Sie zusätzliche Nachrichten senden, Ausführungen initiieren und Antworten abrufen. Dadurch entsteht ein dynamischer und interaktiver Kommunikationsfluss mit dem Assistenten.

Über die Grundlagen hinaus

Dies ist ein Beispiel für die grundlegendste Verwendung der Assistants-API. Es besteht Potenzial für viel komplexere und interessantere Assistenten, und ich werde diese Swift-API weiterentwickeln, damit Sie diese erweiterten Funktionen nutzen können.

Feedback und Beiträge

Wir freuen uns über Ihr Feedback und Ihre Beiträge zur Verbesserung AISwiftAssist . Bitte melden Sie Probleme oder senden Sie Pull-Requests in unserem GitHub-Repository.

Lizenz

Diese Bibliothek wird unter der MIT-Lizenz vertrieben.