IR
irwinrodriguez.dev
Zuruck zur Dokumentation

Erste Schritte

Schritt 1: Uberprufen, ob der Broker lauft

Der FoxAgent-Installer hat den Broker bereits als Windows-Dienst mit automatischem Start konfiguriert. Um zu uberprufen, ob er lauft:

# In PowerShell oder CMD:
sc query FoxAgentBroker

# Sie sollten sehen: STATE: RUNNING

Wenn der Dienst nicht lauft, konnen Sie ihn uber die Windows-Dienste-Konsole (services.msc) oder mit dem Befehl starten:

# Dienst manuell starten:
net start FoxAgentBroker

Schritt 2: Ihre VFP-Anwendung verbinden

Fugen Sie in Ihrer VFP-Anwendung den folgenden Code am Anfang hinzu (z.B. in Ihrem Hauptprogramm oder im Init-Ereignis Ihres Hauptformulars):

* FoxAgent - Conexión del agente VFP
LOCAL loBridge
loBridge = CREATEOBJECT("FoxAgent.Bridge")

* 1. Establecer instancia VFP (ANTES de Connect)
loBridge.SetInstance(_VFP)

* 2. Configurar carpeta de herramientas personalizadas (UDTs)
*    Esta carpeta contiene tus herramientas que la IA podrá invocar
loBridge.SetToolsFolder("C:\MiProyecto\Tools")

* 3. Conectar al Broker
*    Parámetros: (ID único, nombre descriptivo, rol 0-3)
loBridge.Connect("mi-app-001", "Mi Aplicacion VFP", 3)

* El Bridge mantiene la conexión con heartbeats automáticos
* No necesitas llamar Heartbeat() manualmente

* IMPORTANTE: Mantén loBridge vivo mientras la app esté corriendo
* No lo liberes con loBridge = .NULL. hasta el cierre
Wichtig: SetToolsFolder Der Aufruf von SetToolsFolder() ist, wo FoxAgent seinen wahren Wert zeigt. Die benutzerdefinierten Tools (UDTs), die Sie in diesem Ordner ablegen, werden automatisch erkannt und Ihrem KI-Agenten zur Verfugung gestellt. Lesen Sie den Konfigurationsabschnitt, um zu lernen, wie Sie UDTs erstellen.

Vollstandiges Beispiel

Hier ist ein vollstandiges Beispiel, das Sie als Ausgangspunkt verwenden konnen:

* foxagent-init.prg - Inicialización de FoxAgent
* Coloca este archivo en tu proyecto y llámalo al inicio de tu app

LPARAMETERS tcAppId, tcAppName

* Valores por defecto
IF EMPTY(tcAppId)
    tcAppId = "vfp-app-001"
ENDIF
IF EMPTY(tcAppName)
    tcAppName = "Mi Aplicación VFP"
ENDIF

* Crear el Bridge
PUBLIC goFoxAgent
goFoxAgent = CREATEOBJECT("FoxAgent.Bridge")

* Inicializar
goFoxAgent.SetInstance(_VFP)

* Configurar carpeta de UDTs (ajusta la ruta a tu proyecto)
LOCAL lcToolsPath
lcToolsPath = JUSTPATH(SYS(16,0)) + "\Tools"
IF DIRECTORY(lcToolsPath)
    goFoxAgent.SetToolsFolder(lcToolsPath)
ENDIF

* Conectar al Broker (rol 3 = Admin, acceso completo)
LOCAL llOk
llOk = goFoxAgent.Connect(tcAppId, tcAppName, 3)

IF llOk
    ? "FoxAgent conectado: " + tcAppName
    ? "Versión Bridge: " + goFoxAgent.GetVersion()
ELSE
    ? "Error conectando a FoxAgent. ¿Está corriendo el Broker?"
ENDIF

RETURN llOk

Schritt 3: Mit Ihrem KI-Agenten verwenden

Sobald Ihre VFP-Anwendung mit dem Broker verbunden ist, offnen Sie Ihren bevorzugten KI-Agenten und fragen Sie nach den lebenden Instanzen:

  • Claude Desktop: Fragen Sie: "Zeige mir die verbundenen VFP-Instanzen"
  • OpenCode: Fragen Sie: "Welche FoxPro-Instanzen sind aktiv?"

Ihr KI-Agent wird die FoxAgent-Tools verwenden, um die verbundenen Instanzen aufzulisten und Variablen, Cursor, Formulare und mehr zu inspizieren.

Beispiele fur Fragen

  • "Muestrame las variables publicas de mi aplicacion VFP"
  • "Que cursores estan abiertos y cuantos registros tienen?"
  • "Toma un screenshot de mi aplicacion"
  • "Ejecuta LIST MEMORY y muestrame el resultado"
  • "Cuales son los controles del formulario activo?"

Nachste Schritte