KI, HTTP und Werkzeuge

Diese Seite fasst APIs zusammen, die Guida-Skripte mit lokalen Modellen, HTTP-Diensten, Zugangsdaten und Werkzeugkontext verbinden.

Lokale LLMs

g.llm.promptLocalLlm(model, prompt, options?) sendet einen Prompt an den konfigurierten lokalen Provider.

async function main() {
  const response = await g.llm.promptLocalLlm(
    "llama3.2",
    "Fasse diesen Text in einem Satz zusammen: " + pageText
  );
  g.log(response);
}

Optionen können ein Timeout oder ein base64-kodiertes Bild für Vision-Modelle enthalten.

Methode	Zweck
g.llm.promptLocalLlm(model, prompt, options?)	Lokales Modell fragen
g.llm.abortLocalLlm()	Laufenden LLM-Aufruf abbrechen
g.llm.getLocalLlmModels()	Verfügbare Modelle listen

Details zur Einrichtung stehen unter LLM-Einrichtung.

HTTP-Client

g.http.makeHttpRequest() sendet HTTP-Anfragen aus Skripten. Das ist nützlich für APIs, Webhooks oder eigene Werkzeuge.

const response = await g.http.makeHttpRequest({
  url: "https://api.example.com/data",
  method: "GET",
  headers: {
    "Accept": "application/json"
  }
});

g.log("Status: " + response.statusCode);

Eigene MCP-Werkzeuge können Header-Vorlagen mit Zugangsdaten verwenden; Guida setzt die Werte bei der Ausführung ein.

Zugangsdaten

g.secrets.getSecret(name) liest verschlüsselte Zugangsdaten für vom Benutzer gestartete Skripte:

const token = await g.secrets.getSecret("API_TOKEN");

const response = await g.http.makeHttpRequest({
  url: "https://api.example.com/data",
  headers: {
    "Authorization": "Bearer " + token
  }
});

Skripte mit MCP-Herkunft dürfen g.secrets.getSecret() nicht verwenden. Das gilt auch für externe Datenbankintegrationen, die intern Zugangsdaten auflösen.

Werkzeugkontext

Eigene Werkzeuge, die über MCP gestartet werden, lesen ihre Parameter aus g.tool.args:

async function main() {
  const query = g.tool.args.query;
  return { query, receivedAt: new Date().toISOString() };
}

Werkzeuge werden in tools.json beschrieben. Siehe Eigene Werkzeuge.

Text-to-Speech

Guida kann Text über die Windows-Sprachausgabe sprechen:

await g.tts.speak("Verarbeitung abgeschlossen");

Standardstimme und Geschwindigkeit werden unter Settings > TTS konfiguriert. Skripte können pro Aufruf Optionen wie Stimme und Geschwindigkeit überschreiben.

Scripting-Unterstützungsdateien

Für Editor- und LLM-Kontext nutzen Sie in Guida Tools > Developer > Generate Scripting Support Files…. Der Dialog erzeugt TypeScript-Definitionen, Lua-/Janet-Hinweise und Arbeitsbereichsdateien für lokale Entwicklungswerkzeuge.

g.generateApiDocs() ist ein fortgeschrittener helper nur für TypeScript (advanced TypeScript-only helper) und sollte nicht der normale Arbeitsablauf sein; verwenden Sie für die praktische Erzeugung die Oberfläche Generate Scripting Support Files.

Nächste Schritte

• LLM-Einrichtung - lokale Modelle konfigurieren
• Zugangsdaten - DPAPI-verschlüsselte Werte verwalten
• Eigene Werkzeuge - MCP-Werkzeuge mit Parameterschema
• Datenbankintegrationen - Zugangsdaten für externe Systeme nutzen