Skip to content

[feature][ai-layer] Add connector builder LLM eval definitions#55

Closed
sarthak-kapoor-glean wants to merge 7 commits into
feature/v0-workstreamfrom
feature/connector-builder-llm-evals
Closed

[feature][ai-layer] Add connector builder LLM eval definitions#55
sarthak-kapoor-glean wants to merge 7 commits into
feature/v0-workstreamfrom
feature/connector-builder-llm-evals

Conversation

@sarthak-kapoor-glean

Copy link
Copy Markdown

Problem

The connector-builder skills need LLM-backed eval definitions so we can test whether agents actually follow the workflow, not just whether local artifact validation works.

Solution

  • Add Scio-style trigger evals for positive and negative connector-builder activation prompts.
  • Add credential-free quality eval prompts covering docs-only, missing docs, incremental requests, push-layer-only, full connector flow, and Webex docs-only planning.
  • Add a grading rubric focused on docs confirmation, API exploration behavior, planning discipline, SDK usage mode, auth separation, pull/push boundaries, full-crawl handling, and secret redaction.
  • Document local/manual LLM eval execution and a future non-blocking/nightly CI path.

Validation

  • python -m json.tool skills/connector-builder/evals/evals.json >/tmp/connector_builder_evals.json
  • python -m json.tool skills/connector-builder/evals/trigger_eval_set.json >/tmp/connector_builder_trigger_evals.json
  • npm run test:plugins

Notes

  • These evals are intentionally credential-free: no live source API calls and no Glean uploads.
  • This PR only adds eval definitions and rubric. A future PR can wire a Claude/Cursor runner for local or CI execution.
  • The repository does not currently have .github/pull_request_template.md; this body follows the required problem/solution/validation structure manually.

Made with Cursor

sarthak-kapoor-glean and others added 6 commits June 29, 2026 15:41
Add the core connector-builder skill, API exploration skill, and local validation/generation CLI so agents can prepare cited .glean artifacts before writing connector code.

Co-authored-by: Cursor <cursoragent@cursor.com>
Make API exploration the first connector-builder phase, add pull and push layer skills, and capture load, auth, and Glean endpoint planning before generation.

Co-authored-by: Cursor <cursoragent@cursor.com>
Move artifact creation and code generation back into the skills, keep .glean scoped to each connector folder, and validate confirmed plans plus test and production auth before implementation.

Co-authored-by: Cursor <cursoragent@cursor.com>
Keep the end-to-end workflow in the top-level connector-builder skill, require an explicit SDK usage choice, and leave supporting skills focused on their local responsibilities.

Co-authored-by: Cursor <cursoragent@cursor.com>
Remove datasource-specific examples, clarify SDK usage choices, and require generated connectors to use the SDK pull recipe base classes.

Co-authored-by: Cursor <cursoragent@cursor.com>
Add Scio-style trigger and quality eval prompts plus a rubric for credential-free connector-builder skill behavior evaluation.

Co-authored-by: Cursor <cursoragent@cursor.com>
@sarthak-kapoor-glean sarthak-kapoor-glean requested a review from a team as a code owner June 30, 2026 14:31
Make synthetic evals self-contained with inline API docs and require the Webex eval to fetch public docs or OpenAPI before producing validation-ready artifacts.

Co-authored-by: Cursor <cursoragent@cursor.com>
@ishan-chawla-glean

Copy link
Copy Markdown

can you tell more about the use of this and output?

Base automatically changed from feature/connector-builder-core-api-exploration to feature/v0-workstream July 1, 2026 08:23
@sarthak-kapoor-glean

Copy link
Copy Markdown
Author

This is not needed. We will plan to have evals in some other way without exposing in SDK user facing code

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.

2 participants