> ## Documentation Index
> Fetch the complete documentation index at: https://mintlify.com/AllianceBioversityCIAT/alliance-risk-analysis-tool/llms.txt
> Use this file to discover all available pages before exploring further.

# CGIAR Risk Intelligence Tool Documentation

<div className="relative overflow-hidden bg-gradient-to-br from-[#16a34a] via-[#15803d] to-[#14532d] dark:from-[#15803d] dark:via-[#14532d] dark:to-[#052e16] py-20">
  <div className="absolute inset-0 bg-[url('data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNjAiIGhlaWdodD0iNjAiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyI+PGRlZnM+PHBhdHRlcm4gaWQ9ImdyaWQiIHdpZHRoPSI2MCIgaGVpZ2h0PSI2MCIgcGF0dGVyblVuaXRzPSJ1c2VyU3BhY2VPblVzZSI+PHBhdGggZD0iTSAxMCAwIEwgMCAwIDAgMTAiIGZpbGw9Im5vbmUiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS1vcGFjaXR5PSIwLjA1IiBzdHJva2Utd2lkdGg9IjEiLz48L3BhdHRlcm4+PC9kZWZzPjxyZWN0IHdpZHRoPSIxMDAlIiBoZWlnaHQ9IjEwMCUiIGZpbGw9InVybCgjZ3JpZCkiLz48L3N2Zz4=')] opacity-20" />

  <div className="relative max-w-6xl mx-auto px-6 lg:px-8">
    <div className="text-center">
      <h1 className="text-4xl sm:text-5xl lg:text-6xl font-bold text-white mb-6">
        AI-Powered Agricultural Risk Intelligence
      </h1>

      <p className="text-lg sm:text-xl text-white/90 max-w-3xl mx-auto mb-8">
        Comprehensive risk assessment platform for agricultural SMEs in Kenya. Upload business plans, analyze risk across 7 dimensions, and generate actionable reports with multi-agent AI.
      </p>

      <div className="flex flex-wrap gap-4 justify-center">
        <a href="/quickstart" className="inline-flex items-center px-6 py-3 rounded-lg bg-white text-[#16a34a] font-semibold hover:bg-gray-100 transition-colors no-underline">
          Get Started

          <svg className="ml-2 w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
            <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 7l5 5m0 0l-5 5m5-5H6" />
          </svg>
        </a>

        <a href="/architecture" className="inline-flex items-center px-6 py-3 rounded-lg border-2 border-white/30 bg-white/10 text-white font-semibold hover:bg-white/20 transition-colors no-underline">
          View Architecture
        </a>
      </div>
    </div>
  </div>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <div className="text-center mb-12">
    <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">Quick Start</h2>

    <p className="text-base text-gray-600 dark:text-gray-400 max-w-2xl mx-auto">
      Get up and running with the Risk Intelligence Tool in minutes
    </p>
  </div>

  <Steps>
    <Step title="Set up your account">
      Contact your administrator to create your user account and receive your credentials. Admins have full access to user management and prompt configuration.

      <Note>
        The platform uses AWS Cognito for authentication. You'll receive a temporary password that must be changed on first login.
      </Note>
    </Step>

    <Step title="Create your first assessment">
      Log in and navigate to **Assessments** → **New Assessment**. Provide basic information about the agricultural SME you're evaluating.

      ```json Example Assessment Data theme={null}
      {
        "sme_name": "Green Valley Farms Ltd",
        "sector": "Agriculture",
        "location": "Nakuru, Kenya",
        "assessment_date": "2026-03-04"
      }
      ```
    </Step>

    <Step title="Upload business plan documents">
      Upload the SME's business plan in PDF or DOCX format. The AI pipeline automatically extracts relevant data across all risk dimensions.

      <Info>
        Supported formats: PDF, DOCX. Maximum file size: 10MB per document.
      </Info>
    </Step>

    <Step title="Review risk analysis and generate report">
      The system analyzes the business plan across 7 risk categories (Financial, Climate-Environmental, Behavioral, Operational, Market, Governance & Legal, Technology & Data). Each category contains 5 subcategories scored as High, Medium, or Low risk. Once complete, download the comprehensive PDF report with traffic-light indicators.

      <Accordion title="View sample risk output">
        ```json Sample Risk Score Response theme={null}
        {
          "assessment_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
          "overall_risk_level": "MEDIUM",
          "risk_categories": {
            "financial": {
              "score": "MEDIUM",
              "subcategories": {
                "revenue": "LOW",
                "costs": "MEDIUM",
                "credit": "HIGH",
                "liquidity": "MEDIUM",
                "capital": "LOW"
              }
            }
          },
          "generated_at": "2026-03-04T10:30:00Z"
        }
        ```
      </Accordion>
    </Step>
  </Steps>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <div className="text-center mb-12">
    <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">Core Features</h2>

    <p className="text-base text-gray-600 dark:text-gray-400 max-w-2xl mx-auto">
      Everything you need to assess agricultural risk profiles
    </p>
  </div>

  <CardGroup cols={2}>
    <Card title="Risk Assessment Workflow" icon="clipboard-check" href="/features/assessments">
      Create assessments, upload documents, and track analysis progress with real-time status updates
    </Card>

    <Card title="7-Dimensional Risk Scoring" icon="chart-mixed" href="/features/risk-scoring">
      Comprehensive scoring across financial, climate, behavioral, operational, market, governance, and technology domains
    </Card>

    <Card title="Multi-Agent AI Analysis" icon="brain" href="/features/ai-analysis">
      AWS Bedrock-powered pipeline with 9 specialized agents and 7 knowledge bases for document parsing and risk evaluation
    </Card>

    <Card title="PDF Report Generation" icon="file-pdf" href="/features/report-generation">
      Generate professional reports with traffic-light risk indicators, summaries, and actionable recommendations
    </Card>
  </CardGroup>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <div className="text-center mb-12">
    <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">User Guides</h2>

    <p className="text-base text-gray-600 dark:text-gray-400 max-w-2xl mx-auto">
      Step-by-step instructions for common workflows
    </p>
  </div>

  <div className="grid grid-cols-1 md:grid-cols-2 gap-6">
    <a href="/guides/creating-assessments" className="group block rounded-2xl border border-gray-200 dark:border-[#27272a] hover:border-[#16a34a] dark:hover:border-[#16a34a] overflow-hidden transition-colors no-underline bg-white dark:bg-[#1a1d27]">
      <div className="p-6">
        <h3 className="text-base font-semibold text-gray-900 dark:text-gray-100 mb-2">Creating Assessments</h3>
        <p className="text-sm text-gray-600 dark:text-gray-400 mb-4">Learn how to create new assessments, upload documents, and initiate AI analysis</p>

        <div className="flex items-center text-sm font-medium text-gray-600 dark:text-gray-400 group-hover:text-[#16a34a]">
          Read guide

          <svg className="ml-1 w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
            <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
          </svg>
        </div>
      </div>
    </a>

    <a href="/guides/managing-prompts" className="group block rounded-2xl border border-gray-200 dark:border-[#27272a] hover:border-[#16a34a] dark:hover:border-[#16a34a] overflow-hidden transition-colors no-underline bg-white dark:bg-[#1a1d27]">
      <div className="p-6">
        <h3 className="text-base font-semibold text-gray-900 dark:text-gray-100 mb-2">Managing AI Prompts</h3>
        <p className="text-sm text-gray-600 dark:text-gray-400 mb-4">Configure and version AI prompts for document parsing, gap detection, and risk scoring</p>

        <div className="flex items-center text-sm font-medium text-gray-600 dark:text-gray-400 group-hover:text-[#16a34a]">
          Read guide

          <svg className="ml-1 w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
            <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
          </svg>
        </div>
      </div>
    </a>

    <a href="/guides/user-management" className="group block rounded-2xl border border-gray-200 dark:border-[#27272a] hover:border-[#16a34a] dark:hover:border-[#16a34a] overflow-hidden transition-colors no-underline bg-white dark:bg-[#1a1d27]">
      <div className="p-6">
        <h3 className="text-base font-semibold text-gray-900 dark:text-gray-100 mb-2">User Management</h3>
        <p className="text-sm text-gray-600 dark:text-gray-400 mb-4">Add users, manage permissions, and configure admin access with AWS Cognito</p>

        <div className="flex items-center text-sm font-medium text-gray-600 dark:text-gray-400 group-hover:text-[#16a34a]">
          Read guide

          <svg className="ml-1 w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
            <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
          </svg>
        </div>
      </div>
    </a>

    <a href="/guides/interpreting-results" className="group block rounded-2xl border border-gray-200 dark:border-[#27272a] hover:border-[#16a34a] dark:hover:border-[#16a34a] overflow-hidden transition-colors no-underline bg-white dark:bg-[#1a1d27]">
      <div className="p-6">
        <h3 className="text-base font-semibold text-gray-900 dark:text-gray-100 mb-2">Interpreting Risk Results</h3>
        <p className="text-sm text-gray-600 dark:text-gray-400 mb-4">Understand risk scores, traffic-light indicators, and how to act on assessment findings</p>

        <div className="flex items-center text-sm font-medium text-gray-600 dark:text-gray-400 group-hover:text-[#16a34a]">
          Read guide

          <svg className="ml-1 w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
            <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M9 5l7 7-7 7" />
          </svg>
        </div>
      </div>
    </a>
  </div>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <div className="text-center mb-12">
    <h2 className="text-3xl font-bold text-gray-900 dark:text-white mb-4">Risk Model</h2>

    <p className="text-base text-gray-600 dark:text-gray-400 max-w-2xl mx-auto">
      Explore the 7-category risk framework with 35 indicators
    </p>
  </div>

  <CardGroup cols={2}>
    <Card title="Financial Risk" icon="dollar-sign" href="/risk-model/financial">
      Revenue, costs, credit, liquidity, and capital structure assessment
    </Card>

    <Card title="Climate & Environmental" icon="cloud-sun" href="/risk-model/climate-environmental">
      Weather exposure, adaptation, water, biodiversity, and carbon footprint
    </Card>

    <Card title="Behavioral Risk" icon="users" href="/risk-model/behavioral">
      Management competence, governance, compliance, innovation, and stakeholder relations
    </Card>

    <Card title="Operational Risk" icon="gears" href="/risk-model/operational">
      Supply chain, production, technology, HR, and quality control
    </Card>

    <Card title="Market Risk" icon="chart-line" href="/risk-model/market">
      Demand, competition, pricing, distribution, and regulatory environment
    </Card>

    <Card title="Governance & Legal" icon="scale-balanced" href="/risk-model/governance-legal">
      Legal structure, contracts, IP, compliance, and reporting
    </Card>

    <Card title="Technology & Data" icon="microchip" href="/risk-model/technology-data">
      IT infrastructure, data management, cybersecurity, and analytics
    </Card>

    <Card title="Risk Model Overview" icon="book-open" href="/risk-model/overview">
      Complete framework documentation and scoring methodology
    </Card>
  </CardGroup>
</div>

<div className="mt-16 mb-16 max-w-5xl mx-auto px-6">
  <div className="rounded-2xl border border-gray-200 dark:border-[#27272a] bg-gradient-to-br from-white to-gray-50 dark:from-[#1a1d27] dark:to-[#0f1117] p-8 text-center">
    <h2 className="text-2xl font-bold text-gray-900 dark:text-white mb-4">Ready to assess agricultural risk?</h2>

    <p className="text-base text-gray-600 dark:text-gray-400 mb-6 max-w-2xl mx-auto">
      Start using the Risk Intelligence Tool to evaluate SME business plans with AI-powered analysis
    </p>

    <a href="/quickstart" className="inline-flex items-center px-6 py-3 rounded-lg bg-[#16a34a] text-white font-semibold hover:bg-[#15803d] transition-colors no-underline">
      Get Started

      <svg className="ml-2 w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
        <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M13 7l5 5m0 0l-5 5m5-5H6" />
      </svg>
    </a>
  </div>
</div>