OAK Search – Getting Started
Welcome to OAK Search – the web interface for exploring the OAK knowledge base at app.jentic.com.
With OAK Search you can discover 1 000 + workflows, 57 000 + operations and more than 1 400 public APIs through lightning‑fast semantic search.
Table of Contents
- Why OAK Search?
- Quick Start (60 seconds)
- Key Concepts
- The Search Dashboard
- Finding All Workflows for a Specific API
- Workflow Detail View
- Copying a Workflow UUID
- Next Steps
- End‑to‑End Walkthrough Video
- Community & Support
Why OAK Search?
- Semantic discovery – powered by vector embeddings to surface the most relevant workflows and operations, even when you don’t know the exact name.
- Single pane of glass – browse thousands of 3rd‑party APIs in one place – no more juggling docs or SDK tabs.
- Deep inspection – drill into every workflow’s spec, execution path and referenced operations.
- Open & extensible – OAK Runner is a standalone Python package and CLI tool that lets you execute and orchestrate Arazzo workflows and OpenAPI operations directly from your terminal or CI/CD pipeline.
Quick Start (60 seconds)
- Open app.jentic.com in your browser.
- Type a query in the search bar, e.g.
discord message
orstripe refund
. - Filter by APIs, Workflows or Operations using the drop‑down.
- Click a result card to open the detailed workflow inspector.
Tip – queries are fuzzy & semantic, so plain‑language searches like “create calendar event” work beautifully.
Key Concepts
Concept | Icon Color | Description |
---|---|---|
Workflow | 🟩 | A reusable multi‑step procedure (e.g. interact‑with‑a‑message). |
Operation | 🟪 | A single HTTP action / RPC call inside a workflow. |
API | 🔵 | The upstream service the operation talks to (e.g. Discord API). |
The Search Dashboard
When you search, each result card shows:
- Title – a human-friendly name.
- Type badge – Workflow, Operation or API.
- API domain – e.g.
discord.com
. - Description – a short description pulled from the specification.
Use Search Options to filter by:
- Specific API domains.
- Result type.
- HTTP method, auth requirements and more.
- Number of results.
Finding All Workflows for a Specific API
If you want to see every workflow that touches a particular service, you have two easy options:
- Search
discord.com
(replace with any domain) into the search bar.
- Select
Discord.com
to view the range of Workflows and Operations which are available.
Workflow Detail View
Opening a workflow reveals a four‑tab inspector: 1. Visualization – interactive Visualization of the execution path.
- Steps Details – parameters, flow‑control and operation IDs.
- APIs Referenced – audit every external dependency.
- Raw Spec – the full JSON specification.
Copying a Workflow UUID
Every workflow page displays a Copy UUID button in the header. Use this identifier to:
- Execute the workflow using OAK Runner.
OAK Runner
OAK Runner is a standalone Python package and CLI tool for executing and orchestrating Arazzo workflows and OpenAPI operations directly from your terminal or CI/CD pipeline.
- PyPI: pypi.org/project/oak-runner
- Install:
pip install oak-runner
See the PyPI page for detailed usage, CLI commands, and examples.
Next Steps
Want to… | Try this |
---|---|
Run a workflow locally | Install OAK Runner and run oak-runner <uuid> . |
Integrate with your app | Use the UUID with the MCP Service for programmatic orchestration. |
Share a workflow | Send the page URL. |
Contribute | Join the community (see below) and open a PR or issue on GitHub. |
End‑to‑End Walkthrough Video
The video below demonstrates the entire flow: searching, selecting a workflow, exploring each inspection tab.