Estructura del objeto del endpoint Agents

Esta página se aplica al endpoint agents.

Ejemplo

endpoints:
  agents:
    recursionLimit: 50
    maxRecursionLimit: 100
    disableBuilder: false
    # (optional) Agent Capabilities available to all users. Omit the ones you wish to exclude. Defaults to list below.
    # capabilities: ["deferred_tools", "execute_code", "file_search", "web_search", "artifacts", "subagents", "actions", "context", "skills", "tools", "chain", "ocr"]
    # (optional) File citation configuration for file_search capability
    maxCitations: 30 # Maximum total citations in responses (1-50)
    maxCitationsPerFile: 7 # Maximum citations from each file (1-10)
    minRelevanceScore: 0.45 # Minimum relevance score threshold (0.0-1.0)
    titleTiming: immediate
    skills:
      maxCatalogSkills: 20

Esta configuración habilita la interfaz del constructor para agentes.

recursionLimit

Key	Type	Description	Example
recursionLimit	Number	Establece el número predeterminado de pasos que un agente puede realizar en una ejecución.	Controls recursion depth to prevent infinite loops. When limit is reached, raises GraphRecursionError. This value can be configured from the UI up to the maxRecursionLimit.

Predeterminado: 25

Ejemplo:

recursionLimit: 50

Para obtener más información sobre los pasos del agente, consulta Max Agent Steps.

maxRecursionLimit

Key	Type	Description	Example
maxRecursionLimit	Number	Establece el número máximo absoluto de pasos que un agente puede realizar en una ejecución.	Defines the upper limit for the recursionLimit that can be set from the UI. This prevents users from setting excessively high values.

Predeterminado: Si se omite, toma el valor de recursionLimit o 50 si recursionLimit también se omite.

Ejemplo:

maxRecursionLimit: 100

Para obtener más información sobre los pasos del agente, consulta Max Agent Steps.

titleTiming

Key	Type	Description	Example
titleTiming	String	Controla cuándo se generan los títulos de las conversaciones para el endpoint de agentes. Valores válidos: "immediate" o "final".	Defaults to "immediate".

Predeterminado: "immediate"

Valores disponibles:

"immediate": Genera el título tan pronto como comienza la solicitud, en paralelo con la respuesta del modelo, utilizando el primer mensaje del usuario.
"final": Aplaza la generación del título hasta que se complete la respuesta completa. Esto preserva el comportamiento heredado.

Ejemplo:

titleTiming: immediate

disableBuilder

Key	Type	Description	Example
disableBuilder	Boolean	Controla la visibilidad y el uso de la interfaz del constructor para agentes.	When set to `true`, disables the builder interface for the agent, limiting direct manual interaction.

Predeterminado: false

Ejemplo:

disableBuilder: false

allowedProviders

Key	Type	Description	Example
allowedProviders	Array/List of Strings	Especifica una lista de proveedores de endpoint (por ejemplo, "openAI", "anthropic", "google") que tienen permitido su uso con la función de Agents.	If defined, only agents configured with these providers can be initialized. If omitted or empty, all configured providers are allowed.

Predeterminado: [] (lista vacía, todos los proveedores permitidos)

Nota: Debe ser uno de los siguientes, o un nombre de endpoint personalizado tal como se define en su configuración: - openAI, azureOpenAI, google, anthropic, assistants, azureAssistants, bedrock

Ejemplo:

allowedProviders:
  - openAI
  - google

capabilities

Key	Type	Description	Example
capabilities	Array/List of Strings	Especifica las capacidades de agente disponibles para todos los usuarios para el endpoint de agentes.	Defines the agent capabilities that are available to all users for the agents endpoint. You can omit the capabilities you wish to exclude from the list.

Predeterminado: ["deferred_tools", "execute_code", "file_search", "web_search", "artifacts", "subagents", "actions", "context", "skills", "tools", "chain", "ocr"]

Ejemplo:

capabilities:
  - 'deferred_tools'
  - 'execute_code'
  - 'file_search'
  - 'web_search'
  - 'artifacts'
  - 'subagents'
  - 'actions'
  - 'context'
  - 'skills'
  - 'tools'
  - 'chain'
  - 'ocr'

Nota: Este campo es opcional. Si se omite, el comportamiento predeterminado es incluir todas las capacidades enumeradas en el valor predeterminado.

skills

Controla la configuración de Skills a nivel de endpoint para los agentes.

Key	Type	Description	Example
skills.maxCatalogSkills	Number	Limita el número de Skills accesibles y activas expuestas en el catálogo visible para el modelo. Debe estar entre 1 y 100.	maxCatalogSkills: 20

Predeterminado: Sin límite configurado más allá del límite del catálogo en tiempo de ejecución.

Ejemplo:

skills:
  maxCatalogSkills: 20

Esto no deshabilita Skills. Utiliza la capacidad skills y el alcance de habilidades por agente/Model Specs para controlar si las Skills están disponibles.

maxCitations

Key	Type	Description	Example
maxCitations	Number	Controla el número total máximo de citas que se pueden incluir en una sola respuesta del agente.	When using file_search capability, limits the total number of source citations returned to prevent overwhelming responses while ensuring comprehensive coverage.

Predeterminado: 30

Rango: 1-50

Ejemplo:

maxCitations: 30

maxCitationsPerFile

Key	Type	Description	Example
maxCitationsPerFile	Number	Limita el número máximo de citas que se pueden extraer de cualquier archivo individual.	Ensures citation diversity by preventing any single file from dominating the citations, encouraging representation from multiple sources.

Predeterminado: 7

Rango: 1-10

Ejemplo:

maxCitationsPerFile: 7

minRelevanceScore

Key	Type	Description	Example
minRelevanceScore	Number	Establece el umbral de puntuación de relevancia mínima para que las fuentes se incluyan en las respuestas.	Filters out low-quality matches based on vector similarity scores. Higher values (e.g., 0.7) ensure only highly relevant sources are cited, while lower values (e.g., 0.0) include all sources regardless of quality.

Predeterminado: 0.45 (umbral de relevancia del 45%)

Rango: 0.0-1.0

Ejemplo:

minRelevanceScore: 0.45

Ejemplos de configuración de citas de archivos

Configuración predeterminada (Equilibrada)

endpoints:
  agents:
    maxCitations: 30
    maxCitationsPerFile: 7
    minRelevanceScore: 0.45

Proporciona citas exhaustivas a la vez que evita respuestas abrumadoras y filtra las coincidencias de baja calidad.

Configuración estricta (Alta calidad)

endpoints:
  agents:
    maxCitations: 10
    maxCitationsPerFile: 3
    minRelevanceScore: 0.7

Solo incluye citas altamente relevantes con límites estrictos para respuestas enfocadas.

Configuración integral (Investigación)

endpoints:
  agents:
    maxCitations: 50
    maxCitationsPerFile: 10
    minRelevanceScore: 0.0

Extracción máxima de información para tareas de investigación exhaustivas, incluyendo todas las fuentes independientemente de su relevancia.

Capacidades de los agentes

El campo capabilities le permite habilitar o deshabilitar funcionalidades específicas para los agentes. Las capacidades disponibles son:

deferred_tools: Permite a los agentes descubrir herramientas MCP diferidas en tiempo de ejecución en lugar de cargar cada herramienta en el contexto por adelantado.
execute_code: Permite al agente ejecutar código.
file_search: Permite al agente buscar e interactuar con archivos. Cuando está habilitado, el comportamiento de las citas se controla mediante los ajustes maxCitations, maxCitationsPerFile y minRelevanceScore.
web_search: Habilita la funcionalidad de búsqueda web para los agentes, permitiéndoles buscar y recuperar información de internet.
artifacts: Permite al agente generar artefactos interactivos (componentes de React, HTML, diagramas Mermaid).
subagents: Habilita ejecuciones de agentes secundarios con contexto aislado. Consulta Subagents.
actions: Permite al agente realizar acciones predefinidas.
context: Habilita la funcionalidad "Subir como texto" en el chat y el "Contexto de archivo" para los agentes, permitiendo a los usuarios subir archivos y que su contenido sea extraído e incluido directamente en la conversación.
skills: Habilita Skills en el panel lateral, invocación manual mediante $, skills invocadas por el modelo y listas de permitidos de skills para agentes. Consulta Skills.
tools: Otorga al agente acceso a diversas herramientas.
chain: Habilita la función beta para el encadenamiento de agentes, también conocido como flujos de trabajo Mixture-of-Agents (MoA).
ocr: Mejora opcionalmente "Upload as Text" en el chat y "File Context" para agentes, permitiendo que los archivos sean subidos y procesados con OCR. Requiere que se configure un servicio de OCR.

Al especificar las capacidades, puedes controlar las funciones disponibles para los usuarios al interactuar con agentes.

Ejemplo de configuración

Aquí tienes un ejemplo de cómo configurar el endpoint agents con capacidades personalizadas y ajustes de citación de archivos:

endpoints:
  agents:
    disableBuilder: false
    # File citation configuration
    maxCitations: 20
    maxCitationsPerFile: 5
    minRelevanceScore: 0.6
    # Custom capabilities
    capabilities:
      - 'execute_code'
      - 'file_search'
      - 'skills'
      - 'subagents'
      - 'actions'
      - 'artifacts'
      - 'context'
      - 'ocr'
      - 'web_search'

En este ejemplo:

La interfaz del constructor está habilitada
Las citas de archivos están limitadas a un total de 20, con un máximo de 5 por archivo
Solo se incluyen las fuentes con una relevancia del 60% o superior
Los agentes de LibreChat tienen acceso a ejecución de código, búsqueda de archivos (con citas), Skills, Subagentes, acciones, artefactos, contexto de archivos, servicios de ocr si están configurados, y capacidades de búsqueda web.

Subagentes

El campo subagents controla qué agentes secundarios aislados puede generar un agente principal cuando la capacidad subagents está disponible.

Key	Type	Description	Example
enabled	Boolean	Añade la herramienta de generación de subagentes a este agente cuando es true. Predeterminado: desactivado.	enabled: true
allowSelf	Boolean	Permite que el agente se genere a sí mismo en un contexto aislado nuevo. Predeterminado: true.	allowSelf: true
agent_ids	Array/List of Strings	Agentes específicos que este agente puede generar. Máximo: 10.	agent_ids: ["agent_researcher"]

subagents:
  enabled: true
  allowSelf: true
  agent_ids:
    - 'agent_researcher'
    - 'agent_reviewer'

Para conocer el comportamiento y los límites orientados al usuario, consulte Subagents.

Notas

No se recomienda deshabilitar la interfaz del generador a menos que esté utilizando modelSpecs para definir una lista de agentes para elegir.
La configuración de citas de archivos (maxCitations, maxCitationsPerFile, minRelevanceScore) solo se aplica cuando la capacidad file_search está habilitada.
La puntuación de relevancia se calcula utilizando similitud vectorial, donde 1.0 representa una coincidencia perfecta y 0.0 representa ninguna similitud.
Los límites de citas ayudan a equilibrar la recuperación integral de información con la calidad y el rendimiento de la respuesta.
La capacidad context funciona sin configuración de OCR utilizando métodos de análisis de texto. El OCR mejora la calidad de la extracción cuando está configurado.
La capacidad ocr requiere que se configure un servicio de OCR (consulte Configuración de OCR).