===================
AI Agents
===================

Individual LangGraph agent implementations. Each agent handles a specific
domain task within the co-design methodology.

Base Agents
-----------

Abstract and reusable agent patterns.

.. automodule:: backend.service.chat.orchestrator.agents.base.base_agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.base.entity_card_agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.base.suggestion_agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.base.comparison_agent
   :members:
   :undoc-members:
   :show-inheritance:

Router Agent
------------

Intent classification and agent dispatch.

.. automodule:: backend.service.chat.orchestrator.agents.router.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.router.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Sender Agent
------------

Response formatting and delivery.

.. automodule:: backend.service.chat.orchestrator.agents.sender.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.sender.schemas
   :members:
   :undoc-members:
   :show-inheritance:

RAG Agent
---------

Retrieval-Augmented Generation for methodology knowledge.

.. automodule:: backend.service.chat.orchestrator.agents.rag_agent.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.rag_agent.tools
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.rag_agent.sources
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.rag_agent.sanitizer
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.rag_agent.schemas
   :members:
   :undoc-members:
   :show-inheritance:

DB Retriever Agent
------------------

Structured database querying (project data, templates, stakeholders).

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.react_retriever
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.retriever
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.tool
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.ranker
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.serializers
   :members:
   :undoc-members:
   :show-inheritance:

DB Retriever Tools
^^^^^^^^^^^^^^^^^^

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.tools.fetch
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.tools.filters
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.tools.joins
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.tools.rank
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.tools.semantic
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.db_retriever.tools.registry
   :members:
   :undoc-members:
   :show-inheritance:

Assistant Agent
---------------

General-purpose project assistant with tool calling.

.. automodule:: backend.service.chat.orchestrator.agents.assistant_agent.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.assistant_agent.tools
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.assistant_agent.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Project Assistant Agent
-----------------------

.. automodule:: backend.service.chat.orchestrator.agents.project_assistant.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.project_assistant.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Stakeholder Agent
-----------------

Stakeholder ID Card creation and editing.

.. automodule:: backend.service.chat.orchestrator.agents.stakeholder.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.stakeholder.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Partnership Project Agent
-------------------------

Partnership Project ID Card creation and editing.

.. automodule:: backend.service.chat.orchestrator.agents.partnership_project.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.partnership_project.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Suggest Stakeholder Agent
-------------------------

CORDIS-powered stakeholder suggestion.

.. automodule:: backend.service.chat.orchestrator.agents.suggest_stakeholder.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.suggest_stakeholder.tools
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.suggest_stakeholder.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Suggest Project Agent
---------------------

CORDIS-powered project suggestion.

.. automodule:: backend.service.chat.orchestrator.agents.suggest_project.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.suggest_project.tools
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.suggest_project.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Assessment Agents
-----------------

Stakeholder and project assessment radars.

.. automodule:: backend.service.chat.orchestrator.agents.assessment_stakeholder.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.assessment_stakeholder.schemas
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.assessment_project.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.assessment_project.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Ecosystem Map Agent
-------------------

.. automodule:: backend.service.chat.orchestrator.agents.ecosystem_map.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.ecosystem_map.schemas
   :members:
   :undoc-members:
   :show-inheritance:

DIV Agent
---------

Data–Information–Value card creation.

.. automodule:: backend.service.chat.orchestrator.agents.div.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.div.tools
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.div.diagnostic
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.div.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Outcomes Diagram Agent
----------------------

.. automodule:: backend.service.chat.orchestrator.agents.outcomes_diagram.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.outcomes_diagram.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Sustainability Canvas Agent
---------------------------

.. automodule:: backend.service.chat.orchestrator.agents.sustainability_canvas.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.sustainability_canvas.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Initial Diagnosis Agent
-----------------------

.. automodule:: backend.service.chat.orchestrator.agents.initial_diagnosis.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.initial_diagnosis.graph
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.initial_diagnosis.dimensions
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.initial_diagnosis.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Phase Analyzer Agent
--------------------

.. automodule:: backend.service.chat.orchestrator.agents.phase_analayzer.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.phase_analayzer.schemas
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.phase_analayzer.state
   :members:
   :undoc-members:
   :show-inheritance:

Progress Guidance Agent
-----------------------

.. automodule:: backend.service.chat.orchestrator.agents.progress_guidance.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.progress_guidance.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Web Search Agent
----------------

.. automodule:: backend.service.chat.orchestrator.agents.web_search_agent.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.web_search_agent.tools
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.web_search_agent.agent_tools
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.web_search_agent.schemas
   :members:
   :undoc-members:
   :show-inheritance:

Utility Agents
--------------

Clarification, feedback, revision, toxicity detection, and response relevance.

.. automodule:: backend.service.chat.orchestrator.agents.clarification.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.clarification.schemas
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.feedback.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.reviser.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.reviser.schemas
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.toxicity.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.toxicity.schemas
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.response_relevance.agent
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.response_relevance.schemas
   :members:
   :undoc-members:
   :show-inheritance:

.. automodule:: backend.service.chat.orchestrator.agents.human_input.agent
   :members:
   :undoc-members:
   :show-inheritance: