> For the complete documentation index, see [llms.txt](https://whitepaper.aitech.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://whitepaper.aitech.io/agentforge/execution-engine/advanced.md).

# advanced

Agent Forge provides comprehensive logging for workflow executions and automatic cost calculation for AI model usage.

## Logging System

Agent Forge offers two complementary logging interfaces:

### Real-Time Console (Manual Executions)

During manual workflow execution, logs appear in real-time in the Console panel on the right side of the workflow editor.

The console shows:

* Block execution progress with active block highlighting
* Real-time outputs as blocks complete
* Execution timing for each block
* Success/error status indicators

### Logs Page (All Executions)

All workflow executions—whether triggered manually, via API, Chat, Schedule, or Webhook—are logged to the dedicated Logs page.

The Logs page provides:

* Comprehensive filtering by time range, status, trigger type, folder, and workflow
* Search functionality across all logs
* Live mode for real-time updates
* 7-day log retention (upgradeable for longer retention)

## Log Details Sidebar

Clicking on any log entry opens a detailed sidebar view.

### Block Input/Output

View the complete data flow for each block with tabs to switch between:

{% tabs %}
{% tab title="Output" %}
**Output Tab** shows the block's execution result:

* Structured data with JSON formatting
* Markdown rendering for AI-generated content
* Copy button for easy data extraction
  {% endtab %}

{% tab title="Input" %}
**Input Tab** displays what was passed to the block:

* Resolved variable values
* Referenced outputs from other blocks
* Environment variables used
* API keys are automatically redacted for security
  {% endtab %}
  {% endtabs %}

### Execution Timeline

For workflow-level logs, view detailed execution metrics:

* Start and end timestamps
* Total workflow duration
* Individual block execution times
* Performance bottleneck identification

### Model Breakdown

For workflows using AI blocks, expand the Model Breakdown section to see:

* **Token Usage**: Input and output token counts for each model
* **Cost Breakdown**: Individual costs per model and operation
* **Model Distribution**: Which models were used and how many times
* **Total Cost**: Aggregate cost for the entire workflow execution

### Workflow Snapshot

For any logged execution, click "View Snapshot" to see the exact workflow state at execution time.

The snapshot provides:

* Frozen canvas showing the workflow structure
* Block states and connections as they were during execution
* Click any block to see its inputs and outputs
* Useful for debugging workflows that have since been modified

{% hint style="info" %}
Workflow snapshots are only available for executions after the enhanced logging system was introduced. Older migrated logs show a "Logged State Not Found" message.
{% endhint %}

## Cost Calculation

Agent Forge automatically calculates costs for all AI model usage:

### How Costs Are Calculated

Every workflow execution includes two cost components:

**Base Execution Charge**: $0.001 per execution

**AI Model Usage**: Variable cost based on token consumption

```javascript
modelCost = (inputTokens × inputPrice + outputTokens × outputPrice) / 1,000,000
totalCost = baseExecutionCharge + modelCost
```

{% hint style="info" %}
AI model prices are per million tokens. The calculation divides by 1,000,000 to get the actual cost. Workflows without AI blocks only incur the base execution charge.
{% endhint %}

### Pricing Options

{% hint style="warning" %}
Pricing shown reflects rates as of July 14, 2025. Check provider documentation for current pricing.
{% endhint %}

### Cost Optimization

<details>

<summary>Model Selection</summary>

Choose models based on task complexity. Simple tasks can use GPT-4.1-nano ($0.10/$0.40) while complex reasoning might need o1 or Claude Opus.

</details>

<details>

<summary>Prompt Engineering</summary>

Well-structured, concise prompts reduce token usage without sacrificing quality.

</details>

## Usage Monitoring

Monitor your usage and billing in Settings → Subscription:

* **Current Usage**: Real-time usage and costs for the current period
* **Usage Limits**: Plan limits with visual progress indicators
* **Billing Details**: Projected charges and minimum commitments
* **Plan Management**: Upgrade options and billing history


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://whitepaper.aitech.io/agentforge/execution-engine/advanced.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.