Herramientas
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=1bloques controlados por modelo egreso público, para implementaciones soberanas o aisladas.
[!WARNING]
code_execes 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 |
Crear un documento CSV / TSV / XLSX o HTML. | 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_fetchyhttp_requestson 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.
Perfil persistente del navegador
Por defecto, computer abre un navegador limpio en cada solicitud. Desde la
versión 1.3 la herramienta puede conservar un perfil personal asignado
explícitamente (cookies y sesiones de sitios) entre solicitudes — por ejemplo,
para que un empleado trabaje en sus propias cuentas sin iniciar sesión cada vez.
Un perfil nunca se elige por un nombre o una ruta de los argumentos del modelo,
solo por una vinculación explícita del operador:
AIHUMMER_BROWSER_PROFILE_SOCKET— ruta absoluta al socket privadomanaged-profiles.sockdel servicio de navegador instalado; vacío (por defecto) — los perfiles persistentes están desactivados.AIHUMMER_BROWSER_PROFILE_BINDINGS— un array JSON de vinculaciones:profile_id,tenant_id,user_id,agent_idsyconversation_ids(hasta 64 perfiles, un propietario cada uno).
Un perfil se abre solo cuando el usuario actual es su propietario y el agente y
el diálogo figuran en la vinculación; el diálogo debe ser privado, sin otros
participantes humanos. El propietario y los derechos se comprueban en cada
acción, no solo en la primera apertura. Mientras los perfiles persistentes
estén activados, las acciones de computer solo se ejecutan con una
vinculación adecuada. Se requiere una política de red explícita del navegador —
un AIHUMMER_BROWSER_ALLOW_PRIVATE_NETWORK definido (true o false) o una
lista AIHUMMER_BROWSER_ALLOWED_HOSTNAMES; las cookies de un navegador externo
no se importan. Ambos ajustes se consideran peligrosos: en la nube gestionada y
en la instancia de demostración están bloqueados.
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_TOOLSrequerir 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.
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.