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: false

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 de l'agent, consultez Max Agent Steps.

maxRecursionLimit

Par défaut : Si omis, utilise la valeur de recursionLimit ou 50 si recursionLimit est également omis.

Exemple :

maxRecursionLimit: 100

Pour plus d'informations sur les étapes de l'agent, 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 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: immediate

disableBuilder

Par défaut : false

Exemple :

disableBuilder: false

allowedProviders

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

capabilities

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.

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

Exemple :

skills:
  maxCatalogSkills: 20

Ceci 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

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 surchargées 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 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_code et 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, 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 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_tools en plus de execute_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

remoteApi.auth.apiKey

Par défaut : true

remoteApi.auth.oidc

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

Exemple - 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-id

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 complètes 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).