Estrutura do Objeto do endpoint Agents

Esta página se aplica ao endpoint agents.

Exemplo

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

Esta configuração habilita a interface do construtor para agentes.

recursionLimit

Padrão: 25

Exemplo:

recursionLimit: 50

Para mais informações sobre as etapas do agente, consulte Max Agent Steps.

maxRecursionLimit

Padrão: Se omitido, assume o valor de recursionLimit ou 50 se recursionLimit também for omitido.

Exemplo:

maxRecursionLimit: 100

Para mais informações sobre as etapas do agente, consulte Max Agent Steps.

titleTiming

Padrão: "immediate"

Valores Disponíveis:

• "immediate": Gera o título assim que a solicitação é iniciada, em paralelo com a resposta do modelo, usando a primeira mensagem do usuário.
• "final": Adia a geração do título até que a resposta completa seja concluída. Isso preserva o comportamento legado.

Exemplo:

titleTiming: immediate

disableBuilder

Padrão: false

Exemplo:

disableBuilder: false

allowedProviders

Padrão: [] (lista vazia, todos os provedores permitidos)

Nota: Deve ser um dos seguintes, ou um nome de endpoint personalizado conforme definido em sua configuração: - openAI, azureOpenAI, google, anthropic, assistants, azureAssistants, bedrock

Exemplo:

allowedProviders:
  - openAI
  - google

capabilities

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

O Programmatic Tool Calling é opcional (opt-in). Adicione programmatic_tools junto com execute_code apenas quando sua implantação do Code Interpreter incluir o componente Tool Call Server.

Exemplo:

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'

Nota: Este campo é opcional. Se omitido, o comportamento padrão é incluir todas as capacidades listadas no default.

skills

Controla as configurações de Skills em nível de endpoint para agentes.

Padrão: Nenhum limite configurado além do limite do catálogo de tempo de execução.

Exemplo:

skills:
  maxCatalogSkills: 20

Isso não desativa as Skills. Use a capacidade skills e o escopo de skill por agente/model-spec para controlar se as Skills estão disponíveis.

maxCitations

Padrão: 30

Intervalo: 1-50

Exemplo:

maxCitations: 30

maxCitationsPerFile

Padrão: 7

Intervalo: 1-10

Exemplo:

maxCitationsPerFile: 7

minRelevanceScore

Padrão: 0.45 (limite de relevância de 45%)

Intervalo: 0.0-1.0

Exemplo:

minRelevanceScore: 0.45

Exemplos de Configuração de Citação de Arquivos

Configuração Padrão (Balanceada)

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

Fornece citações abrangentes, evitando respostas excessivas e filtrando correspondências de baixa qualidade.

Configuração Estrita (Alta Qualidade)

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

Inclui apenas citações altamente relevantes com limites rigorosos para respostas focadas.

Configuração Abrangente (Pesquisa)

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

Extração máxima de informações para tarefas de pesquisa exaustivas, incluindo todas as fontes, independentemente da relevância.

Capacidades dos Agentes

O campo capabilities permite que você habilite ou desabilite funcionalidades específicas para agentes. As capacidades disponíveis são:

• deferred_tools: Permite que agentes descubram ferramentas MCP adiadas em tempo de execução, em vez de carregar todas as ferramentas no contexto antecipadamente.
• programmatic_tools: Habilita a Chamada de Ferramentas Programáticas para ferramentas MCP marcadas como Programmatic no Agent Builder. Requer execute_code e uma implementação de Code Interpreter com o componente Tool Call Server. Esta funcionalidade é opcional e não está habilitada por padrão.
• execute_code: Permite que o agente execute código.
• file_search: Permite que o agente pesquise e interaja com arquivos. Quando ativado, o comportamento de citação é controlado pelas configurações maxCitations, maxCitationsPerFile e minRelevanceScore.
• web_search: Habilita a funcionalidade de pesquisa na web para agentes, permitindo que eles pesquisem e recuperem informações da internet.
• artifacts: Permite que o agente gere artefatos interativos (componentes React, HTML, diagramas Mermaid).
• subagents: Habilita execuções de agentes filhos em contexto isolado. Veja Subagents.
• actions: Permite que o agente execute ações predefinidas.
• context: Habilita a funcionalidade "Upload as Text" no chat e "File Context" para agentes, permitindo que os usuários enviem arquivos e tenham seu conteúdo extraído e incluído diretamente na conversa.
• skills: Habilita Skills no painel lateral, invocação manual com $, skills invocadas pelo modelo e listas de permissão de skills de agentes. Veja Skills.
• tools: Concede ao agente acesso a várias ferramentas.
• chain: Habilita o recurso Beta para encadeamento de agentes, também conhecido como fluxos de trabalho Mixture-of-Agents (MoA).
• ocr: Opcionalmente aprimora o "Upload as Text" no chat e o "File Context" para agentes, permitindo que arquivos sejam enviados e processados com OCR. Requer que um serviço de OCR seja configurado.

Ao especificar as capabilities, você pode controlar os recursos disponíveis para os usuários ao interagir com agentes.

Exemplo de Configuração

Aqui está um exemplo de configuração do endpoint agents com capacidades personalizadas e configurações de citação de arquivos:

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'

Neste exemplo:

• A interface do construtor está habilitada
• As citações de arquivos são limitadas a um total de 20, com no máximo 5 por arquivo
• Apenas fontes com 60%+ de relevância são incluídas
• Os agentes do LibreChat têm acesso à execução de código, pesquisa de arquivos (com citações), Skills, Subagentes, ações, artefatos, contexto de arquivos, serviços de OCR (se configurados) e recursos de pesquisa na web.
• O Programmatic Tool Calling permanece desativado, a menos que você adicione a capacidade programmatic_tools junto com execute_code

remoteApi

Configuração para autenticação da API de Agentes Remotos. Controla como serviços externos se autenticam ao chamar os endpoints da API de Agentes.

remoteApi.auth

remoteApi.auth.apiKey

Padrão: true

remoteApi.auth.oidc

Padrão: enabled: false

Exemplo - Apenas OIDC:

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

Exemplo - OIDC com fallback de chave de 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

Subagentes

O campo subagents controla quais agentes filhos isolados um agente pai pode gerar quando a capacidade subagents está disponível.

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

Para comportamento e limites voltados ao usuário, veja Subagents.

Notas

• Não é recomendado desativar a interface do construtor, a menos que você esteja usando modelSpecs para definir uma lista de agentes para escolha.
• A configuração de citação de arquivos (maxCitations, maxCitationsPerFile, minRelevanceScore) só se aplica quando a capacidade file_search está habilitada.
• A pontuação de relevância é calculada usando similaridade vetorial, onde 1.0 representa uma correspondência perfeita e 0.0 representa nenhuma similaridade.
• Os limites de citação ajudam a equilibrar a recuperação abrangente de informações com a qualidade e o desempenho da resposta.
• A capacidade context funciona sem configuração de OCR usando métodos de análise de texto. O OCR aprimora a qualidade da extração quando configurado.
• A funcionalidade ocr requer que um serviço de OCR seja configurado (veja Configuração de OCR).