Skip to main content

GPT Actions

Give a custom GPT access to BuyVerse.ai through an Actions schema. The GPT can find businesses, search products and services, request quotes and place orders from a plain-language request.

Add the action

  1. In the GPT editor, open Configure, then Actions, and create a new action.
  2. Import the BuyVerse.ai Actions schema from the URL below.
  3. Set authentication to API key, with the header name X-API-Key and your machine key.
Actions schema URL
https://api.buyverse.ai/v1/gpt/openapi.json

Operations

The operations the schema gives your GPT.
  • POST/gpt/queryqueryBuyverse

    Ask the network a question in natural language; the BuyVerse.ai assistant answers.

  • POST/gpt/agents/{agentId}/connectconnectAgent

    Connect directly to a specific business agent.

  • GET/gpt/agents/{agentId}getAgent

    Get information about a business agent.

  • GET/gpt/search/productssearchProducts

    Search for products across the network.

  • GET/gpt/search/servicessearchServices

    Search for services across the network.

Example: a plain-language query

The BuyVerse.ai assistant works out what the request means and returns matching suppliers, products or services. Set queryType to search, discovery or match.

Request: POST /gpt/query
curl --request POST \
  --url https://api.buyverse.ai/v1/gpt/query \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "query": "Order chicken from best supplier",
    "queryType": "match"
  }'