Skip to content

Add docs for testbench-ai-service v1.0.0#7

Closed
LinddritAliu wants to merge 3 commits into
mainfrom
docs/testbench-ai-service-v1.0.0
Closed

Add docs for testbench-ai-service v1.0.0#7
LinddritAliu wants to merge 3 commits into
mainfrom
docs/testbench-ai-service-v1.0.0

Conversation

@LinddritAliu

Copy link
Copy Markdown
Contributor

No description provided.

@github-actions

Copy link
Copy Markdown
Contributor

Comment on lines +44 to +48
│ ├──────────┬─────────┬─────────┤ │
│ │Test Case │Test Case│ Defect │ │
│ │ Set │ Set │Expla- │ │
│ │ Reviews │ Descr. │nations │ │
│ └──────────┴────┬────┴─────────┘ │

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The spaces/ alignment of the text looks uneven in this section. In the first column there is a space after "Test Case" in the fist line, but in the second there is not.
Also the "Defect Explanations" cell is aligned to the left and not centered, with an extra space before the first line.

| [**Test Case Set Descriptions**](use-cases/test-case-set-descriptions.md) | `/test-case-set-descriptions` | Automatic generation of descriptive summaries for test case sets. |
| [**Defect Explanations**](use-cases/defect-explanations.md) | `/defect-explanations` | AI-generated explanations for defects found during test execution. |

## Where to Go Next

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Where to Go Next
## Where to go next


The service is built on [FastAPI](https://fastapi.tiangolo.com/) and [Uvicorn](https://www.uvicorn.org/), providing high-performance async request handling.

## Built-in Use Cases

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Built-in Use Cases
## Built-in use cases


[**TestBench AI Service**](https://github.com/imbus/testbench-ai-service) is a proxy server for [imbus TestBench](https://www.testbench.com) that integrates external AI / LLM providers to support multiple AI-driven use cases during test design and test execution.

## What It Does

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## What It Does
## What it does

- Loads configurable prompt templates (YAML) and renders them with project data.
- Sends the rendered prompts to the configured LLM provider and writes the results back to TestBench.

## Key Features

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Key Features
## Features


---

## Inspecting Prompts via API

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
## Inspecting Prompts via API
## Inspecting prompts via API

| `glossary` | Glossary content resolved from the `glossary` prompt config field (file path or inline text); falls back to a built-in default glossary |

### Optional: Glossary

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I think this subchapter needs a bit more information about what a glossary is and what it is used for. Maybe an example too, if you have one.

---

# Test Case Set Reviews

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The three use case chapters are missing a "How to use" sort of section, maybe with an example.

```bash
testbench-ai-service start
```

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change

```

2. Open [http://127.0.0.1:8010/docs](http://127.0.0.1:8010/docs) in a browser — the Swagger UI should load.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change

@k-mahlendorf k-mahlendorf left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here is your review!

@Snooz82 Snooz82 closed this Apr 20, 2026
@Snooz82 Snooz82 deleted the docs/testbench-ai-service-v1.0.0 branch April 20, 2026 14:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants