class Agent

Descripción

Clase básica de agente. Requiere parámetros de agente (config {diccionario}) y definición de módulo (modules_def [lista de diccionarios])

Ejemplo

import pandoraPluginTools as pt

# Create an instance of the Agent class
agent_instance = pt.agents.Agent()

Funciones

update_config

Descripción

Actualiza los ajustes de configuración con nuevos valores.config

Parámetros

Nombre	Tipo	Requerido	Descripción
config	dict	Si	Un diccionario que contiene las claves de configuración y sus nuevos valores

Ejemplo

# Update agent configuration
new_config = {
    "agent_name": "UpdatedAgentName",
    "description": "Updated agent description"
}
agent_instance.update_config(new_config)

Versión

1.0.0

get_config

Descripción

Recupera los ajustes de configuración actuales.

Return

Tipo	Descripción
dict	Un diccionario que contiene los ajustes de configuración actuales

Ejemplo

Get

current

agent configuration
current_config = agent_instance.get_config()
print("Current Agent Configuration:", current_config)

Versión

1.0.0

add_module

Descripción

Añade un nuevo módulo a la lista de módulos.

Parámetros

Nombre	Tipo	Requerido	Descripción
module	dict	Si	Un diccionario que contiene información sobre el módulo

Ejemplo

# Define a module 
and 
add 
it 
to

the

agent
module_data = {
    "name": "SampleModule",
    "type": "generic",
    "value": 123,
    "desc": "Sample module description"
}
agent_instance.add_module(module_data)

Versión

1.0.0

del_module

Descripción

Elimina un módulo basándose en su nombre

Parámetros

Nombre	Tipo	Requerido	Descripción
module_name	str	Si	El nombre del módulo a eliminar

Ejemplo

Versión

1.0.0

update_module

Descripción

Actualiza un módulo basándose en su nombre

Parámetros

Nombre	Tipo	Requerido	Descripción
module_name	str	Si	El nombre del módulo a actualizar
module	dict	Si	Un diccionario que contiene la información actualizada del módulo

Versión

1.0.0

get_module

Descripción

Recupera información del módulo en base a su nombre

Parámetros

Nombre	Tipo	Requerido	Descripción
module_name	str	SI	El nombre del módulo a recuperar

Return

Tipo	Descripción
dict	Un diccionario que contiene información del módulo si se encuentra, de lo contrario un diccionario vacío

Ejemplo

# Get module information by name
module_info = agent_instance.get_module("SampleModule")
print("Module Information:", module_info)

Versión

1.0.0

get_modules_def

Descripción

Recupera las definiciones de todos los módulos añ~~adidos~~adidos.

Return

Tipo	Descripción
dict	Un diccionario que contiene las definiciones de todos los módulos añadidos

Ejemplo

# Get definitions of all added modules
all_module_defs = agent_instance.get_modules_def()
print("All Module Definitions:", all_module_defs)

Versión

1.0.0

add_log_module

Descripción

Añade un nuevo módulo de registro a la lista de módulos de registro.

Parámetros

Nombre	Tipo	Requerido	Descripción
log_module	dict	Si	Un diccionario que contiene información sobre el módulo de registro

Ejemplo

# Define a log module and add it to the agent
log_module_data = {
    "source": "LogSource",
    "type": "log",
    "value": "Log message"
}
agent_instance.add_log_module(log_module_data)

Versión

1.0.0

get_log_modules_def

Descripción

Recupera las definiciones de todos los módulos de registro añadidos

Return

Tipo	Descripción
dict	Un diccionario que contiene las definiciones de todos los módulos de registro añadidos

Ejemplo

# Get definitions of all added log modules
all_log_module_defs = agent_instance.get_log_modules_def()
print("All Log Module Definitions:", all_log_module_defs)

Versión

1.0.0

print_xml

Descripción

Genera y opcionalmente imprime la representación XML del agente.

Parámetros

Nombre	Tipo	Requerido	Descripción
print_flag	bool	SI	Una bandera que indica si imprimir la representación XML

Return

Tipo	Descripción
str	La representación XML del agente

Ejemplo

Generate and optionally print the XML representation of the agent
xml_representation = agent_instance.print_xml(print_flag=True)
print("Agent XML Representation:\n", xml_representation)

Versión

1.0.0