UIP-Agent-Kontext

uip agent context verwaltet Kontextressourcen in einem Agent-Projekt – die RAG-Indexbindungen (Retrieval-Augmented Generation), die der Agent zur Runtime abfragt. Jeder Kontext ist ein benannter Verweis auf einen Index sowie ein Abrufmodus und Bewertungsparameter. Der Befehl schreibt direkt in das Agent-Projekt auf der Festplatte (rein lokal – keine Anmeldung erforderlich).

Zusammenfassung

uip agent context add    <name> --index <indexName>
                                [--retrieval-mode <mode>] [--threshold <n>] [--result-count <n>]
                                [--path <dir>]
uip agent context list                                    [--path <dir>]
uip agent context remove <name>                           [--path <dir>]

Alle uip agent context -Unterbefehle berücksichtigen die globalen Optionen (--output, --output-filter, --log-level, --log-file). Austrittscodes folgen dem Standardvertrag.

UIP-Agent-Kontext hinzufügen

Fügen Sie dem Agent eine RAG-Kontextressource hinzu.

Argumente

• <name> (erforderlich) – Name der Kontextressource. Wird für die spätere Entfernung verwendet (context remove <name>).

Optionen

Markieren	Standard	Erforderlich	Zweck
--index <indexName>	–	ja	Indexname, von dem abgerufen werden soll.
--retrieval-mode <mode>	semantic		Abrufmodus. Einer von: semantic, structured, deeprag, batchtransform.
--threshold <n>	0		Schwellenwert für die Abrufpunktzahl (numerisch). Werte unter diesem Grenzwert werden verworfen.
--result-count <n>	3		Anzahl der Ergebnisse, die pro Abfrage abgerufen werden sollen (Integer).
--path <path>	.		Pfad zum Agent-Projektverzeichnis.

Ungültige numerische Eingaben für --threshold oder --result-count schlagen mit einem Validierungsfehler fehl.

Beispiele

# Semantic RAG with defaults (threshold 0, 3 results)
uip agent context add KnowledgeBase --index docs-index --path ./my-agent

# Tighter recall: higher threshold, more results
uip agent context add KnowledgeBase \
  --index docs-index \
  --retrieval-mode semantic \
  --threshold 0.7 \
  --result-count 5

# Structured retrieval over a different index
uip agent context add Tickets \
  --index ticket-index \
  --retrieval-mode structured

Datenform (--output json)

{
  "Code": "AgentContextAdd",
  "Data": {
    "Status": "Context added",
    "Name": "KnowledgeBase",
    "Index": "docs-index",
    "Mode": "semantic",
    "Id": "a1b2c3d4-0000-0000-0000-000000000010"
  }
}

Id ist eine generierte UUID, die in die Ressource gestempelt wurde. Verwenden Sie entweder Name oder Id mit context remove.

Kontextliste des Agents

Listen Sie die für den Agent konfigurierten Kontextressourcen auf.

Optionen

Markieren	Standard	Zweck
--path <path>	.	Pfad zum Agent-Projektverzeichnis.

Beispiel

uip agent context list --path ./my-agent

Datenform (--output json)

{
  "Code": "AgentContextList",
  "Data": [
    {
      "Name": "KnowledgeBase",
      "Index": "docs-index",
      "Mode": "semantic",
      "Id": "a1b2c3d4-0000-0000-0000-000000000010"
    }
  ]
}

Leere Projekte geben Data: { "Message": "No contexts configured" } zurück.

UIP-Agent-Kontext entfernen

Eine Kontextressource entfernen.

Argumente

• <name> (erforderlich) – Kontextname oder ID.

Optionen

Markieren	Standard	Zweck
--path <path>	.	Pfad zum Agent-Projektverzeichnis.

Beispiel

uip agent context remove KnowledgeBase --path ./my-agent

Datenform (--output json)

{
  "Code": "AgentContextRemove",
  "Data": {
    "Status": "Context removed",
    "Name": "KnowledgeBase"
  }
}

Ein fehlender Kontext schlägt mit Context "<name>" not found und Exitcode 1 fehl.

Zugehörig

• uip agent tool – fügen Sie andere Ressourcenarten hinzu (IS-Integrationen, Prozesse usw.).
• uip agent escalation – HITL-/Eskalationsressourcen.
• uip agent validate – Nach Batch-Bearbeitungen erneut ausführen, um die Ressourcenintegrität zu bestätigen.

Siehe auch

• Konzepte: Fähigkeiten – wie Ressourcen mit dem Fähigkeitsmodell verbunden sind.
• Globale Optionen, Exitcodes.