Structuur van het Agents endpoint-object

Deze pagina is van toepassing op het agents endpoint.

Voorbeeld

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

Deze configuratie schakelt de builder-interface voor agents in.

recursionLimit

Standaard: 25

Voorbeeld:

recursionLimit: 50

Voor meer informatie over agent-stappen, zie Max Agent Steps.

maxRecursionLimit

Standaard: Indien weggelaten, wordt standaard de waarde van recursionLimit gebruikt, of 50 als recursionLimit ook is weggelaten.

Voorbeeld:

maxRecursionLimit: 100

Voor meer informatie over agent-stappen, zie Max Agent Steps.

titleTiming

Standaard: "immediate"

Beschikbare waarden:

• "immediate": Genereert de titel zodra het verzoek start, parallel aan het antwoord van het model, met behulp van het eerste bericht van de gebruiker.
• "final": Stelt het genereren van de titel uit totdat het volledige antwoord is voltooid. Dit behoudt het legacy-gedrag.

Voorbeeld:

titleTiming: immediate

disableBuilder

Standaard: false

Voorbeeld:

disableBuilder: false

allowedProviders

Standaard: [] (lege lijst, alle providers toegestaan)

Let op: Moet een van de volgende zijn, of een aangepaste endpoint-naam zoals gedefinieerd in uw configuratie: - openAI, azureOpenAI, google, anthropic, assistants, azureAssistants, bedrock

Voorbeeld:

allowedProviders:
  - openAI
  - google

capabilities

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

Programmatic Tool Calling is opt-in. Voeg programmatic_tools toe naast execute_code alleen wanneer jouw Code Interpreter-implementatie de Tool Call Server-component bevat.

Voorbeeld:

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'

Let op: Dit veld is optioneel. Indien weggelaten, is het standaardgedrag om alle mogelijkheden op te nemen die in de standaard worden vermeld.

skills

Beheert endpoint-level Skills-instellingen voor agents.

Standaard: Geen geconfigureerde limiet buiten de runtime cataloguslimiet.

Voorbeeld:

skills:
  maxCatalogSkills: 20

Dit schakelt Skills niet uit. Gebruik de skills capability en per-agent/model-spec skill scoping om te bepalen of Skills beschikbaar zijn.

maxCitations

Standaard: 30

Bereik: 1-50

Voorbeeld:

maxCitations: 30

maxCitationsPerFile

Standaard: 7

Bereik: 1-10

Voorbeeld:

maxCitationsPerFile: 7

minRelevanceScore

Standaard: 0.45 (45% relevantiedrempel)

Bereik: 0.0-1.0

Voorbeeld:

minRelevanceScore: 0.45

Voorbeelden van configuratie voor bestandscitatie

Standaardconfiguratie (Gebalanceerd)

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

Biedt uitgebreide bronvermeldingen terwijl overvolle antwoorden worden voorkomen en resultaten van lage kwaliteit worden gefilterd.

Strikte configuratie (Hoge kwaliteit)

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

Bevat alleen zeer relevante bronvermeldingen met strikte limieten voor gerichte antwoorden.

Uitgebreide configuratie (Onderzoek)

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

Maximale informatie-extractie voor uitgebreide onderzoekstaken, inclusief alle bronnen, ongeacht de relevantie.

Agent-mogelijkheden

Het capabilities veld stelt je in staat om specifieke functionaliteiten voor agents in of uit te schakelen. De beschikbare capabilities zijn:

• deferred_tools: Hiermee kunnen agents deferred MCP-tools ontdekken tijdens runtime in plaats van elke tool vooraf in de context te laden.
• programmatic_tools: Schakelt Programmatic Tool Calling in voor MCP-tools die in de Agent Builder als Programmatic zijn gemarkeerd. Vereist execute_code en een Code Interpreter-implementatie met de Tool Call Server-component. Deze mogelijkheid is opt-in en is standaard niet ingeschakeld.
• execute_code: Staat de agent toe om code uit te voeren.
• file_search: Stelt de agent in staat om bestanden te doorzoeken en ermee te werken. Wanneer ingeschakeld, wordt het gedrag van citaten beheerd door de instellingen maxCitations, maxCitationsPerFile en minRelevanceScore.
• web_search: Schakelt webzoekfunctionaliteit in voor agents, waardoor ze informatie van het internet kunnen zoeken en ophalen.
• artifacts: Hiermee kan de agent interactieve artifacts genereren (React-componenten, HTML, Mermaid-diagrammen).
• subagents: Maakt geïsoleerde context-child agent runs mogelijk. Zie Subagents.
• actions: Staat de agent toe om vooraf gedefinieerde acties uit te voeren.
• context: Schakelt de "Upload als tekst"-functionaliteit in de chat in, evenals "Bestandscontext" voor agents, waardoor gebruikers bestanden kunnen uploaden en de inhoud ervan kunnen laten extraheren en direct in het gesprek kunnen opnemen.
• skills: Schakelt Skills in in het zijpaneel, handmatige $ aanroepen, door modellen aangeroepen skills en allowlists voor agent-skills. Zie Skills.
• tools: Geeft de agent toegang tot verschillende tools.
• chain: Schakelt de bètafunctie in voor agent-chaining, ook wel bekend als Mixture-of-Agents (MoA) workflows.
• ocr: Verbetert optioneel "Uploaden als tekst" in de chat en "Bestandscontext" voor agents, waardoor bestanden kunnen worden geüpload en verwerkt met OCR. Vereist dat een OCR-service is geconfigureerd.

Door de mogelijkheden (capabilities) te specificeren, kun je de functies beheren die beschikbaar zijn voor gebruikers wanneer zij met agents communiceren.

Voorbeeldconfiguratie

Hier is een voorbeeld van het configureren van de agents endpoint met aangepaste mogelijkheden en instellingen voor bestandscitatie:

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'

In dit voorbeeld:

• De builder interface is ingeschakeld
• Bestandscitaties zijn beperkt tot in totaal 20, met een maximum van 5 per bestand
• Alleen bronnen met 60%+ relevantie worden opgenomen
• LibreChat Agents hebben toegang tot code-uitvoering, bestandszoekopdrachten (met bronvermeldingen), Skills, Subagents, actions, artifacts, bestandscontext, ocr-services indien geconfigureerd, en webzoekmogelijkheden.
• Programmatic Tool Calling blijft uitgeschakeld tenzij je de programmatic_tools capability toevoegt naast execute_code

remoteApi

Configuratie voor Remote Agent API-authenticatie. Bepaalt hoe externe services zich authenticeren bij het aanroepen van de Agents API-endpoints.

remoteApi.auth

remoteApi.auth.apiKey

Standaard: true

remoteApi.auth.oidc

Standaard: enabled: false

Voorbeeld - Alleen OIDC:

endpoints:
  agents:
    remoteApi:
      auth:
        apiKey:
          enabled: false
        oidc:
          enabled: true
          issuer: https://auth.example.com/realms/myrealm
          audience: my-client-id

Voorbeeld - OIDC met API-sleutel fallback:

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

Subagents

Het subagents veld bepaalt welke geïsoleerde sub-agents een parent-agent kan aanmaken wanneer de subagents functionaliteit beschikbaar is.

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

Voor gebruikersgericht gedrag en limieten, zie Subagents.

Opmerkingen

• Het wordt niet aanbevolen om de builder-interface uit te schakelen, tenzij je modelSpecs gebruikt om een lijst met agents te definiëren waaruit gekozen kan worden.
• De configuratie voor bestandscitatie (maxCitations, maxCitationsPerFile, minRelevanceScore) is alleen van toepassing wanneer de file_search capability is ingeschakeld.
• De relevantiescore wordt berekend met behulp van vectorsimilariteit, waarbij 1.0 een perfecte match vertegenwoordigt en 0.0 geen enkele gelijkenis.
• Citatielimieten helpen bij het balanceren van uitgebreide informatieverzameling met de kwaliteit en prestaties van het antwoord.
• De context functionaliteit werkt zonder OCR-configuratie door gebruik te maken van tekst-parsingmethoden. OCR verbetert de extractiekwaliteit wanneer dit geconfigureerd is.
• De ocr functionaliteit vereist dat een OCR-service wordt geconfigureerd (zie OCR Configuration).