AiHummer
Español▾
Iniciar sesiónCuenta
v1.6.x▾
{ }Swagger

Catálogo de herramientas

v1.6.x · actualizada 2026-11-15

Durante un turno el agente puede llamar herramientas. AiHummer envía un tiempo de ejecución de herramientas incorporado: algunas herramientas están activadas por defecto, otras se activan solo cuando proporciona la configuración requerida. Las herramientas están protegidas contra SSRF y en entornos aislados donde sea relevante, y las herramientas riesgosas pueden colocarse detrás de un filtro de aprobación humana.

Habilitado por defecto

Estas herramientas funcionan de inmediato (algunas dependen de un modelo o base de conocimiento configurados).

Herramienta Lo que hace Cómo habilitar
web_fetch Obtén el contenido de una URL. Protegido contra SSRF. Activado por defecto
http_request Realiza una solicitud HTTP saliente. Protegido contra SSRF. Activado por defecto
web_search Buscar en la web a través del SearXNG incorporado. Activado por defecto (incluido con el instalador); se desactiva con --no-search
browser / computer Conduce un navegador real a través del Protocolo de DevTools de Chrome. Activado por defecto (incluido con el instalador); se desactiva con --no-browser
memory_store Guardar un hecho en la memoria a largo plazo (Einstein). Con el modo de captura auto (el predeterminado) el hecho se puede buscar de inmediato; con review/off se convierte en un candidato pendiente de aprobación. El resultado lleva un campo searchable_now. Activado por defecto
memory_search Buscar en la memoria a largo plazo (Einstein). Activado por defecto
doc_generate Crear un documento CSV / TSV / XLSX o HTML. Activado por defecto
image_generate / edit_image Generar o editar imágenes. Requiere un servicio de imágenes configurado; la edición exige que ese servicio también la admita.
github_get_file Obtener un solo archivo de un repositorio de GitHub. Activado por defecto
generate_pairing_code Emitir un código de emparejamiento de dispositivo. Activado por defecto
search_knowledge Busca en la base de conocimientos (RAG) y fundamenta las respuestas con citas. Con una base de conocimientos configurada
deep_research Realiza una investigación de múltiples pasos y produce un informe con citas. Activado por defecto
docs_search Buscar un copia fuera de línea de esta documentación (una instantánea de docs.aihummer.ru se incluye en la versión, share/docs, ru/en) — el agente puede responder preguntas sobre el producto sin internet. Con la instantánea de los documentos presente (instalación estándar)
docs_read Lea una página completa de documentación encontrada a través de docs_search. Con la instantánea de los documentos presente (instalación estándar)
filesystem_read Lee un archivo o lista un directorio en el disco del servidor. Por defecto, la carpeta de trabajo propia del agente; el acceso al host requiere que el propietario elija explícitamente el aislamiento de ese agente. No disponible en la nube gestionada ni en la demostración.

[!NOTE] AIHUMMER_FS_ROOT restringe aún más la raíz permitida; un valor vacío no concede acceso a todo el servidor. No se pueden leer la configuración de la instalación, sus credenciales de base de datos y claves de cifrado, ni los entornos de los procesos. La aprobación no amplía el ámbito de archivos permitido.

Habilitar en la configuración

Estas herramientas permanecen apagadas hasta que las apuntes al recurso que necesitan. Todos los controles de activación (AIHUMMER_DB_QUERY_DSN, AIHUMMER_CODE_EXEC, …) son Configuración-catalogo claves: configúralas en la interfaz de administración web (Gestión → Configuración, tiene búsqueda) o con aihummer settings set <KEY> <VALUE>. Poniéndolos dentro gateway.env tiene sin efecto — el entorno se ignora para estas claves.

Herramienta Lo que hace Cómo habilitar
db_query Ejecute consultas SQL de solo lectura. AIHUMMER_DB_QUERY_DSN
mail Enviar y leer correos electrónicos. Credenciales SMTP / IMAP
tts Sintetizar voz (texto a voz). AIHUMMER_TTS_URL (TTS adjunto)
code_exec Ejecutar código en un entorno aislado. AIHUMMER_CODE_EXEC

[!DANGER] code_exec está desactivado por defecto. Actívelo solo en un entorno que controle y en el que confíe: ejecuta código escrito por el modelo y sigue siendo una capacidad privilegiada incluso en un entorno aislado.

Herramientas de integración

Cuando se configura la conexión correspondiente, el agente también obtiene herramientas de dominio:

Herramienta Lo que hace Cómo habilitar
Herramientas de CRM / tareas / calendario de Bitrix24 Leer y actuar sobre los registros, tareas y el calendario de Bitrix24 CRM. Conexión de Bitrix24 configurada
1C (BIT.FINANZAS OData) Consultar los datos contables 1C a través de la interfaz OData БИТ.ФИНАНС. Conexión OData de 1C configurada

Puerta de aprobación

Cualquier herramienta puede colocarse detrás de un puerta de aprobación con intervención humana. Enumere los nombres de las herramientas en el AIHUMMER_APPROVAL_TOOLS configuración (interfaz de administración web: Gestión → Configuración); antes de que se ejecute tal herramienta, un operador debe aprobar la llamada. Una llamada rechazada es no ejecutado.

aihummer settings set AIHUMMER_APPROVAL_TOOLS mail,code_exec

Modo aislado

Establecer el AIHUMMER_AIRGAPPED ajuste a 1 bloquear la salida pública controlada por el modelo. En este modo, el agente no puede acceder a internet abierto a través de herramientas, lo cual es apropiado para implementaciones soberanas o aisladas.

aihummer settings set AIHUMMER_AIRGAPPED 1

[!NOTE] Más allá del catálogo incorporado, AiHummer puede sintetizar herramientas a partir de cualquier OpenAPI 3.x especificación y expone las herramientas de cualquier servidor MCP sin código de integración. Ver el Sección de Marketplace y Plugins de la documentación.

¿A dónde vamos ahora?

Documentos HTML

Con doc_generate y format: "html", el agente crea un archivo HTML adjunto de hasta 4 MiB en UTF-8. Se conservan CSS y JavaScript. Una aplicación compatible y actualizada abre el archivo guardado en una vista aislada tras comprobar su origen e integridad. No se transmiten las credenciales de la aplicación; cambiar el archivo, el origen o la sesión invalida la vista.