101 lines
4.3 KiB
Markdown
101 lines
4.3 KiB
Markdown
# Knowledge One View CLI CODEX Skill
|
|
|
|
This Codex skill lets Codex fetch and analyze Oracle Analytics LAD Knowledge One View data through direct Oracle DV backend APIs, without manual browser scraping.
|
|
|
|
Use it for LAD sales, presales, pipeline, opportunity, workload, revenue-line, service-request, and team-result questions. Codex can also turn the data into follow-up work: targeted email drafts, spreadsheets, presentations, WON mapping, resource summaries, and manager-ready HTML reports.
|
|
|
|
IMPORTANT: This skill was developed assuming the user has manager access in the LAD Knowledge One View DV. If you do not have this access in the DV, the skill might not work.
|
|
|
|
LAD Knowledge One View DV:
|
|
https://salesintelligence-dv.oracle.com/ui/dv/ui/project.jsp?pageid=visualAnalyzer&reportmode=presentation&reportpath=%2F%40Catalog%2Fshared%2FTeam%20Sharing%20Area%2FLAD%2FLAD%20Sales%20Operations%2FLAD%20Production%2FLAD%20Knowledge%20One%20View
|
|
|
|
## What Codex Can Do With This Skill
|
|
|
|
With this skill installed, Codex can help you:
|
|
|
|
- Create a presentation showing WON activity for a team, seller, manager, resource, or fiscal week.
|
|
- Generate spreadsheets, presentation-ready summaries, and targeted email drafts from the results.
|
|
- Filter by close date, month, fiscal quarter, week, custom window, seller, manager, resource, or team.
|
|
- Return answers with scope, source, defaults, filters, row counts, warnings, and assumptions.
|
|
|
|
In practice, you can ask Codex questions like:
|
|
|
|
```text
|
|
Show Brazil opportunities closing in FY26-Q4 for the Brazil cluster for the seller <seller.email@oracle.com>.
|
|
```
|
|
|
|
```text
|
|
List workloads closing next week that have allocated resources under manager <manager.email@oracle.com>.
|
|
```
|
|
|
|
```text
|
|
Get SRs for resource <resource.email@oracle.com> and explain the scope used.
|
|
```
|
|
|
|
```text
|
|
Map WON workloads for team <team-or-manager-placeholder> in week <FY26-Q4-09> and generate a spreadsheet.
|
|
```
|
|
|
|
```text
|
|
Draft email for resources in <resource-list-placeholder> listing their WON oportunities in march/26.
|
|
```
|
|
|
|
Codex will choose the shortest safe path, normally by running `scripts/fetch-sales-intelligence.mjs` with an intent, view, query, or SQL mode.
|
|
|
|
## How It Works
|
|
|
|
Clone from Git and install the skill, then ask Codex for Knowledge One View data or an output based on it. If authentication is needed, Codex opens Chrome so you can complete the Oracle login flow.
|
|
|
|
IMPORTANT: Chrome is mandatory for authentication (SSO and MFA). After the session is valid, Codex continues browserless: it calls the Oracle DV backend APIs directly, receives the backend data, applies the requested filters or intent, and returns the answer or creates the requested output. Chrome is reopened only when the saved session expires or needs to be refreshed.
|
|
|
|
## Installation From Git
|
|
|
|
Clone the skill:
|
|
|
|
```bash
|
|
cd ~/.codex/skills
|
|
git clone https://git.tech-lad.com.br/marceloarbore/knowledge-one-view-cli.git
|
|
```
|
|
|
|
Ask CODEX to install and test the skill (after it you will ahve to bestart CODEX)
|
|
|
|
```bash
|
|
CODEX: Please install the knowledge-one-view-cli skill (already in your skill folder) and test it
|
|
```
|
|
|
|
After installing or updating the skill, restart Codex or reload the session so the skill list is refreshed.
|
|
|
|
|
|
## Other useful commands:
|
|
|
|
Optional: Create a branch for you before editing it locally (so you can contribute back to the repo later on):
|
|
|
|
```bash
|
|
cd ~/.codex/skills/knowledge-one-view-cli
|
|
git checkout -b feature/my-name
|
|
```
|
|
|
|
Optional: In case you want to downlaod the last bersion of the skill, use pull command
|
|
|
|
```bash
|
|
cd ~/.codex/skills/knowledge-one-view-cli
|
|
git pull origin main
|
|
```
|
|
|
|
Optional: In case you have broke the skill and want to restore to original from server, use reset command (caution: you will lose local updates)
|
|
|
|
```bash
|
|
cd ~/.codex/skills/knowledge-one-view-cli
|
|
git fetch origin main
|
|
git reset --hard origin/main
|
|
```
|
|
|
|
OBS: Live data access requires manager permission to access the Sales Intelligence Knowledge One View workbook.
|
|
|
|
## Notes For Contributors
|
|
|
|
- Keep stable Codex instructions in `SKILL.md`.
|
|
- Put detailed CLI behavior and field mappings in `references/`.
|
|
- Add tests when changing intents, query behavior, SQL builders, scope disclosure, or output contracts.
|
|
- Keep generated outputs, temporary files, and local workspace artifacts outside the skill repository whenever possible.
|