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.
    # 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

Cette configuration active l'interface de création pour les agents.

recursionLimit

Par défaut : 25

Exemple :

recursionLimit: 50

Pour plus d'informations sur les étapes des agents, consultez Max Agent Steps.

maxRecursionLimit

Par défaut : S'il est omis, la valeur par défaut est celle de recursionLimit ou 50 si recursionLimit est également omis.

Exemple :

maxRecursionLimit: 100

Pour plus d'informations sur les étapes des agents, consultez Max Agent Steps.

titleTiming

Par défaut : "immediate"

Valeurs disponibles :

• "immediate" : Génère le titre dès que la requête commence, en parallèle de 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: immediate

disableBuilder

Par défaut : false

Exemple :

disableBuilder: false

allowedProviders

Par défaut : [] (liste vide, tous les fournisseurs sont autorisés)

Note : 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
  - google

capabilities

Par défaut : ["deferred_tools", "execute_code", "file_search", "web_search", "artifacts", "subagents", "actions", "context", "skills", "tools", "chain", "ocr"]

Exemple :

capabilities:
  - 'deferred_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.

Par défaut : Aucune limite configurée au-delà de la limite du catalogue d'exécution.

Exemple :

skills:
  maxCatalogSkills: 20

Cela ne désactive pas les Skills. Utilisez la capacité skills et la définition de la portée des skills par agent/Model Specs pour contrôler si les Skills sont disponibles.

maxCitations

Par défaut : 30

Plage : 1-50

Exemple :

maxCitations: 30

maxCitationsPerFile

Par défaut : 7

Plage : 1-10

Exemple :

maxCitationsPerFile: 7

minRelevanceScore

Par défaut : 0.45 (seuil de pertinence de 45 %)

Plage : 0.0-1.0

Exemple :

minRelevanceScore: 0.45

Exemples de configuration de citation de fichiers

Configuration par défaut (Équilibrée)

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

Fournit des citations complètes tout en évitant les réponses trop longues et en filtrant les correspondances de faible qualité.

Configuration stricte (Haute qualité)

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

Inclut 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.0

Extraction maximale d'informations 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.
• 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, maxCitationsPerFile et minRelevanceScore.
• 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 des exécutions 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:
      - '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.

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.

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_search est 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 exhaustives avec la qualité et la performance des réponses.
• La fonctionnalité context fonctionne 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é ocr nécessite la configuration d'un service OCR (voir Configuration OCR).