Plugin Protocol
GPTBots Plugin is a plugin that can connect to third-party APIs and call third-party data and services through LLM.
The plugin protocol of GPTBots follows the OpenAPI Specification (OAS) format and defines a standard, language-independent HTTP API that allows humans and computers to understand the functions of the service.
Example
Fields Description
Field | Required | Description |
---|---|---|
operationId | √ | Name of API, can be composed of English and underscores, no spaces are allowed. e.g. getAdCode, get_Ad_Code |
description (API) | √ | Clear description of the API's function, the LLM will determine the timing of calling the API. 200 characters limited. |
parameters - name | √ | Name of parameter field. e.g. key |
parameters - in | √ | Position of parameter. Supported: path/query (parameters appended after the url)/header (custom request headers used in the request)/cookie |
parameters -description | √ | Clear description of parameters' meaning. 200 characters limited. |
parameters -type | √ | Type of field. Supported: integer/number/string/boolean |
Plugin Development Specification Guide
A plugin is allowed to contain up to 5 APIs, and GPTBots recommends that plugins should be configured with as few APIs as possible;
Developers should not try to control the mood, personality, or exact response of the LLM through the description;
The descriptions field should not encourage LLM to use the plugin when the user's question is not related to the specific service provided by the plugin;
Do not set specific trigger conditions for plugins;
Plugin API responses should return raw data, not natural language responses, unless necessary. LLM will use the returned data to provide its own natural language response.
Last updated