Structure de l'objet endpoint Agents
Cette page s'applique à l'endpoint agents.
Exemple
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.
# Add "programmatic_tools" with "execute_code" to enable Programmatic Tool Calling for MCP tools.
# 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
remoteApi:
auth:
oidc:
enabled: falseCette configuration active l'interface de création pour les agents.
recursionLimit
| Key | Type | Description | Example |
|---|---|---|---|
| recursionLimit | Number | Définit le nombre par défaut d'étapes qu'un agent peut effectuer lors d'une exécution. | 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. |
Par défaut : 25
Exemple :
recursionLimit: 50Pour plus d'informations sur les étapes de l'agent, consultez Max Agent Steps.
maxRecursionLimit
| Key | Type | Description | Example |
|---|---|---|---|
| maxRecursionLimit | Number | Définit le nombre maximal absolu d'étapes qu'un agent peut effectuer lors d'une exécution. | Defines the upper limit for the recursionLimit that can be set from the UI. This prevents users from setting excessively high values. |
Par défaut : Si omis, utilise la valeur de recursionLimit ou 50 si recursionLimit est également omis.
Exemple :
maxRecursionLimit: 100Pour plus d'informations sur les étapes de l'agent, consultez Max Agent Steps.
titleTiming
| Key | Type | Description | Example |
|---|---|---|---|
| titleTiming | String | Contrôle le moment où les titres de conversation sont générés pour l'endpoint agents. Valeurs valides : "immediate" ou "final". | Defaults to "immediate". |
Par défaut : "immediate"
Valeurs disponibles :
"immediate": Génère le titre dès que la requête commence, en parallèle avec la réponse du modèle, en utilisant le premier message de l'utilisateur."final": Diffère la génération du titre jusqu'à ce que la réponse complète soit terminée. Cela préserve le comportement hérité.
Exemple :
titleTiming: immediatedisableBuilder
| Key | Type | Description | Example |
|---|---|---|---|
| disableBuilder | Boolean | Contrôle la visibilité et l'utilisation de l'interface de création pour les agents. | When set to `true`, disables the builder interface for the agent, limiting direct manual interaction. |
Par défaut : false
Exemple :
disableBuilder: falseallowedProviders
| Key | Type | Description | Example |
|---|---|---|---|
| allowedProviders | Array/List of Strings | Spécifie une liste de fournisseurs d'endpoint (par exemple, "openAI", "anthropic", "google") autorisés pour une utilisation avec la fonctionnalité Agents. | If defined, only agents configured with these providers can be initialized. If omitted or empty, all configured providers are allowed. |
Par défaut : [] (liste vide, tous les fournisseurs sont autorisés)
Remarque : Doit être l'un des éléments suivants, ou un nom de endpoint personnalisé tel que défini dans votre configuration : - openAI, azureOpenAI, google, anthropic, assistants, azureAssistants, bedrock
Exemple :
allowedProviders:
- openAI
- googlecapabilities
| Key | Type | Description | Example |
|---|---|---|---|
| capabilities | Array/List of Strings | Spécifie les capacités d'agent disponibles pour tous les utilisateurs pour l'endpoint agents. | 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. |
Par défaut : ["deferred_tools", "execute_code", "file_search", "web_search", "artifacts", "subagents", "actions", "context", "skills", "tools", "chain", "ocr"]
L'appel d'outils programmatique (Programmatic Tool Calling) est une fonctionnalité optionnelle. Ajoutez programmatic_tools aux côtés de execute_code uniquement lorsque votre déploiement de l'interpréteur de code inclut le composant Tool Call Server.
Exemple :
capabilities:
- 'deferred_tools'
# Optional: enables Programmatic Tool Calling for MCP tools marked Programmatic in the Agent Builder.
# Requires execute_code and a Code Interpreter deployment with the Tool Call Server component.
# - 'programmatic_tools'
- 'execute_code'
- 'file_search'
- 'web_search'
- 'artifacts'
- 'subagents'
- 'actions'
- 'context'
- 'skills'
- 'tools'
- 'chain'
- 'ocr'Remarque : Ce champ est facultatif. S'il est omis, le comportement par défaut consiste à inclure toutes les capacités listées dans le défaut.
skills
Contrôle les paramètres de Skills au niveau de l'endpoint pour les agents.
| Key | Type | Description | Example |
|---|---|---|---|
| skills.maxCatalogSkills | Number | Limite le nombre de Skills accessibles et actifs exposés dans le catalogue visible par le modèle. Doit être compris entre 1 et 100. | maxCatalogSkills: 20 |
Par défaut : Aucune limite configurée au-delà de la limite du catalogue d'exécution.
Exemple :
skills:
maxCatalogSkills: 20Ceci ne désactive pas les Skills. Utilisez la capacité skills et la définition de portée des skills par agent/Model Specs pour contrôler si les Skills sont disponibles.
maxCitations
| Key | Type | Description | Example |
|---|---|---|---|
| maxCitations | Number | Contrôle le nombre total maximal de citations pouvant être incluses dans une seule réponse de l'agent. | When using file_search capability, limits the total number of source citations returned to prevent overwhelming responses while ensuring comprehensive coverage. |
Par défaut : 30
Plage : 1-50
Exemple :
maxCitations: 30maxCitationsPerFile
| Key | Type | Description | Example |
|---|---|---|---|
| maxCitationsPerFile | Number | Limite le nombre maximal de citations pouvant être extraites d'un seul fichier. | Ensures citation diversity by preventing any single file from dominating the citations, encouraging representation from multiple sources. |
Par défaut : 7
Plage : 1-10
Exemple :
maxCitationsPerFile: 7minRelevanceScore
| Key | Type | Description | Example |
|---|---|---|---|
| minRelevanceScore | Number | Définit le seuil de score de pertinence minimal pour que les sources soient incluses dans les réponses. | 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. |
Par défaut : 0.45 (seuil de pertinence de 45 %)
Plage : 0.0-1.0
Exemple :
minRelevanceScore: 0.45Exemples de configuration de citation de fichiers
Configuration par défaut (Équilibrée)
endpoints:
agents:
maxCitations: 30
maxCitationsPerFile: 7
minRelevanceScore: 0.45Fournit des citations complètes tout en évitant les réponses surchargées et en filtrant les correspondances de faible qualité.
Configuration stricte (Haute qualité)
endpoints:
agents:
maxCitations: 10
maxCitationsPerFile: 3
minRelevanceScore: 0.7Inclut uniquement des citations hautement pertinentes avec des limites strictes pour des réponses ciblées.
Configuration complète (Recherche)
endpoints:
agents:
maxCitations: 50
maxCitationsPerFile: 10
minRelevanceScore: 0.0Extraction d'informations maximale pour des tâches de recherche exhaustives, incluant toutes les sources indépendamment de leur pertinence.
Capacités des agents
Le champ capabilities vous permet d'activer ou de désactiver des fonctionnalités spécifiques pour les agents. Les capacités disponibles sont :
- deferred_tools : Permet aux agents de découvrir les outils MCP différés au moment de l'exécution au lieu de charger chaque outil dans le contexte au préalable.
- programmatic_tools : Active l'appel de programme par outils (Programmatic Tool Calling) pour les outils MCP marqués comme Programmatic dans l'Agent Builder. Nécessite
execute_codeet un déploiement de Code Interpreter avec le composant Tool Call Server. Cette fonctionnalité est optionnelle et n'est pas activée par défaut. - execute_code : Permet à l'agent d'exécuter du code.
- file_search : Permet à l'agent de rechercher et d'interagir avec des fichiers. Lorsqu'il est activé, le comportement des citations est contrôlé par les paramètres
maxCitations,maxCitationsPerFileetminRelevanceScore. - web_search : Active la fonctionnalité de recherche web pour les agents, leur permettant de rechercher et de récupérer des informations sur Internet.
- artifacts : Permet à l'agent de générer des artefacts interactifs (composants React, HTML, diagrammes Mermaid).
- subagents : Permet l'exécution d'agents enfants dans un contexte isolé. Voir Subagents.
- actions: Permet à l'agent d'effectuer des actions prédéfinies.
- context : Active la fonctionnalité « Télécharger en tant que texte » dans le chat, ainsi que le « Contexte de fichier » pour les agents, permettant aux utilisateurs de télécharger des fichiers et de faire extraire leur contenu pour l'inclure directement dans la conversation.
- skills : Active les Skills dans le panneau latéral, l'invocation manuelle via
$, les skills invoqués par le modèle et les listes d'autorisation de skills pour les agents. Voir Skills. - tools : Accorde à l'agent l'accès à divers outils.
- chain : Active la fonctionnalité bêta pour le chaînage d'agents, également connue sous le nom de flux de travail Mixture-of-Agents (MoA).
- ocr : Améliore optionnellement « Téléverser en tant que texte » dans le chat, ainsi que le « Contexte de fichier » pour les agents, permettant aux fichiers d'être téléversés et traités avec l'OCR. Nécessite la configuration d'un service OCR.
En spécifiant les capacités, vous pouvez contrôler les fonctionnalités disponibles pour les utilisateurs lorsqu'ils interagissent avec des agents.
Exemple de configuration
Voici un exemple de configuration de l'endpoint agents avec des capacités personnalisées et des paramètres de citation de fichiers :
endpoints:
agents:
disableBuilder: false
# File citation configuration
maxCitations: 20
maxCitationsPerFile: 5
minRelevanceScore: 0.6
# Custom capabilities
capabilities:
# Optional: enables Programmatic Tool Calling for MCP tools marked Programmatic in the Agent Builder.
# - 'programmatic_tools'
- 'execute_code'
- 'file_search'
- 'skills'
- 'subagents'
- 'actions'
- 'artifacts'
- 'context'
- 'ocr'
- 'web_search'Dans cet exemple :
- L'interface du constructeur est activée
- Les citations de fichiers sont limitées à 20 au total, avec un maximum de 5 par fichier.
- Seules les sources ayant une pertinence de 60 % ou plus sont incluses
- Les agents LibreChat ont accès à l'exécution de code, à la recherche de fichiers (avec citations), aux Skills, aux Subagents, aux actions, aux artifacts, au contexte de fichier, aux services OCR s'ils sont configurés, ainsi qu'aux capacités de recherche web.
- L'appel d'outils programmatique reste désactivé à moins que vous n'ajoutiez la capacité
programmatic_toolsen plus deexecute_code
remoteApi
Configuration pour l'authentification de l'API Remote Agent. Contrôle la manière dont les services externes s'authentifient lors de l'appel des endpoints de l'API Agents.
remoteApi.auth
| Key | Type | Description | Example |
|---|---|---|---|
| auth | Object | Configuration de l'authentification pour l'API Remote Agent. | Supports API key and/or OIDC Bearer token authentication. If omitted, only API key auth is active. |
remoteApi.auth.apiKey
| Key | Type | Description | Example |
|---|---|---|---|
| enabled | Boolean | Activer l'authentification par clé API pour l'API Remote Agent. | When true, requests with a valid LibreChat API key are accepted. Can be used alongside or instead of OIDC. |
Par défaut : true
remoteApi.auth.oidc
| Key | Type | Description | Example |
|---|---|---|---|
| enabled | Boolean | Activer l'authentification par jeton Bearer OIDC. | When true, the middleware validates Bearer tokens against the configured OIDC issuer via JWKS. |
| issuer | String | URL de l'émetteur OIDC. | The base URL of your OIDC provider, such as a Keycloak realm URL. Used for token issuer validation and JWKS discovery if jwksUri is not set. |
| jwksUri | String | URL du endpoint JWKS. Optionnel. | If omitted, resolved automatically via {issuer}/.well-known/openid-configuration. You can also set OPENID_JWKS_URL as an alternative. |
| audience | String | Public cible du jeton attendu. Requis lorsque l'authentification OIDC est activée. | Tokens must contain this value in their aud claim. |
| scope | String | Valeur de portée requise. Optionnel. | If set, the token must contain this value in its scp or scope claim. Use this to distinguish token intent across different APIs. |
Par défaut : enabled: false
Exemple - OIDC uniquement :
endpoints:
agents:
remoteApi:
auth:
apiKey:
enabled: false
oidc:
enabled: true
issuer: https://auth.example.com/realms/myrealm
audience: my-client-idExemple - OIDC avec repli sur clé API :
endpoints:
agents:
remoteApi:
auth:
apiKey:
enabled: true
oidc:
enabled: true
issuer: https://auth.example.com/realms/myrealm
# jwksUri is optional and auto-discovered if omitted
jwksUri: https://auth.example.com/realms/myrealm/protocol/openid-connect/certs
audience: my-client-idLa priorité de résolution de l'URI JWKS est l'attribut explicite jwksUri, suivi de OPENID_JWKS_URL, puis de la découverte automatique via {issuer}/.well-known/openid-configuration.
La correspondance des utilisateurs OIDC utilise la revendication sub comme recherche principale, avec une solution de repli vers les revendications email, preferred_username ou upn. L'utilisateur correspondant doit déjà exister dans LibreChat.
Sous-agents
Le champ subagents contrôle quels agents enfants isolés un agent parent peut générer lorsque la fonctionnalité subagents est disponible.
| Key | Type | Description | Example |
|---|---|---|---|
| enabled | Boolean | Ajoute l'outil de génération de sous-agent à cet agent lorsque défini sur true. Par défaut : désactivé. | enabled: true |
| allowSelf | Boolean | Permet à l'agent de se générer lui-même dans un contexte isolé et nouveau. Par défaut : true. | allowSelf: true |
| agent_ids | Array/List of Strings | Agents spécifiques que cet agent peut générer. Maximum : 10. | agent_ids: ["agent_researcher"] |
subagents:
enabled: true
allowSelf: true
agent_ids:
- 'agent_researcher'
- 'agent_reviewer'Pour le comportement et les limites côté utilisateur, consultez Subagents.
Notes
- Il n'est pas recommandé de désactiver l'interface du générateur à moins que vous n'utilisiez modelSpecs pour définir une liste d'agents parmi lesquels choisir.
- La configuration des citations de fichiers (
maxCitations,maxCitationsPerFile,minRelevanceScore) s'applique uniquement lorsque la fonctionnalitéfile_searchest activée. - Le score de pertinence est calculé en utilisant la similarité vectorielle, où 1.0 représente une correspondance parfaite et 0.0 représente aucune similarité.
- Les limites de citation aident à équilibrer la récupération d'informations complètes avec la qualité et la performance des réponses.
- La fonctionnalité
contextfonctionne sans configuration OCR en utilisant des méthodes d'analyse de texte. L'OCR améliore la qualité de l'extraction lorsqu'il est configuré. - La fonctionnalité
ocrnécessite la configuration d'un service OCR (voir Configuration OCR).
Que pensez-vous de ce guide ?