Contexte d’agent UIP

uip agent context gère les ressources de contexte sur un projet d'agent — les liaisons d'index RAG (génération augmentée par récupération) que l'agent consultez au moment du Runtime. Chaque contexte est une référence nommée à un index, plus un mode de récupération et des paramètres de notation. La commande écrit directement dans le projet d'agent sur disque (uniquement local — aucune connexion requise).

Synthèse

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>]

Toutes les sous-commandes uip agent context respectent les options globales (--output, --output-filter, --log-level, --log-file). Les codes de sortie suivent le contrat standard.

ajout de contexte d’agent uip

Ajoutez une ressource de contexte RAG à l’agent.

Arguments

• <name> (requis) : le nom de la ressource de contexte. Utilisé pour la suppression ultérieure (context remove <name>).

Options

Drapeau	Default	Requis	Objectif
--index <indexName>	—	oui	Nom d’index à partir duquel récupérer.
--retrieval-mode <mode>	semantic		Mode de récupération. L'un des suivants: semantic, structured, deeprag, batchtransform.
--threshold <n>	0		Seuil du score de récupération (numérique). Les valeurs inférieures à ce seuil sont ignorées.
--result-count <n>	3		Nombre de résultats à récupérer par requête (entier).
--path <path>	.		Chemin d’accès au répertoire du projet d’agent.

Les entrées numériques non valides pour --threshold ou --result-count échouent avec une erreur de validation.

Exemples

# 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

Format des données (--sortie json)

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

Id est un UUID généré tamponné dans la ressource. Utilisez le Name ou le Id avec context remove

liste des contextes d’agent uip

Énumérez les ressources de contexte configurées sur l’agent.

Options

Drapeau	Default	Objectif
--path <path>	.	Chemin d’accès au répertoire du projet d’agent.

Exemple

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

Format des données (--sortie json)

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

Les projets vides renvoient Data: { "Message": "No contexts configured" }.

Suppression du contexte d’agent uip

Supprimez une ressource de contexte.

Arguments

• <name> (obligatoire) : nom ou ID du contexte.

Options

Drapeau	Default	Objectif
--path <path>	.	Chemin d’accès au répertoire du projet d’agent.

Exemple

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

Format des données (--sortie json)

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

Un contexte manquant échoue avec Context "<name>" not found et le code de sortie 1.

Associé

• uip agent tool : ajoutez d’autres types de ressources (intégrations IS, processus, etc.).
• uip agent escalation — HITL/ressources d'escalade.
• uip agent validate — réexécuté après les modifications par lot pour confirmer l'intégrité de la ressource.

Voir également

• Concepts: compétences - comment les ressources se connectent au modèle de compétence.
• Options globales, codes de sortie.