Yapay Zeka Ajanı

TsgcAIAgent, Delphi 7 ile 13 uygulamanızı ajan kullanımına hazır hale getirir. Ona bir TsgcAIChat ve araçlarınızı verin, Run metodunu çağırın; istemi araçlarla birlikte gönderir, modelin istediği her araç çağrısını çalıştırır, sonuçları geri gönderir ve nihai yanıtı döndürür.

TsgcAIAgent

Bir yapay zeka modelinin araç döngüsü, sizin yerinize çözülmüş halde. Yerel araçlar, kendi nesnelerinizin metotları ve MCP sunucularınızın araçları modele sunulur; her çağrı denetlenir, gerektiğinde onaylanır ve çalıştırılır; döngü yanıtta, bir adım sınırında, belirteç sınırında, bir iptalde veya bir hatada durur.

Bileşen sınıfı

TsgcAIAgent

Amaç

Her LLM sağlayıcısı için araç çağıran ajan

Platformlar

Windows, macOS, Linux, iOS ve Android

Sürümler. TsgcAIAgent sgcAI, sgcWebSockets Enterprise ve All-Access sürümlerinde bulunur, yani TsgcAIChat ile aynı sürümlerde. 2026.11.0 sürümünde yeni. sgcAI kendi başına yeterlidir: bileşenin üzerine kurulduğu sgcWebSockets Core çalışma zamanını da içerir. Delphi 7 ile Delphi 13 ve C++ Builder için kullanılabilir.

Modelin araçlarınızı kullanmasına izin verin

Sohbeti atayın, parametreleri ve işleyicisiyle bir araç ekleyin, Run metodunu çağırın. Veriyi değiştiren araçlar önce onay ister.

uses
  sgcAI, sgcAI_Chat, sgcAI_Agent;

procedure TForm1.AskAgent;
var
  oTool: TsgcAIAgentTool;
  vAnswer: string;
begin
  sgcAIChat1.Provider := aicpAnthropic;
  sgcAIChat1.ChatOptions.ApiKey := 'sk-ant-...';
  sgcAIChat1.ChatOptions.Model := 'claude-opus-5-5';

  sgcAIAgent1.Chat := sgcAIChat1;
  // optional: the tools of an MCP server are offered too
  sgcAIAgent1.MCPClients.Add(sgcWSAPIClient_MCP1);
  oTool := sgcAIAgent1.Tools.Add('get_weather', 'Current weather of a city');
  oTool.AddParam('city', aatpString, 'City name');
  oTool.ReadOnly := True;
  oTool.OnExecute := DoGetWeather;
  sgcAIAgent1.Options.MaxSteps := 8;
  sgcAIAgent1.OnToolApproval := DoToolApproval;

  vAnswer := sgcAIAgent1.Run('Do I need an umbrella in Paris today?');
  Memo1.Lines.Add(vAnswer);
end;

procedure TForm1.DoGetWeather(Sender: TObject; const aArguments: string;
  var aResult: string);
begin
  // aArguments is a JSON object, for example {"city":"Paris"}
  aResult := '{"city":"Paris","celsius":18,"sky":"rain"}';
end;

procedure TForm1.DoToolApproval(Sender: TObject; const aToolName,
  aArguments: string; var aApproved: Boolean);
begin
  // tools that are not ReadOnly ask before they run
  aApproved := MessageDlg('Run ' + aToolName + ' ' + aArguments + '?',
    mtConfirmation, [mbYes, mbNo], 0) = mrYes;
end;

Temel özellikler & yöntemler

En sık başvuracağınız üyeler.

Run ve Cancel

Run(aPrompt) istemi araçlarla birlikte gönderir, her adımın çağrılarını çalıştırır ve nihai yanıtı döndürür. Cancel, bir çalışmayı bir sonraki model isteğinden veya araçtan önce durdurur. Running, StepCount ve StopReason nasıl bittiğini bildirir: aasrCompleted, aasrMaxSteps, aasrCancelled, aasrError veya aasrMaxTokens. aasrMaxTokens, bir yanıtın belirteç sınırında kesildiği anlamına gelir ve kesilen bir yanıtın araç çağrıları, bağımsız değişkenleri eksik olabileceği için çalıştırılmaz.

Araçlar

Tools.Add(Name, Description) bir araç döndürür. Argümanlarını AddParam ile (string, integer, number, boolean, array veya object) ya da InputSchema içindeki ham bir JSON Schema ile tanımlayın ve OnExecute içinde yanıtlayın. Tools.AddMethod, Delphi 2010 ve sonrasında bir nesnenin public metodunu araca dönüştürür. İşleyicisi olmayan bir araç OnToolCall olayına ulaşır.

MCP araçları

TsgcWSAPIClient_MCP istemcilerini MCPClients listesine ekleyin. Options.ImportMCPTools ile ajan her istemciyi başlatır, araçlarını sayfa sayfa listeler ve CallTool üzerinden çağırır. MCP araç sabitlemesi tarafından engellenen bir araç asla sunulmaz ve aynı ada sahip yerel araç önceliklidir.

Onay

ReadOnly işaretli bir araç hemen çalışır. Diğer her araç önce OnToolApproval olayına sorar. Reddedilen veya bilinmeyen bir araç modele hata metni olarak geri gider, böylece konuşma geçmişi her zaman geçerli kalır. Araçlara ada göre izin vermek, onları yasaklamak veya onay istemek için sohbete bir TsgcAIGuardrails atayın.

Seçenekler

Options.MaxSteps (varsayılan 10) bir çalışmanın model isteklerini sınırlar. İzin verilen son isteğin araçları yine de çalışır ve sonuçları saklanır, böylece sonraki bir Run gerçek sonuçlarla devam eder. Options.ImportMCPTools MCP içe aktarımını açar veya kapatır.

Olaylar

OnStep her adımı bildirir: model metni, araç çağrısı, araç sonucu, reddedilen araç ve nihai yanıt. OnUsage çalışmadaki her model isteğinin belirteçlerini bildirir. Maliyetlerini hesaplamak için sohbete bir TsgcAIUsageMeter atayın.

Her sağlayıcı

Ajan, TsgcAIChat bileşeninin her sağlayıcısıyla çalışır: OpenAI, Anthropic, Gemini, DeepSeek, Ollama, Grok ve Mistral, her biri kendi araç çağırma biçiminde. Sohbetin fallback ayarlarıyla, bir sağlayıcı başarısız olduğunda çalışma sıradaki sağlayıcıda devam eder.

Spesifikasyonlar & referanslar

Bu bileşenin kullandığı hizmet ve protokoller için yetkili kaynaklar.

Keşfetmeye devam edin

Çevrimiçi yardımsgcAI bileşenleri için tam API referansı ve kullanım kılavuzu.
Tüm sgcAI BileşenleriHer sgcAI bileşeninin özellik matrisine göz atın.
Ücretsiz Deneme Sürümünü İndirinKendi API anahtarlarınızla deneyin.
FiyatlandırmaSingle, Team ve Site lisansları, tam kaynak kodu.
En avantajlı seçenek: All-AccessTüm eSeGeCe ürünleri, Premium Destek dahil, yılda €1,059'dan itibaren.
All-Access fiyatlarına bakın

Başlamaya Hazır mısınız?

Ücretsiz deneme sürümünü indirin ve bir dil modelinin Delphi uygulamanızın işlevlerini çağırmasına izin verin.