polaris-framework
v2.1.0
Published
Multi-agent decision-making framework with flat inference and a 4-layer creative pipeline
Downloads
1,878
Maintainers
Readme
��#� �P�O�L�A�R�I�S� �F�r�a�m�e�w�o�r�k� �v�2�.�1�
�
�<�i�m�g� �s�r�c�=�"�h�t�t�p�s�:�/�/�g�i�t�h�u�b�.�c�o�m�/�u�s�e�r�-�a�t�t�a�c�h�m�e�n�t�s�/�a�s�s�e�t�s�/�6�5�1�b�4�7�8�3�-�9�1�7�5�-�4�9�7�0�-�a�9�6�5�-�1�8�0�6�5�c�e�8�1�7�e�c�"� �a�l�t�=�"�P�O�L�A�R�I�S� �L�o�g�o�"� �w�i�d�t�h�=�"�3�0�0�"� �/�>�
�
���P�O�L�A�R�I�S��� �(�P�o�l�i�c�y� �O�p�t�i�m�i�z�a�t�i�o�n� �v�i�a� �L�a�y�e�r�e�d� �A�g�e�n�t�s� �a�n�d� �R�e�c�u�r�s�i�v�e� �I�n�f�e�r�e�n�c�e� �S�e�a�r�c�h�)� � �A� �m�u�l�t�i�-�a�g�e�n�t� �d�e�c�i�s�i�o�n�-�m�a�k�i�n�g� �f�r�a�m�e�w�o�r�k� �w�i�t�h� �d�u�a�l� �e�x�e�c�u�t�i�o�n� �m�o�d�e�s�:� �f�l�a�t� �p�a�r�a�l�l�e�l� �i�n�f�e�r�e�n�c�e� �a�n�d� �a� �4�-�l�a�y�e�r� �c�r�e�a�t�i�v�e� �p�i�p�e�l�i�n�e�.�
�
�[�!�[�n�p�m� �v�e�r�s�i�o�n�]�(�h�t�t�p�s�:�/�/�i�m�g�.�s�h�i�e�l�d�s�.�i�o�/�n�p�m�/�v�/�p�o�l�a�r�i�s�-�f�r�a�m�e�w�o�r�k�.�s�v�g�)�]�(�h�t�t�p�s�:�/�/�w�w�w�.�n�p�m�j�s�.�c�o�m�/�p�a�c�k�a�g�e�/�p�o�l�a�r�i�s�-�f�r�a�m�e�w�o�r�k�)�
�[�!�[�L�i�c�e�n�s�e�:� �M�I�T�]�(�h�t�t�p�s�:�/�/�i�m�g�.�s�h�i�e�l�d�s�.�i�o�/�b�a�d�g�e�/�L�i�c�e�n�s�e�-�M�I�T�-�b�l�u�e�.�s�v�g�)�]�(�L�I�C�E�N�S�E�)�
�[�!�[�N�o�d�e�.�j�s�]�(�h�t�t�p�s�:�/�/�i�m�g�.�s�h�i�e�l�d�s�.�i�o�/�b�a�d�g�e�/�n�o�d�e�-�%�3�E�%�3�D�1�8�.�0�.�0�-�b�r�i�g�h�t�g�r�e�e�n�.�s�v�g�)�]�(�h�t�t�p�s�:�/�/�n�o�d�e�j�s�.�o�r�g�)�
�
�#�#� �W�h�a�t�'�s� �N�e�w� �i�n� �v�2�.�1�
�
�-� ���R�a�t�e� �L�i�m�i�t�e�r� �I�n�t�e�g�r�a�t�i�o�n��� � �B�u�i�l�t�-�i�n� �p�r�o�v�i�d�e�r�-�a�w�a�r�e� �r�a�t�e� �l�i�m�i�t�i�n�g� �w�i�t�h� �j�i�t�t�e�r� �n�o�w� �w�i�r�e�d� �i�n�t�o� �t�h�e� �e�n�g�i�n�e�'�s� �p�a�r�a�l�l�e�l� �e�x�e�c�u�t�i�o�n�,� �p�r�e�v�e�n�t�i�n�g� �4�2�9� �e�r�r�o�r�s� �a�u�t�o�m�a�t�i�c�a�l�l�y�
�-� ���A�P�I� �K�e�y� �V�a�l�i�d�a�t�i�o�n��� � �A�l�l� �a�g�e�n�t�s� �(�O�p�e�n�A�I�,� �A�n�t�h�r�o�p�i�c�,� �G�o�o�g�l�e�)� �n�o�w� �v�a�l�i�d�a�t�e� �A�P�I� �k�e�y�s� �a�t� �c�o�n�s�t�r�u�c�t�i�o�n� �t�i�m�e� �w�i�t�h� �c�l�e�a�r� �e�r�r�o�r� �m�e�s�s�a�g�e�s�
�-� ���R�e�t�r�y�a�b�l�e� �E�r�r�o�r� �H�i�e�r�a�r�c�h�y��� � ��P�o�l�a�r�i�s�E�r�r�o�r�� �n�o�w� �c�a�r�r�i�e�s� �a� ��r�e�t�r�y�a�b�l�e�� �f�l�a�g�;� �n�e�w� ��A�P�I�E�r�r�o�r�� �s�u�b�c�l�a�s�s� �a�u�t�o�-�c�l�a�s�s�i�f�i�e�s� �t�r�a�n�s�i�e�n�t� �f�a�i�l�u�r�e�s� �(�4�2�9�,� �5�x�x�)� �a�s� �r�e�t�r�y�a�b�l�e�
�-� ���T�e�m�p�e�r�a�t�u�r�e� �C�l�a�m�p�i�n�g��� � �A�g�e�n�t� �t�e�m�p�e�r�a�t�u�r�e�s� �a�r�e� �c�l�a�m�p�e�d� �t�o� ��[�0�,� �2�]�� �a�t� �c�o�n�s�t�r�u�c�t�i�o�n�,� �p�r�e�v�e�n�t�i�n�g� �i�n�v�a�l�i�d� �A�P�I� �r�e�q�u�e�s�t�s�
�-� ���P�i�p�e�l�i�n�e� �C�a�c�h�i�n�g��� � ��L�a�y�e�r�P�i�p�e�l�i�n�e�� �i�n�s�t�a�n�c�e�s� �a�r�e� �c�a�c�h�e�d� �a�c�r�o�s�s� �i�n�f�e�r�e�n�c�e�s� �f�o�r� �r�e�d�u�c�e�d� �a�l�l�o�c�a�t�i�o�n� �o�v�e�r�h�e�a�d�
�-� ���S�e�c�u�r�e� �S�e�s�s�i�o�n� �I�D�s��� � �U�s�e�s� ��c�r�y�p�t�o�.�r�a�n�d�o�m�U�U�I�D�(�)�� �i�n�s�t�e�a�d� �o�f� ��M�a�t�h�.�r�a�n�d�o�m�(�)�� �f�o�r� �c�r�y�p�t�o�g�r�a�p�h�i�c�a�l�l�y� �s�o�u�n�d� �s�e�s�s�i�o�n� �i�d�e�n�t�i�f�i�e�r�s�
�-� ���R�e�d�u�c�e�d� �D�e�p�e�n�d�e�n�c�i�e�s��� � �R�e�m�o�v�e�d� �u�n�u�s�e�d� ��u�u�i�d��,� ��j�e�s�t��,� ��t�s�-�j�e�s�t��,� ��@�t�y�p�e�s�/�j�e�s�t�� �p�a�c�k�a�g�e�s�
�-� ���S�t�r�i�c�t�e�r� �T�y�p�e�s��� � �E�l�i�m�i�n�a�t�e�d� �m�u�l�t�i�p�l�e� ��a�n�y�� �c�a�s�t�s� �i�n� �a�g�e�n�t� �i�m�p�l�e�m�e�n�t�a�t�i�o�n�s�
�
�#�#�#� �P�r�e�v�i�o�u�s� �(�v�2�.�0�)�
�
�-� ���P�o�l�a�r�i�s� �C�r�e�a�t�i�v�a� �P�i�p�e�l�i�n�e��� � �4�-�l�a�y�e�r� �c�r�e�a�t�i�v�e� �p�i�p�e�l�i�n�e� �(�D�i�v�e�r�g�e�n�t� ��! �I�n�q�u�i�s�i�t�o�r� ��! �S�y�n�t�h�e�s�i�z�e�r� ��! �O�r�c�h�e�s�t�r�a�t�o�r�)� �w�i�t�h� �d�e�c�a�y�-�b�a�s�e�d� �r�e�i�n�j�e�c�t�i�o�n� �l�o�o�p�
�-� ���S�t�r�a�t�e�g�y� �P�a�t�t�e�r�n��� � �L�a�y�e�r�-�b�l�i�n�d� �a�g�e�n�t�s� �w�i�t�h� �i�n�j�e�c�t�e�d� �p�r�o�m�p�t�/�o�u�t�p�u�t� �s�t�r�a�t�e�g�i�e�s�
�-� ���S�t�r�u�c�t�u�r�e�d� �O�u�t�p�u�t�s��� � �O�p�e�n�A�I� ��j�s�o�n�_�s�c�h�e�m�a�� �f�o�r� �d�e�t�e�r�m�i�n�i�s�t�i�c� �p�a�r�s�i�n�g� �i�n� �L�a�y�e�r�s� �2� �&� �4�
�-� ���R�O�I�-�A�w�a�r�e� �R�o�u�t�i�n�g��� � �T�o�k�e�n� �b�u�d�g�e�t� �t�r�a�c�k�i�n�g� �w�i�t�h� �f�o�r�c�e�d� �d�e�l�i�v�e�r�y� �a�t� �b�u�d�g�e�t� �e�x�h�a�u�s�t�i�o�n�
�-� ���A�b�o�r�t�C�o�n�t�r�o�l�l�e�r� �T�i�m�e�o�u�t�s��� � �P�e�r�-�a�g�e�n�t� �l�a�t�e�n�c�y� �b�o�u�n�d�i�n�g� �i�n� �L�a�y�e�r� �1�
�-� ���D�u�a�l�-�M�o�d�e� �E�n�g�i�n�e��� � ��P�o�l�a�r�i�s�E�n�g�i�n�e�� �s�u�p�p�o�r�t�s� �b�o�t�h� ��"�f�l�a�t�"�� �a�n�d� ��"�p�i�p�e�l�i�n�e�"�� �m�o�d�e�s�
�
�#�#� �Q�u�i�c�k� �S�t�a�r�t�
�
�#�#�#� �I�n�s�t�a�l�l�a�t�i�o�n�
�
����b�a�s�h�
�p�n�p�m� �a�d�d� �p�o�l�a�r�i�s�-�f�r�a�m�e�w�o�r�k�
�#� �o�r�
�n�p�m� �i�n�s�t�a�l�l� �p�o�l�a�r�i�s�-�f�r�a�m�e�w�o�r�k�
����
�
�#�#�#� �E�n�v�i�r�o�n�m�e�n�t� �S�e�t�u�p�
�
����b�a�s�h�
�c�p� �.�e�n�v�.�e�x�a�m�p�l�e� �.�e�n�v�
�#� �E�d�i�t� �.�e�n�v� �w�i�t�h� �y�o�u�r� �A�P�I� �k�e�y�s�
����
�
�R�e�q�u�i�r�e�d� �k�e�y�s� �d�e�p�e�n�d� �o�n� �w�h�i�c�h� �p�r�o�v�i�d�e�r�s� �y�o�u� �u�s�e�:�
�
����e�n�v�
�O�P�E�N�A�I�_�A�P�I�_�K�E�Y�=�s�k�-�.�.�.� � � � � � � � �#� �F�o�r� �O�p�e�n�A�I� �a�g�e�n�t�s� �+� �p�i�p�e�l�i�n�e� �m�o�d�e�
�A�N�T�H�R�O�P�I�C�_�A�P�I�_�K�E�Y�=�s�k�-�a�n�t�-�.�.�.� �#� �F�o�r� �A�n�t�h�r�o�p�i�c� �a�g�e�n�t�s�
�G�O�O�G�L�E�_�A�P�I�_�K�E�Y�=�A�I�.�.�.� � � � � � � � � �#� �F�o�r� �G�o�o�g�l�e� �a�g�e�n�t�s�
����
�
�#�#�#� �F�l�a�t� �M�o�d�e� �(�M�u�l�t�i�-�A�g�e�n�t� �I�n�f�e�r�e�n�c�e�)�
�
�T�h�e� �s�i�m�p�l�e�s�t� �w�a�y� �t�o� �u�s�e� �P�O�L�A�R�I�S� � �m�u�l�t�i�p�l�e� �a�g�e�n�t�s� �e�v�a�l�u�a�t�e� �t�h�e� �s�a�m�e� �s�t�a�t�e� �i�n� �p�a�r�a�l�l�e�l�,� �e�a�c�h� �f�r�o�m� �t�h�e�i�r� �a�s�s�i�g�n�e�d� �r�o�l�e�'�s� �p�e�r�s�p�e�c�t�i�v�e�.�
�
����t�y�p�e�s�c�r�i�p�t�
�i�m�p�o�r�t� �{� �T�a�s�k�B�u�i�l�d�e�r�,� �o�p�e�n�A�i�A�g�e�n�t�,� �P�o�l�a�r�i�s�E�n�g�i�n�e� �}� �f�r�o�m� �"�p�o�l�a�r�i�s�-�f�r�a�m�e�w�o�r�k�"�;�
�
�/�/� �1�.� �D�e�f�i�n�e� �y�o�u�r� �t�a�s�k� �w�i�t�h� �r�o�l�e�s�
�c�o�n�s�t� �t�a�s�k� �=� �T�a�s�k�B�u�i�l�d�e�r�.�c�r�e�a�t�e�(�"�a�n�a�l�y�s�i�s�"�,� �"�S�t�r�a�t�e�g�y� �A�n�a�l�y�s�i�s�"�)�
� � �.�d�e�s�c�r�i�p�t�i�o�n�(�"�A�n�a�l�y�z�e� �a� �b�u�s�i�n�e�s�s� �s�t�r�a�t�e�g�y� �f�r�o�m� �m�u�l�t�i�p�l�e� �p�e�r�s�p�e�c�t�i�v�e�s�"�)�
� � �.�c�o�m�m�o�n�D�o�m�a�i�n�(�"�G�E�N�E�R�A�L�"�)�
� � �.�c�o�m�m�o�n�R�o�l�e�s�(�[�"�A�N�A�L�Y�S�T�"�,� �"�R�I�S�K�Y�"�,� �"�C�O�N�S�E�R�V�A�T�I�V�E�"�]�)�
� � �.�g�o�a�l�s�(�"�C�o�m�p�r�e�h�e�n�s�i�v�e� �s�t�r�a�t�e�g�y� �a�n�a�l�y�s�i�s�"�)�
� � �.�b�u�i�l�d�(�)�;�
�
�/�/� �2�.� �C�r�e�a�t�e� �r�o�l�e�-�a�w�a�r�e� �a�g�e�n�t�s� �(�p�r�o�m�p�t�s� �a�r�e� �b�u�i�l�t� �a�u�t�o�m�a�t�i�c�a�l�l�y� �f�r�o�m� �r�o�l�e� �+� �t�a�s�k�)�
�c�o�n�s�t� �a�g�e�n�t�s� �=� �[�
� � �o�p�e�n�A�i�A�g�e�n�t�(�{� �r�o�l�e�:� �t�a�s�k�.�r�o�l�e�s�.�A�N�A�L�Y�S�T�,� �t�a�s�k�,� �m�o�d�e�l�:� �"�g�p�t�-�4�o�"� �}�)�,�
� � �o�p�e�n�A�i�A�g�e�n�t�(�{� �r�o�l�e�:� �t�a�s�k�.�r�o�l�e�s�.�R�I�S�K�Y�,� �t�a�s�k�,� �m�o�d�e�l�:� �"�g�p�t�-�4�o�"�,� �t�e�m�p�e�r�a�t�u�r�e�:� �0�.�9� �}�)�,�
� � �o�p�e�n�A�i�A�g�e�n�t�(�{� �r�o�l�e�:� �t�a�s�k�.�r�o�l�e�s�.�C�O�N�S�E�R�V�A�T�I�V�E�,� �t�a�s�k�,� �m�o�d�e�l�:� �"�g�p�t�-�4�o�-�m�i�n�i�"�,� �t�e�m�p�e�r�a�t�u�r�e�:� �0�.�3� �}�)�,�
�]�;�
�
�/�/� �3�.� �R�u�n� �i�n�f�e�r�e�n�c�e�
�c�o�n�s�t� �e�n�g�i�n�e� �=� �n�e�w� �P�o�l�a�r�i�s�E�n�g�i�n�e�(�{� �t�a�s�k�,� �a�g�e�n�t�s� �}�)�;�
�c�o�n�s�t� �r�e�s�u�l�t� �=� �a�w�a�i�t� �e�n�g�i�n�e�.�i�n�f�e�r�e�n�c�e�(�{� �s�t�a�t�e�,� �a�c�t�i�o�n�s� �}�)�;�
�
�/�/� �r�e�s�u�l�t�.�a�g�e�n�t�O�u�t�p�u�t�s� ��! �a�r�r�a�y� �o�f� �A�g�e�n�t�O�u�t�p�u�t� �(�s�c�o�r�e�,� �c�o�n�f�i�d�e�n�c�e�,� �r�e�a�s�o�n�i�n�g�)�
�/�/� �r�e�s�u�l�t�.�s�e�n�t�i�n�e�l�A�n�a�l�y�s�i�s� ��! �b�i�a�s� �d�e�t�e�c�t�i�o�n� �a�n�d� �d�i�v�e�r�s�i�t�y� �m�e�t�r�i�c�s� �(�i�f� �s�e�n�t�i�n�e�l� �e�n�a�b�l�e�d�)�
�/�/� �r�e�s�u�l�t�.�r�e�c�o�m�m�e�n�d�a�t�i�o�n� ��! �c�o�n�s�e�n�s�u�s�-�b�a�s�e�d� �a�c�t�i�o�n� �r�e�c�o�m�m�e�n�d�a�t�i�o�n�
����
�
�#�#�#� �P�i�p�e�l�i�n�e� �M�o�d�e� �(�P�o�l�a�r�i�s� �C�r�e�a�t�i�v�a�)�
�
�F�o�r� �c�o�m�p�l�e�x� �c�r�e�a�t�i�v�e� �t�a�s�k�s� �t�h�a�t� �b�e�n�e�f�i�t� �f�r�o�m� �i�t�e�r�a�t�i�v�e� �r�e�f�i�n�e�m�e�n�t�.� �F�o�u�r� �s�p�e�c�i�a�l�i�z�e�d� �l�a�y�e�r�s� �c�o�l�l�a�b�o�r�a�t�e� �t�h�r�o�u�g�h� �a� �d�e�c�a�y� �l�o�o�p�.�
�
����t�y�p�e�s�c�r�i�p�t�
�i�m�p�o�r�t� �{�
� � �P�o�l�a�r�i�s�E�n�g�i�n�e�,�
� � �O�p�e�n�A�I�S�t�r�a�t�e�g�y�A�g�e�n�t�,�
� � �D�i�v�e�r�g�e�n�t�P�r�o�m�p�t�S�t�r�a�t�e�g�y�,�
� � �D�i�v�e�r�g�e�n�t�O�u�t�p�u�t�P�a�r�s�e�r�,�
� � �I�n�q�u�i�s�i�t�o�r�P�r�o�m�p�t�S�t�r�a�t�e�g�y�,�
� � �I�n�q�u�i�s�i�t�o�r�O�u�t�p�u�t�P�a�r�s�e�r�,�
� � �S�y�n�t�h�e�s�i�z�e�r�P�r�o�m�p�t�S�t�r�a�t�e�g�y�,�
� � �S�y�n�t�h�e�s�i�z�e�r�O�u�t�p�u�t�P�a�r�s�e�r�,�
� � �O�r�c�h�e�s�t�r�a�t�o�r�P�r�o�m�p�t�S�t�r�a�t�e�g�y�,�
� � �O�r�c�h�e�s�t�r�a�t�o�r�O�u�t�p�u�t�P�a�r�s�e�r�,�
� � �I�N�Q�U�I�S�I�T�O�R�_�S�C�H�E�M�A�,�
� � �O�R�C�H�E�S�T�R�A�T�O�R�_�S�C�H�E�M�A�,�
�}� �f�r�o�m� �"�p�o�l�a�r�i�s�-�f�r�a�m�e�w�o�r�k�"�;�
�
�/�/� �C�r�e�a�t�e� �l�a�y�e�r�-�s�p�e�c�i�f�i�c� �a�g�e�n�t�s� �(�s�a�m�e� �c�l�a�s�s�,� �d�i�f�f�e�r�e�n�t� �s�t�r�a�t�e�g�i�e�s�)�
�c�o�n�s�t� �d�i�v�e�r�g�e�n�t�A�g�e�n�t�s� �=� �[�
� � �n�e�w� �O�p�e�n�A�I�S�t�r�a�t�e�g�y�A�g�e�n�t�(�{�
� � � � �n�a�m�e�:� �"�E�x�p�l�o�r�e�r�-�A�"�,�
� � � � �m�o�d�e�l�:� �"�g�p�t�-�4�o�"�,�
� � � � �r�o�l�e�:� �e�x�p�l�o�r�e�r�R�o�l�e�,�
� � � � �t�a�s�k�,�
� � � � �p�r�o�m�p�t�S�t�r�a�t�e�g�y�:� �n�e�w� �D�i�v�e�r�g�e�n�t�P�r�o�m�p�t�S�t�r�a�t�e�g�y�(�)�,�
� � � � �o�u�t�p�u�t�P�a�r�s�e�r�:� �n�e�w� �D�i�v�e�r�g�e�n�t�O�u�t�p�u�t�P�a�r�s�e�r�(�)�,�
� � �}�)�,�
� � �/�/� �.�.�.�m�o�r�e� �d�i�v�e�r�g�e�n�t� �a�g�e�n�t�s� �f�o�r� �d�i�v�e�r�s�i�t�y�
�]�;�
�
�c�o�n�s�t� �e�n�g�i�n�e� �=� �n�e�w� �P�o�l�a�r�i�s�E�n�g�i�n�e�(�{�
� � �t�a�s�k�,�
� � �a�g�e�n�t�s�:� �[�]�,�
� � �m�o�d�e�:� �"�p�i�p�e�l�i�n�e�"�,�
� � �p�i�p�e�l�i�n�e�C�o�n�f�i�g�:� �{�
� � � � �t�a�s�k�,�
� � � � �d�i�v�e�r�g�e�n�t�A�g�e�n�t�s�,�
� � � � �i�n�q�u�i�s�i�t�o�r�A�g�e�n�t�,� �/�/� �F�i�l�t�e�r�s� �w�i�t�h� �S�t�r�u�c�t�u�r�e�d� �O�u�t�p�u�t�s�
� � � � �s�y�n�t�h�e�s�i�z�e�r�A�g�e�n�t�,� �/�/� �W�e�a�v�e�s� �i�n�t�o� �c�o�h�e�s�i�v�e� �d�r�a�f�t�
� � � � �o�r�c�h�e�s�t�r�a�t�o�r�A�g�e�n�t�,� �/�/� �D�e�c�i�d�e�s�:� �d�e�l�i�v�e�r� �o�r� �r�e�r�u�n�
� � � � �d�e�c�a�y�C�o�n�f�i�g�:� �{�
� � � � � � �m�a�x�I�t�e�r�a�t�i�o�n�s�:� �5�,�
� � � � � � �b�a�s�e�T�e�m�p�e�r�a�t�u�r�e�:� �0�.�8�,�
� � � � � � �t�e�m�p�e�r�a�t�u�r�e�I�n�c�r�e�m�e�n�t�:� �0�.�0�5�,�
� � � � � � �t�e�m�p�e�r�a�t�u�r�e�C�e�i�l�i�n�g�:� �1�.�2�,�
� � � � � � �p�r�o�m�p�t�M�u�t�a�t�i�o�n�F�a�c�t�o�r�:� �0�.�1�,�
� � � � � � �t�o�k�e�n�B�u�d�g�e�t�:� �1�0�0�0�0�0�,�
� � � � � � �a�g�e�n�t�T�i�m�e�o�u�t�M�s�:� �3�0�0�0�0�,�
� � � � � � �m�i�n�S�u�r�v�i�v�i�n�g�A�g�e�n�t�s�:� �1�,�
� � � � �}�,�
� � �}�,�
�}�)�;�
�
�c�o�n�s�t� �r�e�s�u�l�t� �=� �a�w�a�i�t� �e�n�g�i�n�e�.�i�n�f�e�r�e�n�c�e�(�{� �s�t�a�t�e�,� �a�c�t�i�o�n�s� �}�)�;�
�/�/� �r�e�s�u�l�t�.�p�i�p�e�l�i�n�e�R�e�s�u�l�t�.�f�i�n�a�l�O�u�t�p�u�t� ��! �t�h�e� �r�e�f�i�n�e�d� �c�r�e�a�t�i�v�e� �o�u�t�p�u�t�
�/�/� �r�e�s�u�l�t�.�p�i�p�e�l�i�n�e�R�e�s�u�l�t�.�t�o�t�a�l�I�t�e�r�a�t�i�o�n�s� ��! �h�o�w� �m�a�n�y� �d�e�c�a�y� �c�y�c�l�e�s� �r�a�n�
�/�/� �r�e�s�u�l�t�.�p�i�p�e�l�i�n�e�R�e�s�u�l�t�.�i�t�e�r�a�t�i�o�n�B�r�e�a�k�d�o�w�n�s� ��! �p�e�r�-�i�t�e�r�a�t�i�o�n� �t�i�m�i�n�g� �a�n�d� �v�e�r�d�i�c�t�s�
����
�
�>� �S�e�e� �[��e�x�a�m�p�l�e�s�/�p�i�p�e�l�i�n�e�-�d�e�m�o�.�t�s��]�(�e�x�a�m�p�l�e�s�/�p�i�p�e�l�i�n�e�-�d�e�m�o�.�t�s�)� �f�o�r� �a� �c�o�m�p�l�e�t�e�,� �r�u�n�n�a�b�l�e� �p�i�p�e�l�i�n�e� �e�x�a�m�p�l�e�.�
�
�#�#�#� �O�n�e�-�L�i�n�e� �S�e�t�u�p�
�
�F�o�r� �q�u�i�c�k� �p�r�o�t�o�t�y�p�i�n�g� �w�i�t�h� �s�e�n�s�i�b�l�e� �d�e�f�a�u�l�t�s�:�
�
����t�y�p�e�s�c�r�i�p�t�
�i�m�p�o�r�t� �{� �q�u�i�c�k�S�t�a�r�t� �}� �f�r�o�m� �"�p�o�l�a�r�i�s�-�f�r�a�m�e�w�o�r�k�"�;�
�
�c�o�n�s�t� �{� �p�r�e�s�e�t�,� �c�r�e�a�t�e�E�n�g�i�n�e� �}� �=� �q�u�i�c�k�S�t�a�r�t�(�"�c�h�e�s�s�"�)�;�
�c�o�n�s�t� �e�n�g�i�n�e� �=� �c�r�e�a�t�e�E�n�g�i�n�e�(�{� �o�p�e�n�a�i�:� �"�y�o�u�r�-�a�p�i�-�k�e�y�"� �}�)�;�
�c�o�n�s�t� �r�e�s�u�l�t� �=� �a�w�a�i�t� �e�n�g�i�n�e�.�i�n�f�e�r�e�n�c�e�(�{� �s�t�a�t�e� �}�)�;�
����
�
�A�v�a�i�l�a�b�l�e� �p�r�e�s�e�t�s�:� ��"�c�h�e�s�s�"��,� ��"�d�e�b�a�t�e�"��,� ��"�d�e�c�i�s�i�o�n�"��,� ��"�g�e�n�e�r�a�l�"��.�
�
�#�#� �A�r�c�h�i�t�e�c�t�u�r�e�
�
�P�O�L�A�R�I�S� �h�a�s� �t�w�o� �e�x�e�c�u�t�i�o�n� �m�o�d�e�s� �s�h�a�r�i�n�g� �t�h�e� �s�a�m�e� �a�g�e�n�t� �s�y�s�t�e�m�,� �t�a�s�k� �d�e�f�i�n�i�t�i�o�n�s�,� �a�n�d� �o�u�t�p�u�t� �f�o�r�m�a�t�:�
�
����
�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%%
�% � � � � � � � � � � � � � � � � � �P�o�l�a�r�i�s�E�n�g�i�n�e� � � � � � � � � � � � � � � � � � � �%
�% � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �%
�% � � �m�o�d�e�:� �"�f�l�a�t�"� � � � � � � � � � � �m�o�d�e�:� �"�p�i�p�e�l�i�n�e�"� � � � � � � � �%
�% � � �%�%�%�%�%�%�%�%�%�%�%% � � � � � � � � � � �%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%% � � �%
�% � � �% �P�a�r�a�l�l�e�l� �% � � � � � � � � � � �% � �L�a�y�e�r�P�i�p�e�l�i�n�e� � � �% � � �%
�% � � �% �A�g�e�n�t�s� � � �% � � � � � � � � � � �% � �(�4�-�l�a�y�e�r� �l�o�o�p�)� � �% � � �%
�% � � �%�%�%�%�%�%�%�%�%�%�%% � � � � � � � � � � �%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%% � � �%
�% � � � � � � � � �% � � � � � � � � � � � � � � � � � � � � � � � �% � � � � � � � � � � � � � � �%
�% � � � � � � � � �%�%�%�%�%�%�%�%�%,%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%% � � � � � � � � � � � � � � �%
�% � � � � � � � � � � � � � � � � � ��% � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �%
�% � � � � � � � � � � � �E�n�g�i�n�e�O�u�t�p�u�t� � � � � � � � � � � � � � � � � � � � � � � � � � � �%
�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%�%%
����
�
�#�#�#� �F�l�a�t� �I�n�f�e�r�e�n�c�e�
�
�A�l�l� �a�g�e�n�t�s� �e�v�a�l�u�a�t�e� �t�h�e� �s�a�m�e� �s�t�a�t�e� �i�n� �p�a�r�a�l�l�e�l� �a�n�d� �r�e�t�u�r�n� �i�n�d�e�p�e�n�d�e�n�t� �o�u�t�p�u�t�s�.� �E�a�c�h� �a�g�e�n�t� �b�u�i�l�d�s� �i�t�s� �o�w�n� �p�r�o�m�p�t� �f�r�o�m� �i�t�s� ��A�g�e�n�t�R�o�l�e�� �a�n�d� ��P�o�l�a�r�i�s�E�n�g�i�n�e�T�a�s�k��.� �N�o� �i�n�t�e�r�-�a�g�e�n�t� �c�o�m�m�u�n�i�c�a�t�i�o�n� � �p�u�r�e� �p�a�r�a�l�l�e�l� �e�v�a�l�u�a�t�i�o�n� �w�i�t�h� �b�u�i�l�t�-�i�n� �r�a�t�e� �l�i�m�i�t�i�n�g�.�
�
���B�e�s�t� �f�o�r�:��� �s�c�o�r�i�n�g�,� �c�l�a�s�s�i�f�i�c�a�t�i�o�n�,� �s�i�m�p�l�e� �a�n�a�l�y�s�i�s�,� �q�u�i�c�k� �m�u�l�t�i�-�p�e�r�s�p�e�c�t�i�v�e� �e�v�a�l�u�a�t�i�o�n�.�
�
�#�#�#� �P�i�p�e�l�i�n�e� �(�P�o�l�a�r�i�s� �C�r�e�a�t�i�v�a�)�
�
�A� �4�-�l�a�y�e�r� �c�r�e�a�t�i�v�e� �p�i�p�e�l�i�n�e� �w�i�t�h� �a� �d�e�c�a�y�-�b�a�s�e�d� �q�u�a�l�i�t�y� �l�o�o�p�:�
�
����
� �L�a�y�e�r� �1� � � � � � � � � � �L�a�y�e�r� �2� � � � � � � � � � �L�a�y�e�r� �3� � � � � � � � � � �L�a�y�e�r� �4�
�%�%�%�%�%�%�%�%�%�%�%% � � � �%�%�%�%�%�%�%�%�%�%�%�%�%% � � �%�%�%�%�%�%�%�%�%�%�%�%�%�%�%% � �%�%�%�%�%�%�%�%�%�%�%�%�%�%�%%
�% �D�i�v�e�r�g�e�n�t� �%�%�%�%% �I�n�q�u�i�s�i�t�o�r� �%�%�%�%% �S�y�n�t�h�e�s�i�z�e�r� � �%�%�%�%% �O�r�c�h�e�s�t�r�a�t�o�r� �%
�% �T�=�0�.�8�-�1�.�0�% � � � �% �T�=�0�.�1�-�0�.�3� � �% � � �% � �T�=�0�.�3�-�0�.�5� � � �% � �% � �T�=�0�.�1� � � � � � � �%
�% �(�p�a�r�a�l�l�e�l�)�% � � � �% �(�f�i�l�t�e�r�)� � � �% � � �% � �(�w�e�a�v�e�)� � � � � �% � �% �(�q�u�a�l�i�t�y� �g�a�t�e�)�%
�%�%�%�%�%�%�%�%�%�%�%% � � � �%�%�%�%�%�%�%�%�%�%�%�%�%% � � �%�%�%�%�%�%�%�%�%�%�%�%�%�%�%% � �%�%�%�%�%�%�%,%�%�%�%�%�%�%�%%
� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �%
� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �%�%�%�%�%�%�%�%�%�%�%�%$%
� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �% � �d�e�l�i�v�e�r�?� � �%
� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �% � �o�r� �r�e�r�u�n�?� �%
� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � ��% � � � � � � � � � � � ��%
� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �O�U�T�P�U�T� � � � � �R�E�I�N�J�E�C�T�I�O�N� ��%�%�% �L�a�y�e�r� �1�
����
�
�|� �L�a�y�e�r� �|� �N�a�m�e� � � � � � � � � � � � � �|� �T�e�m�p�e�r�a�t�u�r�e� �|� �P�u�r�p�o�s�e� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �|�
�|� �-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|�
�|� �1� � � � � �|� ���D�i�v�e�r�g�e�n�t��� � � � �|� �0�.�8� 1�.�0� � � � � �|� �P�a�r�a�l�l�e�l� �c�r�e�a�t�i�v�e� �e�x�p�l�o�r�a�t�i�o�n� �(�m�u�l�t�i�p�l�e� �a�g�e�n�t�s�)� � � �|�
�|� �2� � � � � �|� ���I�n�q�u�i�s�i�t�o�r��� � � �|� �0�.�1� 0�.�3� � � � � �|� �F�i�l�t�e�r� �f�o�r� �l�o�g�i�c�a�l� �c�o�h�e�r�e�n�c�e� �(�S�t�r�u�c�t�u�r�e�d� �O�u�t�p�u�t�s�)� �|�
�|� �3� � � � � �|� ���S�y�n�t�h�e�s�i�z�e�r��� � �|� �0�.�3� 0�.�5� � � � � �|� �W�e�a�v�e� �v�a�l�i�d�a�t�e�d� �f�r�a�g�m�e�n�t�s� �i�n�t�o� �a� �d�r�a�f�t� � � � � � � � � � � � �|�
�|� �4� � � � � �|� ���O�r�c�h�e�s�t�r�a�t�o�r��� �|� �0�.�1� � � � � � � � � �|� �R�O�I�-�a�w�a�r�e� �q�u�a�l�i�t�y� �g�a�t�e� �(�S�t�r�u�c�t�u�r�e�d� �O�u�t�p�u�t�s�)� � � � � � � �|�
�
�T�h�e� �O�r�c�h�e�s�t�r�a�t�o�r�'�s� ��d�e�l�i�v�e�r��/��r�e�r�u�n�� �d�e�c�i�s�i�o�n� �t�r�i�g�g�e�r�s� �t�h�e� ���d�e�c�a�y� �l�o�o�p���:� �o�n� �r�e�r�u�n�,� �L�a�y�e�r� �1� �r�e�c�e�i�v�e�s� �a�c�c�u�m�u�l�a�t�e�d� �c�o�r�r�e�c�t�i�o�n� �f�e�e�d�b�a�c�k� �a�n�d� �p�r�o�g�r�e�s�s�i�v�e�l�y� �h�i�g�h�e�r� �t�e�m�p�e�r�a�t�u�r�e�s� �u�n�t�i�l� �d�e�l�i�v�e�r�y� �o�r� �b�u�d�g�e�t� �e�x�h�a�u�s�t�i�o�n�.�
�
���B�e�s�t� �f�o�r�:��� �c�r�e�a�t�i�v�e� �w�r�i�t�i�n�g�,� �c�o�m�p�l�e�x� �s�y�n�t�h�e�s�i�s�,� �i�t�e�r�a�t�i�v�e� �r�e�f�i�n�e�m�e�n�t� �t�a�s�k�s�.�
�
�#�#�#� �S�t�r�a�t�e�g�y� �P�a�t�t�e�r�n�
�
�P�i�p�e�l�i�n�e� �a�g�e�n�t�s� �a�r�e� ���l�a�y�e�r�-�b�l�i�n�d��� � �t�h�e�y� �d�o�n�'�t� �k�n�o�w� �w�h�i�c�h� �l�a�y�e�r� �t�h�e�y�'�r�e� �i�n�.� �B�e�h�a�v�i�o�r� �i�s� �e�n�t�i�r�e�l�y� �d�e�t�e�r�m�i�n�e�d� �b�y� �t�h�e� �i�n�j�e�c�t�e�d� ��P�r�o�m�p�t�S�t�r�a�t�e�g�y�� �a�n�d� ��O�u�t�p�u�t�P�a�r�s�e�r�S�t�r�a�t�e�g�y��:�
�
����t�y�p�e�s�c�r�i�p�t�
�/�/� �S�a�m�e� �a�g�e�n�t� �c�l�a�s�s�,� �d�i�f�f�e�r�e�n�t� �s�t�r�a�t�e�g�i�e�s� ��! �d�i�f�f�e�r�e�n�t� �l�a�y�e�r� �b�e�h�a�v�i�o�r�
�n�e�w� �O�p�e�n�A�I�S�t�r�a�t�e�g�y�A�g�e�n�t�(�{�
� � �p�r�o�m�p�t�S�t�r�a�t�e�g�y�:� �n�e�w� �D�i�v�e�r�g�e�n�t�P�r�o�m�p�t�S�t�r�a�t�e�g�y�(�)�,� �/�/� �M�a�k�e�s� �i�t� �L�a�y�e�r� �1�
� � �o�u�t�p�u�t�P�a�r�s�e�r�:� �n�e�w� �D�i�v�e�r�g�e�n�t�O�u�t�p�u�t�P�a�r�s�e�r�(�)�,�
�}�)�;�
�
�n�e�w� �O�p�e�n�A�I�S�t�r�a�t�e�g�y�A�g�e�n�t�(�{�
� � �p�r�o�m�p�t�S�t�r�a�t�e�g�y�:� �n�e�w� �I�n�q�u�i�s�i�t�o�r�P�r�o�m�p�t�S�t�r�a�t�e�g�y�(�)�,� �/�/� �M�a�k�e�s� �i�t� �L�a�y�e�r� �2�
� � �o�u�t�p�u�t�P�a�r�s�e�r�:� �n�e�w� �I�n�q�u�i�s�i�t�o�r�O�u�t�p�u�t�P�a�r�s�e�r�(�)�,�
� � �s�t�r�u�c�t�u�r�e�d�O�u�t�p�u�t�S�c�h�e�m�a�:� �I�N�Q�U�I�S�I�T�O�R�_�S�C�H�E�M�A�,� �/�/� �J�S�O�N� �d�e�t�e�r�m�i�n�i�s�t�i�c� �p�a�r�s�i�n�g�
�}�)�;�
����
�
�#�#�#� �S�e�n�t�i�n�e�l� �O�v�e�r�s�i�g�h�t�
�
�O�p�t�i�o�n�a�l� �m�e�t�a�-�c�o�g�n�i�t�i�v�e� �a�n�a�l�y�s�i�s� �o�f� �a�g�e�n�t� �o�u�t�p�u�t�s�:�
�
�-� ���B�i�a�s� �D�e�t�e�c�t�i�o�n��� � �S�y�s�t�e�m�a�t�i�c�,� �t�e�m�p�o�r�a�l�,� �p�o�s�i�t�i�o�n�a�l�,� �c�o�n�f�i�r�m�a�t�i�o�n�,� �a�n�d� �a�n�c�h�o�r�i�n�g� �b�i�a�s�
�-� ���D�i�v�e�r�s�i�t�y� �A�n�a�l�y�s�i�s��� � �S�c�o�r�e� �d�i�v�e�r�s�i�t�y�,� �c�o�n�f�i�d�e�n�c�e� �s�p�r�e�a�d�,� �r�e�a�s�o�n�i�n�g� �v�a�r�i�e�t�y�
�-� ���S�c�o�r�e� �A�d�j�u�s�t�m�e�n�t�s��� � �A�u�t�o�m�a�t�i�c� �c�o�r�r�e�c�t�i�o�n�s� �w�h�e�n� �b�i�a�s� �i�s� �d�e�t�e�c�t�e�d�
�
�#�#� �A�g�e�n�t� �P�r�o�v�i�d�e�r�s�
�
�|� �P�r�o�v�i�d�e�r� � � � � � �|� �M�o�d�e�l�s� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �|� �F�e�a�t�u�r�e�s� � � � � � � � � � � � � � � � � � � � � � � � � � � � � �|�
�|� �-�-�-�-�-�-�-�-�-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|�
�|� ���O�p�e�n�A�I��� � � � �|� �G�P�T�-�5�.�4�,� �G�P�T�-�5�.�4� �M�i�n�i�,� �O�4�-�m�i�n�i� � � � � � � � � �|� �S�t�r�u�c�t�u�r�e�d� �O�u�t�p�u�t�s�,� �f�u�n�c�t�i�o�n� �c�a�l�l�i�n�g� �|�
�|� ���A�n�t�h�r�o�p�i�c��� �|� �C�l�a�u�d�e� �O�p�u�s� �4�.�8�,� �S�o�n�n�e�t� �4�.�6�,� �H�a�i�k�u� �4�.�5� �|� �L�o�n�g� �c�o�n�t�e�x�t�,� �s�a�f�e�t�y� � � � � � � � � � � � � � � � � �|�
�|� ���G�o�o�g�l�e��� � � � �|� �G�e�m�i�n�i� �3�.�5� �F�l�a�s�h�,� �G�e�m�i�n�i� �3�.�1� �P�r�o� � � � � � � �|� �M�u�l�t�i�-�m�o�d�a�l�,� �l�a�r�g�e� �c�o�n�t�e�x�t� � � � � � � � � � � �|�
�
�A�l�l� �p�r�o�v�i�d�e�r�s� �a�r�e� �c�r�e�a�t�e�d� �t�h�r�o�u�g�h� �e�r�g�o�n�o�m�i�c� �f�a�c�t�o�r�y� �f�u�n�c�t�i�o�n�s�:�
�
����t�y�p�e�s�c�r�i�p�t�
�i�m�p�o�r�t� �{� �o�p�e�n�A�i�A�g�e�n�t�,� �a�n�t�h�r�o�p�i�c�A�g�e�n�t�,� �g�o�o�g�l�e�A�g�e�n�t�,� �c�r�e�a�t�e�E�n�s�e�m�b�l�e� �}� �f�r�o�m� �"�p�o�l�a�r�i�s�-�f�r�a�m�e�w�o�r�k�"�;�
�
�/�/� �I�n�d�i�v�i�d�u�a�l� �a�g�e�n�t�s�
�c�o�n�s�t� �a�n�a�l�y�s�t� �=� �o�p�e�n�A�i�A�g�e�n�t�(�{� �r�o�l�e�,� �t�a�s�k�,� �m�o�d�e�l�:� �"�g�p�t�-�5�.�4�-�m�i�n�i�"� �}�)�;�
�c�o�n�s�t� �d�e�b�a�t�e�r� �=� �a�n�t�h�r�o�p�i�c�A�g�e�n�t�(�{� �r�o�l�e�,� �t�a�s�k�,� �m�o�d�e�l�:� �"�c�l�a�u�d�e�-�s�o�n�n�e�t�-�4�-�6�"� �}�)�;�
�c�o�n�s�t� �r�e�s�e�a�r�c�h�e�r� �=� �g�o�o�g�l�e�A�g�e�n�t�(�{� �r�o�l�e�,� �t�a�s�k�,� �m�o�d�e�l�:� �"�g�e�m�i�n�i�-�3�.�5�-�f�l�a�s�h�"� �}�)�;�
�
�/�/� �O�r� �c�r�e�a�t�e� �a� �d�i�v�e�r�s�e� �e�n�s�e�m�b�l�e� �i�n� �o�n�e� �c�a�l�l�
�c�o�n�s�t� �a�g�e�n�t�s� �=� �c�r�e�a�t�e�E�n�s�e�m�b�l�e�(�t�a�s�k�,� �{�
� � �r�o�l�e�s�:� �[�"�A�N�A�L�Y�S�T�"�,� �"�R�I�S�K�Y�"�,� �"�C�O�N�S�E�R�V�A�T�I�V�E�"�]�,�
� � �p�r�o�v�i�d�e�r�s�:� �[�"�o�p�e�n�a�i�"�,� �"�a�n�t�h�r�o�p�i�c�"�,� �"�g�o�o�g�l�e�"�]�,�
�}�)�;�
����
�
�#�#� �E�r�r�o�r� �H�a�n�d�l�i�n�g�
�
�P�O�L�A�R�I�S� �p�r�o�v�i�d�e�s� �a� �t�y�p�e�d� �e�r�r�o�r� �h�i�e�r�a�r�c�h�y� �w�i�t�h� �r�e�t�r�y�a�b�i�l�i�t�y� �c�l�a�s�s�i�f�i�c�a�t�i�o�n�:�
�
����t�y�p�e�s�c�r�i�p�t�
�i�m�p�o�r�t� �{� �P�o�l�a�r�i�s�E�r�r�o�r�,� �A�P�I�E�r�r�o�r�,� �C�o�n�f�i�g�u�r�a�t�i�o�n�E�r�r�o�r�,� �V�a�l�i�d�a�t�i�o�n�E�r�r�o�r� �}� �f�r�o�m� �"�p�o�l�a�r�i�s�-�f�r�a�m�e�w�o�r�k�"�;�
�
�t�r�y� �{�
� � �c�o�n�s�t� �r�e�s�u�l�t� �=� �a�w�a�i�t� �e�n�g�i�n�e�.�i�n�f�e�r�e�n�c�e�(�{� �s�t�a�t�e� �}�)�;�
�}� �c�a�t�c�h� �(�e�r�r�o�r�)� �{�
� � �i�f� �(�e�r�r�o�r� �i�n�s�t�a�n�c�e�o�f� �P�o�l�a�r�i�s�E�r�r�o�r�)� �{�
� � � � �c�o�n�s�o�l�e�.�l�o�g�(�e�r�r�o�r�.�c�o�d�e�)�;� �/�/� �"�A�P�I�_�E�R�R�O�R�"�,� �"�V�A�L�I�D�A�T�I�O�N�_�E�R�R�O�R�"�,� �e�t�c�.�
� � � � �c�o�n�s�o�l�e�.�l�o�g�(�e�r�r�o�r�.�r�e�t�r�y�a�b�l�e�)�;� �/�/� �t�r�u�e� �f�o�r� �4�2�9�s� �a�n�d� �5�x�x� �e�r�r�o�r�s�
� � � � �c�o�n�s�o�l�e�.�l�o�g�(�e�r�r�o�r�.�c�o�n�t�e�x�t�)�;� �/�/� �S�t�r�u�c�t�u�r�e�d� �e�r�r�o�r� �m�e�t�a�d�a�t�a�
� � �}�
�}�
����
�
�|� �E�r�r�o�r� �C�l�a�s�s� � � � � � � � � � �|� �C�o�d�e� � � � � � � � � � � � � � � � � � �|� �R�e�t�r�y�a�b�l�e� � � � � � �|� �W�h�e�n� � � � � � � � � � � � � � � � � � � � � � �|�
�|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|�
�|� ��P�o�l�a�r�i�s�E�r�r�o�r�� � � � � � � �|� ��P�O�L�A�R�I�S�_�E�R�R�O�R�� � � � � � � �|� �N�o� � � � � � � � � � � � � �|� �B�a�s�e� �c�l�a�s�s� �f�o�r� �a�l�l� �e�r�r�o�r�s� �|�
�|� ��A�P�I�E�r�r�o�r�� � � � � � � � � � � �|� ��A�P�I�_�E�R�R�O�R�� � � � � � � � � � � �|� �A�u�t�o� �(�4�2�9�/�5�x�x�)� �|� �P�r�o�v�i�d�e�r� �A�P�I� �f�a�i�l�u�r�e�s� � � � � �|�
�|� ��C�o�n�f�i�g�u�r�a�t�i�o�n�E�r�r�o�r�� �|� ��C�O�N�F�I�G�U�R�A�T�I�O�N�_�E�R�R�O�R�� �|� �N�o� � � � � � � � � � � � � �|� �I�n�v�a�l�i�d� �c�o�n�f�i�g� � � � � � � � � � � � �|�
�|� ��V�a�l�i�d�a�t�i�o�n�E�r�r�o�r�� � � � �|� ��V�A�L�I�D�A�T�I�O�N�_�E�R�R�O�R�� � � � �|� �N�o� � � � � � � � � � � � � �|� �I�n�p�u�t� �v�a�l�i�d�a�t�i�o�n� �f�a�i�l�u�r�e�s� �|�
�|� ��A�g�e�n�t�E�r�r�o�r�� � � � � � � � � �|� ��A�G�E�N�T�_�E�R�R�O�R�� � � � � � � � � �|� �N�o� � � � � � � � � � � � � �|� �A�g�e�n�t� �l�i�f�e�c�y�c�l�e� �i�s�s�u�e�s� � � � �|�
�
�#�#� �R�a�t�e� �L�i�m�i�t�i�n�g�
�
�B�u�i�l�t�-�i�n� �r�a�t�e� �l�i�m�i�t�e�r� �w�i�t�h� �j�i�t�t�e�r� �p�r�e�v�e�n�t�s� �4�2�9� �e�r�r�o�r�s� �d�u�r�i�n�g� �p�a�r�a�l�l�e�l� �e�x�e�c�u�t�i�o�n�:�
�
����t�y�p�e�s�c�r�i�p�t�
�i�m�p�o�r�t� �{� �R�a�t�e�L�i�m�i�t�e�r�,� �P�r�o�v�i�d�e�r�R�a�t�e�L�i�m�i�t�e�r�s� �}� �f�r�o�m� �"�p�o�l�a�r�i�s�-�f�r�a�m�e�w�o�r�k�"�;�
�
�/�/� �P�r�e�-�c�o�n�f�i�g�u�r�e�d� �p�r�o�v�i�d�e�r� �l�i�m�i�t�s� �(�u�s�e�d� �a�u�t�o�m�a�t�i�c�a�l�l�y� �b�y� �t�h�e� �e�n�g�i�n�e�)�
�c�o�n�s�t� �l�i�m�i�t�e�r� �=� �P�r�o�v�i�d�e�r�R�a�t�e�L�i�m�i�t�e�r�s�.�o�p�e�n�a�i�(�)�;� �/�/� �8� �c�o�n�c�u�r�r�e�n�t�,� �1�2�5�m�s� �g�a�p�
�c�o�n�s�t� �l�i�m�i�t�e�r� �=� �P�r�o�v�i�d�e�r�R�a�t�e�L�i�m�i�t�e�r�s�.�a�n�t�h�r�o�p�i�c�(�)�;� �/�/� �2� �c�o�n�c�u�r�r�e�n�t�,� �1�2�0�0�m�s� �g�a�p�
�c�o�n�s�t� �l�i�m�i�t�e�r� �=� �P�r�o�v�i�d�e�r�R�a�t�e�L�i�m�i�t�e�r�s�.�g�o�o�g�l�e�(�)�;� �/�/� �3� �c�o�n�c�u�r�r�e�n�t�,� �1�0�0�0�m�s� �g�a�p�
�
�/�/� �O�r� �c�o�n�f�i�g�u�r�e� �m�a�n�u�a�l�l�y�
�c�o�n�s�t� �c�u�s�t�o�m� �=� �n�e�w� �R�a�t�e�L�i�m�i�t�e�r�(�{�
� � �m�a�x�C�o�n�c�u�r�r�e�n�t�:� �4�,�
� � �m�i�n�D�e�l�a�y�M�s�:� �5�0�0�,�
� � �m�a�x�Q�u�e�u�e�S�i�z�e�:� �5�0�,�
�}�)�;�
�
�/�/� �S�c�h�e�d�u�l�e� �r�a�t�e�-�l�i�m�i�t�e�d� �e�x�e�c�u�t�i�o�n�
�c�o�n�s�t� �r�e�s�u�l�t� �=� �a�w�a�i�t� �l�i�m�i�t�e�r�.�s�c�h�e�d�u�l�e�(�(�)� �=�>� �a�g�e�n�t�.�e�v�a�l�u�a�t�e�(�s�t�a�t�e�)�)�;�
����
�
�>� ���N�o�t�e�:��� �T�h�e� �e�n�g�i�n�e� �a�u�t�o�m�a�t�i�c�a�l�l�y� �u�s�e�s� �t�h�e� �c�o�n�s�e�r�v�a�t�i�v�e� �r�a�t�e� �l�i�m�i�t�e�r� �w�h�e�n� �r�u�n�n�i�n�g� �a�g�e�n�t�s� �i�n� �p�a�r�a�l�l�e�l� �m�o�d�e�.� �Y�o�u� �d�o�n�'�t� �n�e�e�d� �t�o� �c�o�n�f�i�g�u�r�e� �t�h�i�s� �m�a�n�u�a�l�l�y� �u�n�l�e�s�s� �y�o�u� �w�a�n�t� �c�u�s�t�o�m� �l�i�m�i�t�s�.�
�
�#�#� �D�e�v�e�l�o�p�m�e�n�t�
�
����b�a�s�h�
�p�n�p�m� �r�u�n� �d�e�v� � � � � � � � � � � � � � �#� �W�a�t�c�h� �m�o�d�e�
�p�n�p�m� �r�u�n� �b�u�i�l�d� � � � � � � � � � � � �#� �B�u�i�l�d� �T�y�p�e�S�c�r�i�p�t�
�p�n�p�m� �t�e�s�t� � � � � � � � � � � � � � � � � �#� �A�l�l� �t�e�s�t�s� �(�9� �t�e�s�t� �s�u�i�t�e�s�)�
�p�n�p�m� �r�u�n� �t�e�s�t�:�b�a�s�i�c� � � � � � � �#� �F�r�a�m�e�w�o�r�k� �b�a�s�i�c�s�
�p�n�p�m� �r�u�n� �t�e�s�t�:�p�i�p�e�l�i�n�e� � � � �#� �P�i�p�e�l�i�n�e� �&� �s�t�r�a�t�e�g�y� �t�e�s�t�s�
�p�n�p�m� �r�u�n� �t�e�s�t�:�i�n�f�e�r�e�n�c�e� � � �#� �B�u�s�i�n�e�s�s� �d�e�c�i�s�i�o�n�s�
�p�n�p�m� �r�u�n� �t�e�s�t�:�p�h�i�l�o�s�o�p�h�y� � �#� �P�h�i�l�o�s�o�p�h�i�c�a�l� �d�i�s�c�o�u�r�s�e�
�p�n�p�m� �r�u�n� �t�e�s�t�:�c�h�e�s�s� � � � � � � �#� �C�h�e�s�s� �a�n�a�l�y�s�i�s�
�p�n�p�m� �r�u�n� �t�y�p�e�-�c�h�e�c�k� � � � � � � �#� �T�y�p�e� �c�h�e�c�k�i�n�g� �o�n�l�y�
�p�n�p�m� �r�u�n� �l�i�n�t� � � � � � � � � � � � � �#� �E�S�L�i�n�t� �w�i�t�h� �a�u�t�o�-�f�i�x�
�p�n�p�m� �r�u�n� �f�o�r�m�a�t� � � � � � � � � � � �#� �P�r�e�t�t�i�e�r� �f�o�r�m�a�t�t�i�n�g�
�p�n�p�m� �r�u�n� �d�e�m�o�:�p�i�p�e�l�i�n�e� � � � �#� �R�u�n� �t�h�e� �p�i�p�e�l�i�n�e� �d�e�m�o�
����
�
�#�#� �P�r�o�j�e�c�t� �S�t�r�u�c�t�u�r�e�
�
����
�s�r�c�/�
�%�%�% �a�g�e�n�t�s�/� � � � � � � � � � �#� �A�g�e�n�t� �i�m�p�l�e�m�e�n�t�a�t�i�o�n�s� �(�f�l�a�t� �+� �s�t�r�a�t�e�g�y�)�
�% � � �%�%�% �b�a�s�e�/� � � � � � � � �#� � � �B�a�s�e�A�g�e�n�t�,� �S�t�r�a�t�e�g�y�A�g�e�n�t� �a�b�s�t�r�a�c�t�i�o�n�s�
�% � � �%�%�% �f�a�c�t�o�r�i�e�s�/� � � �#� � � �E�r�g�o�n�o�m�i�c� �a�g�e�n�t� �c�r�e�a�t�i�o�n� �f�u�n�c�t�i�o�n�s�
�% � � �%�%�% �w�e�b�/� � � � � � � � � �#� � � �O�p�e�n�A�I�,� �A�n�t�h�r�o�p�i�c�,� �G�o�o�g�l�e� �i�m�p�l�e�m�e�n�t�a�t�i�o�n�s�
�%�%�% �c�o�n�f�i�g�/� � � � � � � � � � �#� �P�r�e�s�e�t�s�,� �m�o�d�e�l� �c�a�t�a�l�o�g�,� �a�n�d� �c�o�n�f�i�g�u�r�a�t�i�o�n�
�%�%�% �d�o�m�a�i�n�s�/� � � � � � � � � �#� �D�o�m�a�i�n�-�s�p�e�c�i�f�i�c� �s�t�a�t�e�/�a�c�t�i�o�n� �t�y�p�e�s� �(�c�h�e�s�s�,� �p�h�i�l�o�s�o�p�h�y�)�
�%�%�% �e�n�g�i�n�e�/� � � � � � � � � � �#� �P�o�l�a�r�i�s�E�n�g�i�n�e� �+� �L�a�y�e�r�P�i�p�e�l�i�n�e�
�%�%�% �e�r�r�o�r�s�/� � � � � � � � � � �#� �T�y�p�e�d� �e�r�r�o�r� �h�i�e�r�a�r�c�h�y� �w�i�t�h� �r�e�t�r�y�a�b�i�l�i�t�y�
�%�%�% �s�e�n�t�i�n�e�l�/� � � � � � � � �#� �B�i�a�s� �d�e�t�e�c�t�i�o�n� �&� �d�i�v�e�r�s�i�t�y� �a�n�a�l�y�s�i�s�
�%�%�% �s�t�r�a�t�e�g�i�e�s�/� � � � � � �#� �P�r�o�m�p�t� �+� �o�u�t�p�u�t� �p�a�r�s�e�r� �s�t�r�a�t�e�g�i�e�s� �(�8� �t�o�t�a�l�)�
�%�%�% �t�y�p�e�s�/� � � � � � � � � � � �#� �T�y�p�e�S�c�r�i�p�t� �d�e�f�i�n�i�t�i�o�n�s� �(�l�a�y�e�r�,� �t�a�s�k�,� �a�g�e�n�t�-�o�u�t�p�u�t�)�
�%�%�% �u�t�i�l�s�/� � � � � � � � � � � �#� �L�o�g�g�e�r�,� �c�o�n�f�i�g�,� �r�a�t�e�-�l�i�m�i�t�e�r�,� �m�a�t�h�,� �v�a�l�i�d�a�t�i�o�n�,� �s�t�a�t�i�s�t�i�c�s�
����
�
�#�#� �E�x�a�m�p�l�e�s�
�
�|� �F�i�l�e� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �|� �D�e�s�c�r�i�p�t�i�o�n� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �|�
�|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|�
�|� �[��e�x�a�m�p�l�e�s�/�b�a�s�i�c�-�u�s�a�g�e�.�t�s��]�(�e�x�a�m�p�l�e�s�/�b�a�s�i�c�-�u�s�a�g�e�.�t�s�)� � � � � � � � � � � � � � � �|� �Q�u�i�c�k� �s�t�a�r�t�,� �c�u�s�t�o�m� �t�a�s�k�s�,� �a�g�e�n�t� �f�a�c�t�o�r�i�e�s� � � � � � � �|�
�|� �[��e�x�a�m�p�l�e�s�/�i�n�f�e�r�e�n�c�e�-�e�x�a�m�p�l�e�s�.�t�s��]�(�e�x�a�m�p�l�e�s�/�i�n�f�e�r�e�n�c�e�-�e�x�a�m�p�l�e�s�.�t�s�)� �|� �M�u�l�t�i�-�a�g�e�n�t� �i�n�f�e�r�e�n�c�e�,� �p�r�e�s�e�t�s�,� �s�e�l�e�c�t�i�v�e� �a�g�e�n�t�s� �|�
�|� �[��e�x�a�m�p�l�e�s�/�p�i�p�e�l�i�n�e�-�d�e�m�o�.�t�s��]�(�e�x�a�m�p�l�e�s�/�p�i�p�e�l�i�n�e�-�d�e�m�o�.�t�s�)� � � � � � � � � � � �|� �F�u�l�l� �p�i�p�e�l�i�n�e� �d�e�m�o� �w�i�t�h� �d�e�c�a�y� �l�o�o�p� �e�x�p�l�a�n�a�t�i�o�n� � � �|�
�
�#�#� �T�e�s�t� �S�u�i�t�e�
�
�|� �D�o�m�a�i�n� � � � � �|� �T�e�s�t�s� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �|� �D�e�s�c�r�i�p�t�i�o�n� � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � � �|�
�|� �-�-�-�-�-�-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|� �-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-�-� �|�
�|� �B�a�s�i�c� � � � � � �|� �C�o�m�p�o�n�e�n�t� �V�a�l�i�d�a�t�i�o�n�,� �S�e�t�u�p�,� �B�e�n�c�h�m�a�r�k� �|� �F�r�a�m�e�w�o�r�k� �i�n�i�t�,� �a�g�e�n�t� �c�r�e�a�t�i�o�n�,� �e�n�g�i�n�e� �l�i�f�e�c�y�c�l�e� �|�
�|� �I�n�f�e�r�e�n�c�e� � �|� �M�u�l�t�i�-�A�g�e�n�t� �B�u�s�i�n�e�s�s� �D�e�c�i�s�i�o�n� � � � � � � � � � �|� �R�e�a�l� �L�L�M� �A�P�I� �c�a�l�l�s� �w�i�t�h� �c�o�n�s�e�n�s�u�s� � � � � � � � � � � � � � � � �|�
�|� �P�h�i�l�o�s�o�p�h�y� �|� �C�o�n�s�c�i�o�u�s�n�e�s�s� �D�e�b�a�t�e� � � � � � � � � � � � � � � � � � � �|� �M�u�l�t�i�-�p�r�o�v�i�d�e�r� �p�h�i�l�o�s�o�p�h�i�c�a�l� �d�i�s�c�o�u�r�s�e� � � � � � � � � � � �|�
�|� �C�h�e�s�s� � � � � � �|� �T�a�c�t�i�c�s� �+� �P�o�s�i�t�i�o�n� �A�n�a�l�y�s�i�s� � � � � � � � � � � � �|� �S�t�r�a�t�e�g�i�c� �r�o�l�e�-�b�a�s�e�d� �a�n�a�l�y�s�i�s� � � � � � � � � � � � � � � � � � � � �|�
�|� �S�t�r�a�t�e�g�i�e�s� �|� �4�6� �a�s�s�e�r�t�i�o�n�s� � � � � � � � � � � � � � � � � � � � � � � � � � �|� �A�l�l� �8� �p�r�o�m�p�t�/�o�u�t�p�u�t� �s�t�r�a�t�e�g�i�e�s� � � � � � � � � � � � � � � � � � � �|�
�|� �P�i�p�e�l�i�n�e� � � �|� �2�4� �a�s�s�e�r�t�i�o�n�s� � � � � � � � � � � � � � � � � � � � � � � � � � �|� �D�e�c�a�y� �l�o�o�p�,� �m�e�s�s�a�g�e� �p�r�o�p�a�g�a�t�i�o�n�,� �f�o�r�c�e�d� �d�e�l�i�v�e�r�y� �|�
�
�S�e�e� �[��t�e�s�t�/�R�E�A�D�M�E�.�m�d��]�(�t�e�s�t�/�R�E�A�D�M�E�.�m�d�)� �f�o�r� �d�e�t�a�i�l�s�.�
�
�#�#� �U�s�e� �C�a�s�e�s�
�
�-� ���D�e�c�i�s�i�o�n� �S�u�p�p�o�r�t��� � �M�u�l�t�i�-�p�e�r�s�p�e�c�t�i�v�e� �a�n�a�l�y�s�i�s� �w�i�t�h� �r�o�l�e�-�a�w�a�r�e� �a�g�e�n�t�s�
�-� ���C�r�e�a�t�i�v�e� �W�r�i�t�i�n�g��� � �4�-�l�a�y�e�r� �p�i�p�e�l�i�n�e� �f�o�r� �i�t�e�r�a�t�i�v�e� �q�u�a�l�i�t�y� �i�m�p�r�o�v�e�m�e�n�t�
�-� ���G�a�m�e� �A�I��� � �C�h�e�s�s� �a�n�a�l�y�s�i�s� �w�i�t�h� �s�t�r�a�t�e�g�i�c� �r�o�l�e�s�
�-� ���B�u�s�i�n�e�s�s� �A�n�a�l�y�s�i�s��� � �M�u�l�t�i�-�a�g�e�n�t� �s�t�r�a�t�e�g�i�c� �p�l�a�n�n�i�n�g�
�-� ���R�e�s�e�a�r�c�h��� � �C�o�l�l�a�b�o�r�a�t�i�v�e� �A�I� �a�n�a�l�y�s�i�s� �w�i�t�h� �q�u�a�l�i�t�y� �g�a�t�e�s�
�-� ���C�o�n�t�e�n�t� �G�e�n�e�r�a�t�i�o�n��� � �B�l�o�g� �p�o�s�t�s�,� �s�t�o�r�i�e�s�,� �r�e�p�o�r�t�s� �w�i�t�h� �i�t�e�r�a�t�i�v�e� �r�e�f�i�n�e�m�e�n�t�
�
�#�#� �C�o�n�t�r�i�b�u�t�i�n�g�
�
�1�.� �F�o�r�k� �t�h�e� �r�e�p�o�s�i�t�o�r�y�
�2�.� �C�r�e�a�t�e� �a� �f�e�a�t�u�r�e� �b�r�a�n�c�h�:� ��g�i�t� �c�h�e�c�k�o�u�t� �-�b� �f�e�a�t�u�r�e�/�a�m�a�z�i�n�g�-�f�e�a�t�u�r�e��
�3�.� �M�a�k�e� �y�o�u�r� �c�h�a�n�g�e�s� �w�i�t�h� �t�e�s�t�s�
�4�.� �R�u�n� �c�h�e�c�k�s�:� ��p�n�p�m� �r�u�n� �t�y�p�e�-�c�h�e�c�k� �&�&� �p�n�p�m� �t�e�s�t��
�5�.� �S�u�b�m�i�t� �a� �p�u�l�l� �r�e�q�u�e�s�t�
�
�#�#� �C�i�t�a�t�i�o�n�
�
����b�i�b�t�e�x�
�@�s�o�f�t�w�a�r�e�{�v�a�l�l�e�j�o�2�0�2�6�p�o�l�a�r�i�s�,�
� � �t�i�t�l�e�=�{�P�O�L�A�R�I�S�:� �P�o�l�i�c�y� �O�p�t�i�m�i�z�a�t�i�o�n� �v�i�a� �L�a�y�e�r�e�d� �A�g�e�n�t�s� �a�n�d� �R�e�c�u�r�s�i�v�e� �I�n�f�e�r�e�n�c�e� �S�e�a�r�c�h�}�,�
� � �a�u�t�h�o�r�=�{�V�a�l�l�e�j�o�,� �D�i�e�g�o�}�,�
� � �y�e�a�r�=�{�2�0�2�6�}�,�
� � �v�e�r�s�i�o�n�=�{�2�.�1�.�0�}�,�
� � �u�r�l�=�{�h�t�t�p�s�:�/�/�g�i�t�h�u�b�.�c�o�m�/�D�i�e�g�o�V�a�l�l�e�j�o�D�e�v�/�P�o�l�a�r�i�s�}�
�}�
����
�
�#�#� �L�i�c�e�n�s�e�
�
�M�I�T� �L�i�c�e�n�s�e� � �s�e�e� �[�L�I�C�E�N�S�E�]�(�L�I�C�E�N�S�E�)� �f�i�l�e� �f�o�r� �d�e�t�a�i�l�s�.�
�
�#�#� �A�u�t�h�o�r�
�
�D�i�e�g�o� �V�a�l�l�e�j�o� � �[�d�i�e�g�o�v�a�l�l�e�j�o�.�d�e�v�]�(�h�t�t�p�s�:�/�/�w�w�w�.�d�i�e�g�o�v�a�l�l�e�j�o�.�d�e�v�/�)�
�
