케냐인의 40% 이상이 자신의 헌법적 권리를 알지 못합니다. 이는 권리가 존재하지 않기 때문이 아닙니다 — 케냐의 2010년 헌법은 아프리카에서 가장 진보적인 헌법 중 하나입니다 — 하지만 정보가 난해한 법률 용어로 묶여 있고, 영어로만 제공되며, 어떠한 제도적 채널을 통해서도 쉽게 접근할 수 없기 때문입니다.

hakiyangu (haki = 권리, yangu = 나의 — "나의 권리")는 모든 헌법적 질문에 대해 정부의 입장과 시민의 권리를 스와힐리어 또는 영어로 제시하는 멀티 에이전트 (multi-agent) 헌법 토론 시스템입니다.

연구 기반

arXiv:2305.19118 — Liang et al. (2023): "토론을 통한 대규모 언어 모델 (Large Language Models)의 발산적 사고 촉진"

이 논문은 여러 AI 에이전트가 하나의 질문에 대해 서로 반대되는 입장을 논쟁할 때, 최종적으로 합성된 답변이 단일 에이전트의 응답보다 측정 가능한 수준으로 편향이 적고 더 정확하다는 것을 입증했습니다. 이러한 적대적 형식 (adversarial format)은 AI가 답변을 합성하기 전에 각 입장의 가장 강력한 버전을 고려하도록 강제합니다.

헌법적 권리에 관한 질문의 경우, 이는 특히 중요합니다. 정부는 정당한 이익을 가지고 있으며, 시민은 헌법적 보호를 받습니다. 어느 한쪽의 관점만으로는 완전한 그림을 제공할 수 없습니다.

3-에이전트 아키텍처 (Three-Agent Architecture)

# 에이전트 1: 정부 법무관
gov_response = call_gemini(
    system="당신은 케냐 정부를 방어하는 선임 정부 법무관입니다 
...

각 에이전트는 정의된 역할을 가지며, 내용을 요약하는 것이 아니라 실제 케냐 헌법 조항을 인용하도록 명시적으로 지시받습니다.

다루는 권리

2010년 케냐 헌법의 6가지 권리:

1. 표현의 자유 (제33조)
2. 재산권 (제40조)
3. 공정한 재판을 받을 권리 (제50조)
4. 차별로부터의 자유 (제27조)
5. 교육권 (제43조)
6. 이동의 자유 (제26조)

각 권리에는 사전 로드된 컨텍스트 (context), 제한에 대한 정부의 헌법적 근거, 그리고 시민의 가장 강력한 보호 수단이 포함되어 있습니다.

오류 처리 교훈

원래의 haki-debate-ai (현재 hakiyangu)에는 세 번의 Gemini 호출에 대한 try/except 처리가 되어 있지 않았습니다. API가 HTTP 404를 반환했을 때 ( v1beta와 v1 엔드포인트 변경으로 인해), 오류가 파일 경로와 코드 스니펫을 포함한 전체 Streamlit 트레이스백 (traceback) 형태로 노출되었습니다.

# 이전: 보호되지 않은 단일 호출, 오류 발생 시 전체 충돌
gov_response = call_gemini(gov_system, question)

...

사용자는 Python 트레이스백이 아니라 "Hitilafu ya API (404). Jaribu tena baadaye. / API error. Please try again later."라는 메시지를 보게 됩니다. 프로덕션 (production) 앱은 사용자에게 우아한 성능 저하 (graceful degradation)를 제공할 의무가 있습니다.

배포하기 (Deploy It)

# Streamlit Cloud: github.com/gabrielmahia/hakiyangu
# Secret: GOOGLE_API_KEY = "your-gemini-key"

hakiyangu.streamlit.app에서 직접 체험해 보세요 (설정 진행 중)

github.com/gabrielmahia/hakiyangu · CC BY-NC-ND 4.0