contexto de agente de uip

uip agent context los recursos de contexto en un proyecto de agente: los enlaces de índice RAG (generación aumentada por recuperación) que el agente consulta en runtime. Cada contexto es una referencia con nombre a un índice, además de un modo de recuperación y parámetros de puntuación. El comando escribe directamente en el proyecto del agente en el disco (puramente local, no es necesario iniciar sesión).

Sinopsis

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

Todos los subcomandos uip agent context respetan las opciones globales (--output, --output-filter, --log-level, --log-file). Los códigos de salida siguen el contrato estándar.

adición de contexto de agente de uip

Añade un recurso de contexto RAG al agente.

Argumentos

• <name> requerido) — Nombre del recurso de contexto. Se utiliza para su posterior eliminación (context remove <name>).

Opciones

Marca	Predeterminado	Obligatorio	Propósito
--index <indexName>	—	Sí	Nombre del índice del que recuperar.
--retrieval-mode <mode>	semantic		Modo de recuperación. Uno de: semantic, structured, deeprag, batchtransform.
--threshold <n>	0		Umbral de puntuación de recuperación (numérico). Los valores por debajo de este límite se descartan.
--result-count <n>	3		Número de resultados a recuperar por consulta (entero).
--path <path>	.		Ruta al directorio del proyecto del agente.

Las entradas numéricas no válidas para --threshold o --result-count fallan con un error de validación.

Ejemplos

# 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

Forma de datos (--json de salida)

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

Id es un UUID generado grabado en el recurso. Utiliza Name o Id con context remove.

lista de contexto del agente de uip

Enumera los recursos de contexto configurados en el agente.

Opciones

Marca	Predeterminado	Propósito
--path <path>	.	Ruta al directorio del proyecto del agente.

Ejemplo

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

Forma de datos (--json de salida)

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

Los proyectos vacíos devuelven Data: { "Message": "No contexts configured" }.

eliminación del contexto del agente uip

Eliminar un recurso de contexto.

Argumentos

• <name> obligatorio) : nombre o ID de contexto.

Opciones

Marca	Predeterminado	Propósito
--path <path>	.	Ruta al directorio del proyecto del agente.

Ejemplo

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

Forma de datos (--json de salida)

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

Un contexto faltante falla con Context "<name>" not found y el código de salida 1.

Relacionado

• uip agent tool : añade otros tipos de recursos (integraciones de IS, procesos, etc.).
• uip agent escalation — Recursos HITL/escalada.
• uip agent validate : volver a ejecutar después de las ediciones por lotes para confirmar la integridad de los recursos.

Ver también

• Conceptos: habilidades : cómo se conectan los recursos al modelo de habilidad.
• Opciones globales, códigos de salida.