> ## Documentation Index
> Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Excel Formula Generator

> Generate Excel formulas from descriptions

# Excel Formula Generator

Generate Excel formulas from descriptions

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
flowchart LR
    A[Input] --> B[Excel Formula Generator]
    B --> C[Process with AI]
    C --> D[Output/Artifacts]
    
    style A fill:#e1f5fe
    style D fill:#c8e6c9
```

## CLI Quickstart (Beginner)

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
# Install
pip install praisonai praisonai-tools

# Run the tool
praisonai recipe run ai-excel-formula-generator \
  --input '{"input": "your-input-here"}' \
  --json

# With output directory
praisonai recipe run ai-excel-formula-generator \
  --input-file config.json \
  --out-dir ./output
```

**Output:**

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "ok": true,
  "run_id": "run_abc123",
  "recipe": "ai-excel-formula-generator",
  "output": {},
  "artifacts": [],
  "warnings": [],
  "error": null
}
```

## Use in Your App (Embedded SDK)

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai.recipe import run, run_stream

# Basic usage
result = run(
    "ai-excel-formula-generator",
    input={
        "input": "your-input-here"
    }
)

print(f"Success: {result.ok}")
print(f"Output: {result.output}")

# With streaming (if supported)
for event in run_stream("ai-excel-formula-generator", input={}):
    print(event)
```

## Use as a Server (HTTP Sidecar)

### Start Server

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai serve recipe --port 8080
```

### Invoke via curl

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
curl -X POST http://localhost:8080/v1/recipes/run \
  -H "Content-Type: application/json" \
  -d '{
    "recipe": "ai-excel-formula-generator",
    "input": {"input": "your-input-here"}
  }'
```

### With Authentication (Remote Runner)

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
export PRAISONAI_ENDPOINTS_URL=https://api.praisonai.com
export PRAISONAI_ENDPOINTS_API_KEY=your-key

curl -X POST $PRAISONAI_ENDPOINTS_URL/v1/recipes/run \
  -H "X-API-Key: $PRAISONAI_ENDPOINTS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"recipe": "ai-excel-formula-generator", "input": {}}'
```

## Input / Output Schema

### Input Schema

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "type": "object",
  "properties": {
    "input": {"type": "string", "description": "Primary input"},
    "options": {"type": "object", "description": "Additional options"}
  },
  "required": ["input"]
}
```

### Output Schema

```json theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
{
  "ok": true,
  "run_id": "string",
  "recipe": "ai-excel-formula-generator",
  "output": {},
  "artifacts": [{"path": "string", "type": "string"}],
  "warnings": [],
  "error": null
}
```

## Integration Models

### Model 1: Embedded SDK

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonai.recipe import run, run_stream
result = run("ai-excel-formula-generator", input={"input": "data"})
```

### Model 2: CLI Invocation

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai recipe run ai-excel-formula-generator --input-file config.json --json
```

### Model 3: Local HTTP Sidecar

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
praisonai serve recipe --port 8080
curl -X POST http://localhost:8080/v1/recipes/run -d '...'
```

### Model 4: Remote Managed Runner

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
import os
os.environ["PRAISONAI_ENDPOINTS_URL"] = "https://api.praisonai.com"
os.environ["PRAISONAI_ENDPOINTS_API_KEY"] = "your-key"
```

### Model 5: Event-Driven

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
queue.publish("recipes.run", {
    "recipe": "ai-excel-formula-generator",
    "input": {},
    "callback_url": "https://your-app.com/webhook"
})
```

### Model 6: Plugin Mode

```python theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
from praisonaiagents import Agent
agent = Agent(name="Worker", tools=["ai-excel-formula-generator"])
```

```mermaid theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
flowchart TD
    Q{Integration Need?}
    Q -->|Direct control| SDK[Embedded SDK]
    Q -->|Automation| CLI[CLI Invocation]
    Q -->|Microservice| SIDE[Local Sidecar]
    Q -->|Scale| REMOTE[Remote Runner]
    Q -->|Async| EVENT[Event-Driven]
    Q -->|Multi-agent| PLUGIN[Plugin Mode]
```

## Operational Notes

### Dependencies

```bash theme={"theme":{"light":"vitesse-light","dark":"vitesse-dark"}}
pip install praisonai-tools
# Requires: LLM
```

### Performance Tips

* Use `--stream` for progress on long operations
* Enable caching for repeated inputs
* Use batch mode for multiple items

### Security Notes

* File paths are sandboxed
* Secrets are redacted in logs
* PII handling follows GDPR guidelines

### Troubleshooting

| Issue              | Solution                  |
| ------------------ | ------------------------- |
| Missing dependency | Install required extras   |
| Timeout            | Increase `--timeout-sec`  |
| Invalid input      | Check schema requirements |

## Related Tools

* [Report Generator](/docs/examples/agent-recipes/data/ai-report-generator)
* [Chart Generator](/docs/examples/agent-recipes/data/ai-chart-generator)
* [Sentiment Analyzer](/docs/examples/agent-recipes/data/ai-sentiment-analyzer)