Herramientas — AiHummer Documentos

Herramientas son cómo un agente actúa en el mundo: obteniendo una página, buscando, enviando correo, consultando una base de datos, generando un documento. AiHummer incluye una rica catálogo incorporado y un Tiempo de ejecución de la herramienta que habilita las herramientas cuando están configuradas, las recarga sin necesidad de reiniciar, bloquea las que son riesgosas detrás de la aprobación humana y puede bloquear completamente la salida en modo aislado.

Esta página cubre cómo se comporta el tiempo de ejecución y lista las funciones integradas. Para la referencia completa, vea el catálogo de herramientas.

Cómo se comporta el tiempo de ejecución de la herramienta

Activar-en-configuración. Una herramienta se vuelve disponible solo cuando su requisito previo la configuración está presente — usualmente una variable de entorno que apunta a la el servicio que necesita. Sin configuración, sin herramienta.
Recarga en caliente. La habilitación de herramientas se aplica caliente, sin reiniciar el puerta de enlace, para que puedas activar y desactivar capacidades en tiempo de ejecución.
Puerta de aprobación. Las herramientas riesgosas pueden colocarse detrás de un humano en el bucle puerta de aprobación a través de AIHUMMER_APPROVAL_TOOLS. Una llamada rechazada es no ejecutado.
Modo aislado. Configuración AIHUMMER_AIRGAPPED=1 bloques controlados por modelo egreso público, para implementaciones soberanas o aisladas.

[!WARNING] code_exec es desactivado por defecto en hosts compartidos. Actívalo solo donde el sandbox y host son aceptables para ejecutar código creado por el modelo, y considerar poniéndolo detrás de la puerta de aprobación.

Herramientas integradas

Herramienta	Lo que hace	Habilitar con
`web_fetch`	Obtener una URL (protegida contra SSRF)	activado por defecto
`http_request`	Hacer una solicitud HTTP (protegida contra SSRF)	activado por defecto
`web_search`	Búsqueda web a través del SearXNG incorporado	activado por defecto; se desactiva con la bandera del instalador `--no-search`
`browser`	Conducir un navegador real sobre CDP	activado por defecto; se desactiva con la bandera del instalador `--no-browser`
`computer`	Uso de la computadora sobre CDP	activado por defecto; se desactiva con la bandera del instalador `--no-browser`
`memory_store`	Guardar un hecho en la memoria a largo plazo; con el modo de captura `auto` (el predeterminado) se puede buscar de inmediato, con `review`/`off` se convierte en un candidato pendiente de aprobación	activado por defecto
`memory_search`	Buscar en la memoria a largo plazo	activado por defecto
`filesystem_read`	Leer un archivo o listar un directorio en el disco del servidor	activo por defecto; `AIHUMMER_FS_ROOT` acota el entorno aislado, vacío = el servidor entero
`db_query`	Consulta de base de datos de solo lectura	`AIHUMMER_DB_QUERY_DSN`
`mail`	Enviar/recibir correo (SMTP/IMAP)	credenciales de correo (bóveda)
`code_exec`	Ejecutar código en un sandbox (desactivado por defecto en hosts compartidos)	`AIHUMMER_CODE_EXEC`
`doc_generate`	Generar documentos CSV/TSV/XLSX	activado por defecto
`tts`	Texto a voz	Sidecar de TTS
`image_generate` / `edit_image`	Generar y editar imágenes	backend de imagen configurado
`github_get_file`	Obtener un archivo de GitHub	activado por defecto
`generate_pairing_code`	Emitir un código de emparejamiento de dispositivo	activado por defecto
`search_knowledge` / `deep_research`	Recuperación de conocimiento e investigación de varios pasos	base de conocimientos
Bitrix24 CRM / tarea / calendario	Acciones de CRM, tareas y calendario de Bitrix24	Plugin de Bitrix24
1C (BIT.FINANZAS OData)	Acceso a 1C BIT.FINANZAS a través de OData	Configuración de 1C OData

[!NOTE] web_fetch y http_request son Protegido contra SSRF — rechazan las solicitudes para direcciones internas y otros objetivos inseguros, por lo que un modelo no puede usarlos para alcanzar tu red privada.

Habilidades compartidas

A habilidad es una instrucción reutilizable (un fragmento de solicitud) que se puede adjuntar a los agentes. La biblioteca se encuentra en la interfaz de administración Habilidades compartidas página: para crear una, un nombre y el texto son suficientes — el identificador (slug) se deriva automáticamente. Las habilidades proporcionadas por el proveedor desde el inicio incluyen un Listo para usar insignia; pueden desactivarse pero permanecen listadas. Las habilidades adjuntas se muestran en el prefijo estable del aviso del sistema del agente.

Habilitación de herramientas

La mayoría de las herramientas se activan cuando proporcionas su configuración. Interruptores comunes:

AIHUMMER_FS_ROOT=/srv/agent-files          # ACOTA el entorno aislado de filesystem_read (vacío = el servidor entero)
AIHUMMER_DB_QUERY_DSN=postgres://...        # db_query (read-only)
AIHUMMER_CODE_EXEC=1                         # code_exec (sandboxed)
AIHUMMER_APPROVAL_TOOLS=mail,code_exec       # require approval for these tools
AIHUMMER_AIRGAPPED=1                          # block model-controlled public egress

[!TIP] Usar AIHUMMER_APPROVAL_TOOLS requerir aprobación para cualquier cosa con un lado efecto — enviar correo, ejecutar código — mientras se dejan sin restricciones las herramientas de solo lectura.

¿A dónde vamos ahora?

Vea la referencia completa por herramienta en el catálogo de herramientas.
Entiende el bucle que llama a estas herramientas Orquestación y subagentes.
Respaldar las respuestas de la herramienta en sus documentos con Conocimiento / RAG.