Skip to content

Latest commit

 

History

History
304 lines (229 loc) · 16.4 KB

README.md

File metadata and controls

304 lines (229 loc) · 16.4 KB

IMPORTANT NOTE: IF YOU ARE USING CLooI TO TALK TO SYDNEY

The default settings file is configured with a Copilot Pro cookie, but there is an hourly rate limit for user on the model. If you have your own Copilot Pro account, copy your own Copilot Pro cookie into bingAIClient.cookies. If it doesn't work, try replacing only the cookies that are different between the default cookies string and your cookies.

Bingleton API and CLooI

If you are a complete n00b to coding, you can consult the n00b's guide to running the CLooI which is written for non-coders unlike some of this readme.

Prerequisites

  • Node.js >= 16.0.0
  • npm

Install instructions

  1. Clone this repository: git clone [email protected]:socketteer/bingleton-api.git
  2. Install dependencies with npm install
  3. Rename settings.example.js to settings.js in the root directory and change the settings where required.
    • Note: When pulling changes from this repo, attend to changes to settings.example.js which you may want or need to copy over to your settings.js file.

CLooI instructions

CLooI

The CLI (Command Loom Interface) app allows you to interact with the chat client using a command line interface and save and load (branching) conversation histories.

Running the CLI app

npm run cli

Commands

Running the app will prompt you to enter a message.

You can also enter commands (prepended with !). Entering ! will show the list of currently available commands.

The !help command will show a list of commands and their descriptions. You can also use !help [command] or <command> --help to get more information about a specific command.

Show/hide CLooI command descriptions
  • !help [command] | --help: Show command documentation.

    • [command]: If provided, show the documentation for that command, otherwise shows documentation for all commands.
  • !mu: Regenerate the last response. Equivalent to running !rw -1 and then !gen.

  • !gen: Generate a response without sending an additional user message

  • !save [name]: Save a named pointer to the current conversation state

    • [name]: If a name is provided, it will save the state with that name, otherwise a prompt will appear.
  • !load [name]: Load a saved conversation state.

    • [name]: If a name is provided, it will load the state with that name, otherwise a prompt will appear showing saved states.
  • !new: Start a new conversation.

  • !rw [index]: Rewind to a previous message.

    • [index]: If positive, rewind to message with that index. If negative, go that many steps backwards from the current index. If not provided, a prompt will appear to choose where in conversation history to rewind to.
  • !fw [index]: Go forward to a child message.

    • [index]: If positive, go to the child message with that index. If 0, go to the first child message. If not provided, a prompt will appear to choose which child message to go to.
  • !alt [index]: Go to a sibling message.

    • [index]: Index of sibling message. If not provided a prompt will appear to choose which sibling message to go to.
  • !w: Navigate to the parent message. Equivalent to running !rw -1.

  • !>: Go right / to the next sibling.

  • !<: Go left / to the previous sibling.

  • !cp [type]: Copy data to clipboard.

    • [type]: If provided, copy the data of that type. If not provided, a prompt will appear to choose which data to copy.
  • !pr [type]: Print data to console.

    • [type]: If provided, print the data of that type. If not provided, a prompt will appear to choose which data to print.
  • !ml: Open the editor (for multi-line messages). When changes are saved and the editor is closed, the message will be sent.

  • !edit: Opens the text of the current message in the editor. If you make changes and save, a copy of the message (with the same author and type) will be created as a sibling message.

  • !concat [message]: Concatenate message(s) to the conversation.

    • [message]: If provided, concatenate the message as a user message. If not provided, the editor will open, and you write either a single message or multiple messages in the standard transcript format.
  • !merge: Creates a new sibling of the parent message with the last message's text appended to the parent message's text, and which inherits other properties of the parent like author.

  • !history: Display conversation history in formatted boxes. If you want to copy the raw conversation history transcript, use !cp history or !pr history instead.

  • !exit: Exit CLooI.

  • !resume: Resume the last conversation.

  • !export [filename]: Export conversation tree to JSON.

    • [filename]: If provided, export the conversation tree to a file with that name, otherwise a prompt will appear to choose a filename.
  • !open <id>: Load a saved conversation by id.

    • <id>: The id of the conversation to load.
  • !debug: Run debug command.


Changing default options

The default options for the CLI app are stored in settings.js, under cliOptions. You can change the default options by modifying this file. The changes to the settings will take effect when the file is saved.

The system prompt (passed as a request parameter for Claude, prepended to prompt for Infrastruct, injected after Bing's normal system prompt) defaults are stored in text files in contexts/ specified separately for each client in settings.js/cliOptions. You can change the content of the files to change the default system prompt and context, or point to different files in settings.js, or write the desired system prompt string directly in settings.js. The contexts/ folder also contains alternative system prompts.

Saving and loading conversation states

All messages are saved in cache.json, but you can save a named pointer to a specific conversation state using the !save command. You can then load the conversation state at that point using the !load command.

BingAIClient

sendMessage parameters
  • message: The user message to send to the API. String.
  • opts: A dictionary of options to configure the API request:
    • parentMessageId: The id of the parent message in the conversation. If not provided, the message will be treated as the first message in the conversation.
    • jailbreakConversationId: The id of the conversation in the cache. Set to true to start a new conversation.
    • toneStyle: Determines the model and changes MSFT's backend settings.
      • 'creative': Prometheus
      • 'precise': Deucalion
      • 'balanced': Deucalion
      • 'fast': probably ChatGPT-3.5
    • injectionMethod: Determines how new user messages are injected into the conversation.
      • 'message': Inject new user messages as new messages in the conversation.
      • 'context': Inject new user messages the last message in the injected context and set user message to userMessageInjection value.
    • userMessageInjection: The message to inject into the user message when injectionMethod is set to 'context' or when no user message is provided.
    • systemMessage: Text of the system message to append to Bing's instructions under the heading [system](#additional_instructions).
    • context: Text of the context to inject into the conversation (acts like web page context)
    • censoredMessageInjection: String to append to messages that get cut off by Bing's filter in the conversation history.
    • appendMessages: optional array of messages or string in standard format to append to the conversation history. Messages will be appended in the order they are provided, and before the user message.

Bing prompt injection format

If jailbreakConversationId, injectionMethod = 'message', and message is not empty, a call to the Bing AI Client results in a prompt which looks (from Bing's end) like:

prompt = ```
[system](#instructions)
# I'm Microsoft Copilot:
...
context
- Time at the start of this conversation is ${userDateTime} The user is located in ${userLocation}.
- User's language might be different from the language commonly spoken in their location.
- The user has the page open in a Microsoft Edge browser window whose metadata is:
${browserMetadata}
${context}
[system](#additional_instructions)
${systemMessage}
${previousMessages}
${appendMessages}
[user](#message)
${message}
[assistant](#message)

(as of 2024-020-19, verified by Bing)

API

  • Start the server:
    • using npm start or npm run server (if not using Docker)
    • using docker-compose up (requires Docker)

Endpoints

POST /conversation

Start or continue a conversation. Optional parameters are only necessary for conversations that span multiple requests.

Field Description
message The message to be displayed to the user.
conversationId (Optional) An ID for the conversation you want to continue.
jailbreakConversationId (Optional, for BingAIClient only) Set to true to start a conversation in jailbreak mode. After that, this should be the ID for the jailbreak conversation (given in the response as a parameter also named jailbreakConversationId).
parentMessageId (Optional, for ChatGPTClient, and BingAIClient in jailbreak mode) The ID of the parent message (i.e. response.messageId) when continuing a conversation.
conversationSignature (Optional, for BingAIClient only) A signature for the conversation (given in the response as a parameter also named conversationSignature). Required when continuing a conversation unless in jailbreak mode.
clientId (Optional, for BingAIClient only) The ID of the client. Required when continuing a conversation unless in jailbreak mode.
invocationId (Optional, for BingAIClient only) The ID of the invocation. Required when continuing a conversation unless in jailbreak mode.
clientOptions (Optional) An object containing options for the client.
clientOptions.clientToUse (Optional) The client to use for this message. Possible values: chatgpt, chatgpt-browser, bing.
clientOptions.* (Optional) Any valid options for the client. For example, for ChatGPTClient, you can set clientOptions.openaiApiKey to set an API key for this message only, or clientOptions.promptPrefix to give the AI custom instructions for this message only, etc.

To configure which options can be changed per message (default: all), see the comments for perMessageClientOptionsWhitelist in settings.example.js. To allow changing clients, perMessageClientOptionsWhitelist.validClientsToUse must be set to a non-empty array as described in the example settings file.

Usage

Method 1 (POST)

To start a conversation with ChatGPT, send a POST request to the server's /conversation endpoint with a JSON body with parameters per Endpoints > POST /conversation above.

{
    "message": "Hello, how are you today?",
    "conversationId": "your-conversation-id (optional)",
    "parentMessageId": "your-parent-message-id (optional, for `ChatGPTClient` only)",
    "conversationSignature": "your-conversation-signature (optional, for `BingAIClient` only)",
    "clientId": "your-client-id (optional, for `BingAIClient` only)",
    "invocationId": "your-invocation-id (optional, for `BingAIClient` only)",
}

The server will return a JSON object containing ChatGPT's response:

// HTTP/1.1 200 OK
{
    "response": "I'm doing well, thank you! How are you?",
    "conversationId": "your-conversation-id",
    "messageId": "response-message-id (for `ChatGPTClient` only)",
    "conversationSignature": "your-conversation-signature (for `BingAIClient` only)",
    "clientId": "your-client-id (for `BingAIClient` only)",
    "invocationId": "your-invocation-id (for `BingAIClient` only - pass this new value back into subsequent requests as-is)",
    "details": "an object containing the raw response from the client"
}

If the request is unsuccessful, the server will return a JSON object with an error message.

If the request object is missing a required property (e.g. message):

// HTTP/1.1 400 Bad Request
{
    "error": "The message parameter is required."
}

If there was an error sending the message to ChatGPT:

// HTTP/1.1 503 Service Unavailable
{
    "error": "There was an error communicating with ChatGPT."
}
Method 2 (SSE)

You can set "stream": true in the request body to receive a stream of tokens as they are generated.

import { fetchEventSource } from '@waylaidwanderer/fetch-event-source'; // use `@microsoft/fetch-event-source` instead if in a browser environment

const opts = {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json',
    },
    body: JSON.stringify({
        "message": "Write a poem about cats.",
        "conversationId": "your-conversation-id (optional)",
        "parentMessageId": "your-parent-message-id (optional)",
        "stream": true,
        // Any other parameters per `Endpoints > POST /conversation` above
    }),
};

See demos/use-api-server-streaming.js for an example of how to receive the response as it's generated. You will receive one token at a time, so you will need to concatenate them yourself.

Successful output:

{ data: '', event: '', id: '', retry: 3000 }
{ data: 'Hello', event: '', id: '', retry: undefined }
{ data: '!', event: '', id: '', retry: undefined }
{ data: ' How', event: '', id: '', retry: undefined }
{ data: ' can', event: '', id: '', retry: undefined }
{ data: ' I', event: '', id: '', retry: undefined }
{ data: ' help', event: '', id: '', retry: undefined }
{ data: ' you', event: '', id: '', retry: undefined }
{ data: ' today', event: '', id: '', retry: undefined }
{ data: '?', event: '', id: '', retry: undefined }
{ data: '<result JSON here, see Method 1>', event: 'result', id: '', retry: undefined }
{ data: '[DONE]', event: '', id: '', retry: undefined }
// Hello! How can I help you today?

Error output:

const message = {
  data: '{"code":503,"error":"There was an error communicating with ChatGPT."}',
  event: 'error',
  id: '',
  retry: undefined
};

if (message.event === 'error') {
  console.error(JSON.parse(message.data).error); // There was an error communicating with ChatGPT.
}

Notes

  • Method 1 is simple, but Time to First Byte (TTFB) is long.
  • Method 2 uses a non-standard implementation of server-sent event API; you should import fetch-event-source first and use POST method.