Composant Assistant OpenAI — sgcAI | eSeGeCe

Assistant OpenAI

TsgcAIOpenAIAssistant encapsule l'API OpenAI Assistants. Crée un assistant avec ses instructions et ses outils, ouvre un thread, poste des messages et lance des exécutions, bloquantes ou en streaming. File Search, Code Interpreter et tes propres fonctions se configurent comme des propriétés.

TsgcAIOpenAIAssistant

Un agent avec état sur l'API OpenAI Assistants. Le composant gère les assistants, les threads, les messages, les exécutions et les bases vectorielles, et renvoie les appels d'outils vers ton code.

Classe du composant

TsgcAIOpenAIAssistant

Rôle

Agent sur l'API OpenAI Assistants

Famille

Chat et agents

Plateformes

Win32 et Win64

sgcAI est autonome. Ce composant est livré dans sgcAI avec le runtime sgcWebSockets Core sur lequel il repose, il n'y a donc aucune licence de base à acheter.

Créer un assistant, exécuter un thread

Configure l'assistant, ouvre un thread, poste un message, exécute-le. Les exécutions en streaming déclenchent des événements au fur et à mesure que la réponse se construit.

uses
  sgcAI, sgcAI_OpenAI_Audio_Assistant;

var
  oAssistant: TsgcAIOpenAIAssistant;
  oThread: TsgcOpenAIClass_Thread;
begin
  oAssistant := TsgcAIOpenAIAssistant.Create(nil);
  oAssistant.OpenAIOptions.ApiKey := 'sk-...';

  oAssistant.AssistantOptions.Name  := 'Support Agent';
  oAssistant.AssistantOptions.Model := 'gpt-4o';
  oAssistant.AssistantOptions.Instructions.Text :=
    'Answer support questions from the product manual only.';
  oAssistant.AssistantOptions.Tools.FileSearch.Enabled := True;

  oAssistant.OnStreamMessageDelta := AssistantDelta;
  oAssistant.OnFunctionCall       := AssistantFunctionCall;

  oAssistant.CreateAssistant;
  oThread := oAssistant.CreateThread;
  oAssistant.CreateMessageText(oThread.Id, 'How do I reset the device?');
  oAssistant.CreateRunAndWait(oThread.Id, 60000, True);
end;
// includes: sgcAI.hpp, sgcAI_OpenAI_Audio_Assistant.hpp

TsgcAIOpenAIAssistant *oAssistant = new TsgcAIOpenAIAssistant(NULL);
oAssistant->OpenAIOptions->ApiKey = "sk-...";

oAssistant->AssistantOptions->Name  = "Support Agent";
oAssistant->AssistantOptions->Model = "gpt-4o";
oAssistant->AssistantOptions->Tools->FileSearch->Enabled = true;

oAssistant->OnStreamMessageDelta = AssistantDelta;
oAssistant->CreateAssistant();

TsgcOpenAIClass_Thread *oThread = oAssistant->CreateThread();
oAssistant->CreateMessageText(oThread->Id, "How do I reset the device?");
oAssistant->CreateRunAndWait(oThread->Id, 60000, true);

Propriétés et méthodes clés

Les membres que tu utilises le plus souvent.

AssistantOptions

Name, Model, Instructions, Temperature et TopP décrivent l'assistant. Tools.FileSearch, Tools.CodeInterpreter et Tools.Functions activent les outils intégrés et les tiens.

Assistants

CreateAssistant, GetAssistant et ListAssistants gèrent les définitions d'assistants sur ton compte OpenAI.

Threads et messages

CreateThread et GetThread ouvrent une conversation. CreateMessageText poste un tour et GetMessages pagine la transcription avec des arguments de limite, d'ordre et de curseur.

Exécutions

CreateRun démarre une exécution, GetRun l'interroge et CreateRunAndWait bloque jusqu'à la fin avec un délai d'attente. Chacune peut se faire en streaming.

UploadVectorStoreFile ajoute un document à une base vectorielle nommée et GetVectorStoreFiles liste ce qui s'y trouve déjà, c'est ainsi que l'assistant ancre ses réponses dans tes propres fichiers.

Événements

OnStreamMessage, OnStreamMessageDelta, OnStreamRun, OnStreamError et OnStreamDone suivent une exécution en streaming. OnFunctionCall transmet les appels d'outils à ton code.

Interface vocale

Le composant accepte aussi un lien AudioRecorder et TextToSpeech, si bien que le même assistant peut être piloté à la voix plutôt qu'au clavier.

Spécifications et références

Les sources faisant autorité pour les services et protocoles utilisés par ce composant.

Pour aller plus loin

Aide en ligneRéférence complète de l'API et guide d'utilisation des composants sgcAI.
Tous les composants sgcAIParcours la matrice complète des fonctionnalités des 15 composants.
Télécharger l'essai gratuitConstruis un assistant qui utilise des outils avec ta propre clé OpenAI.
TarifsLicences Single, Team et Site, code source complet, aucun produit de base requis.
Meilleur rapport qualité-prix : All-AccessTous les produits eSeGeCe, Support Premium inclus, à partir de €1,059/an.
Voir les tarifs All-Access

Prêt à te lancer ?

Télécharge l'essai gratuit et donne à ton application un agent équipé d'outils et de tes propres documents.