Parte 09 - Advanced Customization Tutorial

DEFINIÇÕES INICIAIS

• Componente: objetos funcionais (internos) que definem como os níveis superior e inferior de cada subsistema opera. Todos derivam da classe "Clarion.Framework.Templates.ClarionComponent".
• Componente implícito: componentes dos níveis inferiores. Todos derivam da classe "Clarion.Framework.Templates.ImplicitComponent".
• Regra: componentes dos níveis superiores, sendo que todos derivam da classe "Clarion.Framework.Templates.Rule".
• Impulso (Drives): Todos componentes do nível inferior do MS derivam da classe "Clarion.Framework.Templates.Drive".
• Módulo: contidos pelo MCS, o qual não é exatamente um subsistema, uma vez que não possui diretamente níveis superior e inferior sendo, ao contrário, um container para os módulos. Estes, por sua vez, contém níveis superior e inferior, agindo como "mini" ACSs, como já comentado. Todos eles derivam da classe "Clarion.Framework.Templates.MetaCognitiveModule".

INTERFACES E TEMPLATES PARA CUSTOMIZAÇÃO

• Seu componente é treinável? Se for, devem implementar a interface "ITrainable";
• Seu componente pode ser treinado através de "reinforcement learning"? Se sim, deve implementar a interface "IReinforcementTrainable";
• Seu componente utiliza "Q-learning"? Se sim, deve implementar "IUsesQLearning";
• Seu componente mantém estatísticas de correspondências positivas/negativas? Se sim, implemente "ITracksMatchStatistics";
• Seu componente pode ser apagado pelo sistema? Se sim, deve implementar "IDeletable";

REQUISITOS PARA IMPLEMENTAÇÃO DE UMA CLASSE CUSTOMIZADA

1. Deve existir uma classe "Factory", a ser utilizada pelo "AgentInitializer" para gerar uma instância do componente.
2. Deve existir uma classe "Parameters", que deverá armazenar itens que possibilitem um ajuste fino do funcionamento do componente.
3. O componente deve possuir um método "Commit()" - para associar o componente às estruturas de seu subsistema - e um método "Retract()" - para desativar o componente, permitindo que seja alterado.

Implementando uma classe "Factory"

 

Uma nova classe "Factory" deve implementar uma das seguintes interfaces, onde "<T>" é a classe sendo criada:

• IimplicitComponentFactory<T> - para objetos "ImplicitComponent"
• IActionRuleFactory<T> - para objetos "ActionRule"
• IAssociativeRuleFactory<T> - para objetos "AssociativeRule"
• IDriveFactory<T> - para objetos "Drive"

 

É indicado que as classes "Factory" sejam um sigleton, criado como uma classe estática interna, dentro da classe do novo componente.

 

 

 

 

Para receber os parâmetros de criação do componente, via "AgentInitializer", a implementação da "Factory" deve fazer uso da funcionalidade de parâmetros dinâmicos do C# no método "Generate()" onde, internamente, deverá ser feito o "parsing" dos parâmetros, reconhecidos pelo seu tipo:

 

 

 

 

Um detalhe importante é, através desse método, não é possível passar 2 parâmetros de mesmo tipo.

 

A indicação fornecida é que o método "Generate()" deve lançar exceções sempre que houver problemas com os parâmetros fornecidos.

 

É possível considerar parâmetros OPCIONAIS, como por exemplo a especificação de um delegate "EligibilityChecker", conforme discutido na parte anterior do tutorial.

 

Por fim, durante o método "Generate()", é importante listar todos os parâmetros de inicialização recebidos dentro do elemento "ClarionComponent.FactoryParameters"; com isso o sistema torna-se capaz de gerar "clones" a partir dessa classe - por exemplo durante o processo de refinamento de uma regra - passando todos os parâmetros necessários.

 

 

Implementação da classe "Parameters"

 

Essa classe deve armazenar todos os parâmetros de ajuste de funcionamento de um componente - diferentes dos parâmetros de inicialização - permitindo o seu controle externo, conforme visto na parte 4 do tutorial.

 

Todo componente padrão do Clarion possui uma instância global (estática) da sua classe "Parameters" correspondente, além de uma instância local, correspondente a cada objeto criado; também conforme já visto, os valores da instância global são utilizados para inicializar a instância local de cada novo objeto do componente.

 

A instância global da classe "Parameters" é opcional; já a instância local é obrigatória.

 

De forma semelhante à classe "Factory", existe a recomendação que uma classe "Parameters" seja interna à classe do novo componente.

 

 

 

A classe "Parameters" de um novo componente deve SEMPRE derivar da classe "Parameters" do componente base, uma vez que é necessário que todos os parâmetros da classe "pai" sejam incluídos.

 

 

A instância local da classe "Parameters" deve ser criada ao mesmo tempo que uma nova instância do componente; isso pode ser feito em 2 momentos:

 

1. No construtor do componente:

 

 

 

2. No método "Generate()" da "Factory":

 

 

 

A segunda opção é preferida por possibilitar que uma instância da classe "Parameters" seja fornecida como parâmetro de entrada para a geração de um novo objeto, permitindo assim que parâmetros já ajustados sejam utilizados para criar novos objetos. Nesse caso, é importante que seja realizada uma CÓPIA dos valores armazenados na instância da classe "Parameters" fornecida como entrada, para evitar que duas instâncias do componente compartilhem uma mesma instância.

 

Uma última modificação para utilização da instância local da classe "Parameters" é a especialização da propriedade "Parameters" - herdada da classe "pai" - para que seja feita a conversão para a nova classe "Parameters", evitando assim a necessidade de "casting" explícito sempre que for ser utilizada para ajustes:

 

 

 

Implementando os métodos "Commit()" e "Retract()"

SERIALIZAÇÃO