prebuilt.misc.agent_utilities_models

Agent Utilities Models.

This module provides consolidated models for various agent utility functions including goal decomposition, decision analysis, resource planning, quality assessment, workflow optimization, and communication planning.

Classes

BottleneckType	Types of bottlenecks in processes.
CommunicationFrequency	How often to communicate with stakeholders.
CommunicationPlan	Communication plan for a stakeholder.
DecisionAnalysis	Complete decision analysis framework.
DecisionCriteria	Criteria for evaluating decision options.
DecisionOption	Option to be evaluated for a decision.
DecisionType	Types of decisions that need to be made.
GoalDecomposition	Complete goal decomposition structure.
GoalStatus	Status of goal completion.
GoalType	Types of goals.
InfluenceLevel	Level of influence a stakeholder has.
InterestLevel	Level of interest a stakeholder has.
PriorityLevel	Priority levels for goals and tasks.
ProcessBottleneck	Identified bottleneck in a process.
ProcessStep	Individual step in a process.
ProcessType	Types of processes that can be optimized.
QualityAssessment	Complete quality assessment report.
QualityDimension	Dimensions of quality to assess.
QualityIssue	Quality issue or defect.
QualityMetric	Individual quality metric definition.
Resource	Individual resource definition.
ResourceAvailability	Availability status of resources.
ResourcePlan	Complete resource planning document.
ResourceRequirement	Requirement for a specific resource.
ResourceType	Types of resources needed for projects.
Stakeholder	Individual stakeholder in a project or initiative.
StakeholderType	Types of stakeholders in projects or initiatives.
SubGoal	Individual sub-goal within a larger goal decomposition.
WorkflowOptimization	Complete workflow optimization analysis.

Module Contents

class prebuilt.misc.agent_utilities_models.BottleneckType

Bases: str, enum.Enum

Types of bottlenecks in processes.

APPROVAL = 'approval'

CAPACITY = 'capacity'

COMMUNICATION = 'communication'

DEPENDENCY = 'dependency'

RESOURCE = 'resource'

TECHNICAL = 'technical'

class prebuilt.misc.agent_utilities_models.CommunicationFrequency

Bases: str, enum.Enum

How often to communicate with stakeholders.

AS_NEEDED = 'as_needed'

BI_WEEKLY = 'bi_weekly'

DAILY = 'daily'

MONTHLY = 'monthly'

QUARTERLY = 'quarterly'

WEEKLY = 'weekly'

class prebuilt.misc.agent_utilities_models.CommunicationPlan(/, **data: Any)

Bases: pydantic.BaseModel

Communication plan for a stakeholder.

content_type: str = None

frequency: CommunicationFrequency = None

method: str = None

responsible_party: str = None

stakeholder_id: str = None

class prebuilt.misc.agent_utilities_models.DecisionAnalysis(/, **data: Any)

Bases: pydantic.BaseModel

Complete decision analysis framework.

analysis_id: str = None

criteria: List[DecisionCriteria] = None

deadline: datetime.datetime | None = None

decision_title: str = None

decision_type: DecisionType = None

options: List[DecisionOption] = None

stakeholders: List[str] = None

class prebuilt.misc.agent_utilities_models.DecisionCriteria(/, **data: Any)

Bases: pydantic.BaseModel

Criteria for evaluating decision options.

criteria_id: str = None

description: str = None

is_constraint: bool = None

name: str = None

weight: float = None

class prebuilt.misc.agent_utilities_models.DecisionOption(/, **data: Any)

Bases: pydantic.BaseModel

Option to be evaluated for a decision.

cons: List[str] = None

description: str = None

estimated_cost: float | None = None

estimated_effort: str | None = None

name: str = None

option_id: str = None

pros: List[str] = None

class prebuilt.misc.agent_utilities_models.DecisionType

Bases: str, enum.Enum

Types of decisions that need to be made.

OPERATIONAL = 'operational'

PRIORITIZATION = 'prioritization'

RESOURCE_ALLOCATION = 'resource_allocation'

STRATEGIC = 'strategic'

TACTICAL = 'tactical'

TECHNICAL = 'technical'

class prebuilt.misc.agent_utilities_models.GoalDecomposition(/, **data: Any)

Bases: pydantic.BaseModel

Complete goal decomposition structure.

goal_id: str = None

goal_type: GoalType = None

main_goal: str = None

owner: str | None = None

sub_goals: List[SubGoal] = None

success_criteria: List[str] = None

target_completion: datetime.datetime | None = None

class prebuilt.misc.agent_utilities_models.GoalStatus

Bases: str, enum.Enum

Status of goal completion.

BLOCKED = 'blocked'

CANCELLED = 'cancelled'

COMPLETED = 'completed'

IN_PROGRESS = 'in_progress'

NOT_STARTED = 'not_started'

ON_HOLD = 'on_hold'

class prebuilt.misc.agent_utilities_models.GoalType

Bases: str, enum.Enum

Types of goals.

OPERATIONAL = 'operational'

PERSONAL = 'personal'

PROJECT = 'project'

STRATEGIC = 'strategic'

TACTICAL = 'tactical'

TEAM = 'team'

class prebuilt.misc.agent_utilities_models.InfluenceLevel

Bases: str, enum.Enum

Level of influence a stakeholder has.

HIGH = 'high'

LOW = 'low'

MEDIUM = 'medium'

class prebuilt.misc.agent_utilities_models.InterestLevel

Bases: str, enum.Enum

Level of interest a stakeholder has.

HIGH = 'high'

LOW = 'low'

MEDIUM = 'medium'

class prebuilt.misc.agent_utilities_models.PriorityLevel

Bases: str, enum.Enum

Priority levels for goals and tasks.

CRITICAL = 'critical'

HIGH = 'high'

LOW = 'low'

MEDIUM = 'medium'

class prebuilt.misc.agent_utilities_models.ProcessBottleneck(/, **data: Any)

Bases: pydantic.BaseModel

Identified bottleneck in a process.

bottleneck_id: str = None

description: str = None

impact: str = None

priority: PriorityLevel = None

proposed_solution: str | None = None

step_id: str = None

type: BottleneckType = None

class prebuilt.misc.agent_utilities_models.ProcessStep(/, **data: Any)

Bases: pydantic.BaseModel

Individual step in a process.

description: str = None

estimated_duration: str | None = None

name: str = None

owner: str | None = None

prerequisites: List[str] = None

required_resources: List[str] = None

step_id: str = None

class prebuilt.misc.agent_utilities_models.ProcessType

Bases: str, enum.Enum

Types of processes that can be optimized.

CONDITIONAL = 'conditional'

EVENT_DRIVEN = 'event_driven'

ITERATIVE = 'iterative'

PARALLEL = 'parallel'

SEQUENTIAL = 'sequential'

class prebuilt.misc.agent_utilities_models.QualityAssessment(/, **data: Any)

Bases: pydantic.BaseModel

Complete quality assessment report.

assessment_date: datetime.datetime = None

assessment_id: str = None

assessor: str = None

issues: List[QualityIssue] = None

metrics: List[QualityMetric] = None

overall_score: float | None = None

recommendations: List[str] = None

subject: str = None

class prebuilt.misc.agent_utilities_models.QualityDimension

Bases: str, enum.Enum

Dimensions of quality to assess.

COMPATIBILITY = 'compatibility'

EFFICIENCY = 'efficiency'

FUNCTIONALITY = 'functionality'

MAINTAINABILITY = 'maintainability'

PORTABILITY = 'portability'

RELIABILITY = 'reliability'

SECURITY = 'security'

USABILITY = 'usability'

class prebuilt.misc.agent_utilities_models.QualityIssue(/, **data: Any)

Bases: pydantic.BaseModel

Quality issue or defect.

assigned_to: str | None = None

created_date: datetime.datetime = None

description: str = None

dimension: QualityDimension = None

issue_id: str = None

severity: PriorityLevel = None

status: str = None

title: str = None

class prebuilt.misc.agent_utilities_models.QualityMetric(/, **data: Any)

Bases: pydantic.BaseModel

Individual quality metric definition.

current_value: float | None = None

description: str = None

dimension: QualityDimension = None

measurement_method: str = None

metric_id: str = None

name: str = None

target_value: float | None = None

unit: str | None = None

class prebuilt.misc.agent_utilities_models.Resource(/, **data: Any)

Bases: pydantic.BaseModel

Individual resource definition.

availability: ResourceAvailability = None

capacity: float | None = None

cost_per_unit: float | None = None

current_allocation: float | None = None

description: str = None

name: str = None

resource_id: str = None

type: ResourceType = None

class prebuilt.misc.agent_utilities_models.ResourceAvailability

Bases: str, enum.Enum

Availability status of resources.

ALLOCATED = 'allocated'

AVAILABLE = 'available'

PARTIALLY_AVAILABLE = 'partially_available'

RESERVED = 'reserved'

UNAVAILABLE = 'unavailable'

class prebuilt.misc.agent_utilities_models.ResourcePlan(/, **data: Any)

Bases: pydantic.BaseModel

Complete resource planning document.

allocation_strategy: str = None

available_resources: List[Resource] = None

plan_id: str = None

project_name: str = None

requirements: List[ResourceRequirement] = None

timeline: str | None = None

total_budget: float | None = None

class prebuilt.misc.agent_utilities_models.ResourceRequirement(/, **data: Any)

Bases: pydantic.BaseModel

Requirement for a specific resource.

alternatives: List[str] = None

duration: str | None = None

justification: str = None

priority: PriorityLevel = None

quantity_needed: float = None

requirement_id: str = None

resource_type: ResourceType = None

class prebuilt.misc.agent_utilities_models.ResourceType

Bases: str, enum.Enum

Types of resources needed for projects.

EQUIPMENT = 'equipment'

EXPERTISE = 'expertise'

FINANCIAL = 'financial'

HUMAN = 'human'

INFRASTRUCTURE = 'infrastructure'

SOFTWARE = 'software'

TIME = 'time'

class prebuilt.misc.agent_utilities_models.Stakeholder(/, **data: Any)

Bases: pydantic.BaseModel

Individual stakeholder in a project or initiative.

contact_info: str | None = None

influence_level: InfluenceLevel = None

interest_level: InterestLevel = None

name: str = None

role: str = None

stakeholder_id: str = None

type: StakeholderType = None

class prebuilt.misc.agent_utilities_models.StakeholderType

Bases: str, enum.Enum

Types of stakeholders in projects or initiatives.

DECISION_MAKER = 'decision_maker'

IMPLEMENTER = 'implementer'

INFORMEE = 'informee'

REVIEWER = 'reviewer'

SPONSOR = 'sponsor'

SUBJECT_MATTER_EXPERT = 'subject_matter_expert'

USER = 'user'

class prebuilt.misc.agent_utilities_models.SubGoal(/, **data: Any)

Bases: pydantic.BaseModel

Individual sub-goal within a larger goal decomposition.

assignee: str | None = None

dependencies: List[str] = None

description: str = None

due_date: datetime.datetime | None = None

estimated_effort: str | None = None

priority: PriorityLevel = None

status: GoalStatus = None

subgoal_id: str = None

title: str = None

class prebuilt.misc.agent_utilities_models.WorkflowOptimization(/, **data: Any)

Bases: pydantic.BaseModel

Complete workflow optimization analysis.

current_steps: List[ProcessStep] = None

expected_improvements: List[str] = None

identified_bottlenecks: List[ProcessBottleneck] = None

implementation_plan: str | None = None

optimization_goals: List[str] = None

optimization_id: str = None

process_type: ProcessType = None

proposed_changes: List[str] = None

workflow_name: str = None