> ## Documentation Index > Fetch the complete documentation index at: https://eomer.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Analyze & Recommend > Profile a CSV and return the recommended forecast configuration. No job is created — this is a synchronous helper so the frontend can render an explanation panel before the user runs anything. ## OpenAPI ````yaml POST /agent/analyze openapi: 3.1.0 info: title: eomer.ai Forecasting API description: >- Production-grade time series forecasting and natural-language forecasting agent version: 0.1.0 servers: [] security: [] tags: - name: forecasting description: Time-series forecasting jobs - name: agent description: >- Natural-language forecasting: extract intent from a prompt, profile and recommend a model, and auto-submit a forecast. - name: tabular description: Classification and regression - name: fine-tuning description: Custom model training - name: storage description: Cloud dataset storage - name: estimates description: Cost and runtime estimation - name: system description: Health checks and model catalog paths: /agent/analyze: post: tags: - agent summary: Analyze Dataset description: >- Profile a CSV and return the recommended forecast configuration. No job is created — this is a synchronous helper so the frontend can render an explanation panel before the user runs anything. operationId: analyze_dataset_agent_analyze_post requestBody: content: multipart/form-data: schema: $ref: '#/components/schemas/Body_analyze_dataset_agent_analyze_post' responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/AgentAnalysisResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - HTTPBearer: [] components: schemas: Body_analyze_dataset_agent_analyze_post: properties: file: anyOf: - type: string contentMediaType: application/octet-stream - type: 'null' title: File prompt: type: string title: Prompt default: '' horizon: anyOf: - type: integer minimum: 1 - type: 'null' title: Horizon item_id_column: type: string title: Item Id Column default: item_id timestamp_column: type: string title: Timestamp Column default: timestamp target_column: type: string title: Target Column default: target type: object title: Body_analyze_dataset_agent_analyze_post AgentAnalysisResponse: properties: profile: $ref: '#/components/schemas/SeriesProfile' description: Statistical profile of the uploaded panel. recommendation: $ref: '#/components/schemas/PublicRecommendation' description: Recommended forecast configuration (public, vendor-free). rationale: items: type: string type: array title: Rationale description: Plain-English bullets, scrubbed of vendor names. additionalProperties: false type: object required: - profile - recommendation - rationale title: AgentAnalysisResponse description: >- Synchronous response from ``POST /agent/analyze``. Surfaces the data profile and the (client-safe) recommended configuration so the frontend can render an explanation panel before the user clicks ``Run``. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SeriesProfile: properties: total_rows: type: integer minimum: 0 title: Total Rows description: Total rows across all series. num_items: type: integer minimum: 0 title: Num Items description: Number of distinct item_ids in the panel. min_length: type: integer minimum: 0 title: Min Length description: Length of the shortest series. max_length: type: integer minimum: 0 title: Max Length description: Length of the longest series. avg_length: type: number minimum: 0 title: Avg Length description: Mean series length across all item_ids. frequency: $ref: '#/components/schemas/Frequency' description: Inferred sampling frequency. inferred_freq_str: anyOf: - type: string - type: 'null' title: Inferred Freq Str description: >- Raw pandas frequency alias (e.g. 'D', 'h', 'W-SUN'); None if unknown. missingness_ratio: type: number maximum: 1 minimum: 0 title: Missingness Ratio description: Fraction of NaN values in the target column. has_negatives: type: boolean title: Has Negatives description: >- True if any target value is < 0 (rules out percentage-based metrics). default: false covers_weekends: type: boolean title: Covers Weekends description: >- Whether the series includes Saturday/Sunday timestamps. False for weekday-only (business-day) series. Used to resolve relative horizons from the data's own calendar (e.g. '2 weeks' = 10 daily steps when weekends are absent, 14 when present). default: true value_min: anyOf: - type: number - type: 'null' title: Value Min value_max: anyOf: - type: number - type: 'null' title: Value Max candidate_seasonality: items: type: integer type: array title: Candidate Seasonality description: Detected seasonal periods (in time steps). Empty if none detected. suspected_covariates: items: type: string type: array title: Suspected Covariates description: >- Numeric/categorical columns other than ts/id/target that look like covariates. dataset_size: $ref: '#/components/schemas/DatasetSize' additionalProperties: false type: object required: - total_rows - num_items - min_length - max_length - avg_length - frequency - missingness_ratio - dataset_size title: SeriesProfile description: >- Statistical profile of an uploaded panel of time series. All numbers are aggregates over the full panel — no per-row data is retained or logged. Privacy constraint #9 in the project plan. PublicRecommendation: properties: model: type: string title: Model description: Public model value, e.g. 'eomer_pulse_l'. model_display_name: type: string title: Model Display Name description: Human label, e.g. 'eomer pulse L'. mode: type: string title: Mode description: Forecasting mode. prediction_length: type: integer title: Prediction Length description: Forecast horizon in steps. eval_metric: type: string title: Eval Metric description: Evaluation metric. batch_size: type: integer title: Batch Size description: Pipeline batch size. rationale: items: type: string type: array title: Rationale clarifications: items: type: string type: array title: Clarifications additionalProperties: false type: object required: - model - model_display_name - mode - prediction_length - eval_metric - batch_size title: PublicRecommendation description: >- Client-facing view of a Recommendation — vendor names are translated out. ``model`` is the public preset value (e.g. ``eomer_pulse_l``) and ``model_display_name`` its label (``eomer pulse L``). The internal engine preset never appears here. ``rationale`` / ``clarifications`` are scrubbed of any banned vendor/infra term as a safety net. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError Frequency: type: string enum: - half_hourly - hourly - daily - weekly - monthly - quarterly - unknown title: Frequency description: Inferred sampling frequency of a series. DatasetSize: type: string enum: - tiny - small - medium - large title: DatasetSize description: Coarse dataset-size category used by the rule-based prior. securitySchemes: HTTPBearer: type: http scheme: bearer ````