Skip to content
The Switchboard Tool Registry
Python
Branch: master
Clone or download

Latest commit

Fetching latest commit…
Cannot retrieve the latest commit at this time.

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
logos
schemas
tools
.gitignore
.travis.yml
LICENSE
README.md

README.md

The Switchboard Tool Registry

This repository hosts the registry of all tools used by the Switchboard (https://switchboard.clarin.eu).

The repository has two important branches:

How to add a tool to the Switchboard

  1. Take any of the json files describing a service from the tools directory in the repository and rename it and modify it to describe your tool. The json file name must be descriptive and unique, and should match the tool name in the json file. The logo entry in the file should contain your unique logo file name. See the Tool description specification for more detailed explanations on the meaning of each field.
  2. Add the new json file to a new branch in your own fork of the repository, in the tools directory.
  3. Add the logo file to the same branch, in the logos directory.
  4. Make sure that the new json file is correct according to the json schema defined in the specification file: spec-v1.schema.json. You can use one of the online schema validators (see https://json-schema.org/implementations.html#validators), or locally run the python script validate-all-tools.py in the schemas directory.
  5. Make sure your tool responds correctly when called by the Switchboard. See the Tool Call API for more detailed explanations on how a tool is called and what parameters are being sent to the tool.
  6. Create a pull request for merging your branch in the master branch of this repository.
  7. After the pull request has been merged, check the availability of your tool in the development instance of the Switchboard: https://beta-switchboard.clarin.eu.
  8. If you are satisfied with how the tool is integrated, create a new issue requesting the publication of your changes from master to production. Our team will do the merge and close the issue.

Documentation links

The Tool description specification provides more information on the json description of the tools.

For details on how a tool is matched for a specific resource, see the Tool Matching document.

For details on how a tool is actually invoked when selected by the user, see the Tool Call API document.

You can’t perform that action at this time.