Skip to content

🧑‍💻 Iterate over detectors API to include multiple endpoints #40

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
May 22, 2024

Conversation

gkumbhat
Copy link
Collaborator

Changes

  • Divide detectors API into multiple endpoints to cover more variety of detectors.
  • This PR only updates the detectors API documentation for easy sharing of the API.

Note: API is still in iteration and we will update the orchestrator client once its finalized / stable in story #37

- type
- loc
- msg
- type
Copy link
Collaborator

Choose a reason for hiding this comment

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

If we're expecting detectors to give these validation errors I think we should revisit this, since this "loc", "type" concept is based on FastAPI and may not make sense generally for most detector servers

role:
allOf:
- $ref: '#/components/schemas/RoleEnum'
description: 'Who wrote the message: [<enum ''RoleEnum''>]'
Copy link
Collaborator

Choose a reason for hiding this comment

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

Based on this description I would think something like author may be more appropriate? "Role" of a message seems a bit open-ended, like "what is the role of this message?" e.g. persuasion. Or perhaps the description may need to be more specific?

application/json:
schema:
$ref: '#/components/schemas/Error'
/api/v1/text/context/doc:
Copy link
Collaborator

Choose a reason for hiding this comment

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

Could we potentially add in the summary and/or description how doc plays into this endpoint?

Copy link
Collaborator

@evaline-ju evaline-ju left a comment

Choose a reason for hiding this comment

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

LGTM

@gkumbhat gkumbhat merged commit 3a01d11 into foundation-model-stack:main May 22, 2024
1 check passed
@gkumbhat gkumbhat deleted the update_detector_api branch May 22, 2024 19:38
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