GeinDock Suite
Home › Meet the Co-Scientist

Meet the Co-Scientist

The research assistant built into the application: what it is, what it needs, how to open its panel, and what each part of the panel and each connection state means.

The GeinDock Co-Scientist is a research assistant built into the application. You type a request in ordinary language, and it either answers it or carries it out in the session you have open: it can fetch and prepare a structure, add ligands, place the binding site, run a validation or a docking job, read the results, restyle the 3D view, search public research databases and write a report. Whatever it does, it does in front of you, in the same Docking Panel, viewer and result panels you would have used yourself.

The main window with the Co-Scientist panel open on the right
The Co-Scientist occupies a full height column at the right hand edge of the window, beside the Project and Structure panels. The rest of the window is unchanged and stays fully usable while the panel is open.

What it is, and what it is not

It is It is not
An artificial intelligence assistant. When you use it you are talking to an AI system, not to a person.A source of authority. Its answers can be incomplete, out of date or wrong, including chemistry, numbers and literature citations.
A second pair of hands on the application. It works through the same operations the menus and the Docking Panel offer, so everything it sets up is an ordinary receptor, ligand list, box or run that you can inspect and change.A separate engine. It has no docking method of its own, and a run it starts is the same run you would have started from step 5.
Optional. Every other part of the application works exactly as before whether or not you ever open the panel.A replacement for your judgement. You remain responsible for your scientific conclusions and for anything you publish.
Limited to its subject: drug discovery, structural biology, medicinal chemistry, bioinformatics and the use of this application.A general purpose chat program. It declines unrelated requests in a sentence.

What you need

Requirement Why
An activated licence that includes the Co-ScientistThe Co-Scientist signs in with the licence already on this computer. There is no separate account, password or key to enter. See Licence and activation.
An internet connectionThe assistant runs on the GeinDock AI service, not on your computer, and its look-ups reach public databases. This is the only part of the application that needs a connection while you work: everything else in GeinDock Suite works offline.
Acceptance of its terms of useAsked once, the first time you open the panel, and again only if the terms change.

Opening the panel

The toolbar carries a Co-Scientist button, placed just before the screenshot command. It shows the panel when it is hidden and hides it when it is showing. View › Panels › Co-Scientist does the same thing from the menu bar.

The Co-Scientist button on the main toolbar
The Co-Scientist button on the toolbar. One click brings the panel back when it has been closed.

The panel is a dockable panel like the others. Drag it by its title bar to the left or the right edge of the window, drag it out to float it, or close it. To make it wider, drag the edge that faces the 3D viewer. View › Panels › Reset Panel Layout returns it to the right hand edge at its default width.

First use: the terms of use

The first time the panel is shown, a start screen card headed Before you start appears and the terms of use open in their own window. Nothing can be sent until you have accepted them.

The Co-Scientist terms of use dialog
The terms of use, reopened here from the More menu, which is why the title reads (accepted). The acceptance box stays unavailable until you have scrolled to the end of the text, and Accept and continue stays unavailable until the box is ticked.
  1. Read to the end. The line Scroll to the end of the terms to continue stays under the text until you have reached the last section.
  2. Tick the box. I have read and accept these terms becomes available once the end has been reached.
  3. Choose. Accept and continue records your acceptance and puts the cursor in the message box. Decline closes the window and leaves the Co-Scientist unavailable, with everything else in the application working as usual.

The terms are short and worth reading properly, because they say what leaves your computer when you use the assistant. The same points are summarised in Conversations, allowance and privacy.

You can change your mind in either direction. If you declined, press Read the terms on the start screen to see them again and accept. If you accepted, More › Terms of use shows the text you agreed to at any time. When the terms are revised, the window opens again, says which version you accepted before, and asks you to accept the current one before you carry on.

The start screen

A new conversation opens on a start screen headed What shall we investigate?, with eight cards under Ideas to get started. Each card is a complete request. Clicking one sends it, which is the quickest way to see how the assistant works before you write a request of your own.

The Co-Scientist start screen with its suggestion cards
The start screen. Each card sends a ready made request. The chips under the message box show what the session already holds, here a receptor, 1HSG, and a binding site.
Card What it asks for
Prepare a targetFetch a known protease structure, prepare it as the receptor and define the binding site around its co-crystallised ligand.
Validate the binding siteRun a re-docking validation of the current binding site and say whether it passes.
Dock known inhibitorsFind potent inhibitors of a kinase in a bioactivity database, choose a suitable structure, prepare it and dock the top three.
Characterise a binding siteDescribe the pocket of the loaded structure: the residues that line it, the contacts its ligand makes, and what that suggests for design.
Review the literatureSummarise recent papers on inhibitors of a target, with citations.
Explain my resultsRank the docked ligands, explain the key interactions of the best poses and suggest next steps.
Make a figureSet up a publication view of the best pose and take a screenshot.
Write a reportWrite a PDF report of the docking study in this session.

The cards that work on results or on a loaded structure need something to work on. On an empty session, start with Prepare a target or Review the literature.

A tour of the panel

The header of the Co-Scientist panel
The header. Reading from the left: the name of the panel with the title of the current conversation beneath it, the status, the allowance meter, and the four buttons.
Part What it shows or does
TitleCo-Scientist, or GeinDock Co-Scientist in full when the panel is wide enough, with the title of the current conversation on the line beneath. A conversation is titled New conversation until you send its first message, and is then named after that message. Hover over the conversation title to see which model tier is in use, which is worth quoting when you report a problem.
StatusOne or two words on what the assistant is doing: Ready, Connecting, Working or the step in hand such as Thinking, Writing, Writing a question, Updating the plan or Next: followed by the operation about to start, Needs approval, Needs your answer, or one of the connection states listed further down this page. Hover over a connection state to read the full message. Reconnecting (attempt 2), with the number rising, means a request did not get through and is being sent again. Nothing is needed from you: up to four attempts are made before the problem is reported in the conversation.
Allowance meterHow much of this licence's allowance has been used, for example 12.4k / 250k, or Unlimited. Hover over it for the detail. It appears once the service has reported the allowance. See Conversations, allowance and privacy.
ReconnectContacts the service again, which is the button to press after a connection problem.
New conversationThe plus sign. Starts an empty conversation. The previous one is kept and can be reopened.
ConversationsOpens the list of saved conversations. Pressing it again returns to the conversation you were in.
MoreA menu holding the commands that are needed less often.

The More menu

The More menu of the Co-Scientist panel
The More menu. The tick beside Ask before long or destructive operations shows that the approval step is switched on, which is the default.
Command What it does
Export conversationWrites the current conversation to a file, in Markdown, for your notes or for a colleague.
Rename conversationGives the current conversation a title of your own, so it is easier to find later.
Ask before long or destructive operationsA switch. While it is ticked the assistant asks before starting a run that takes minutes or an operation that replaces your current work. See Working with the Co-Scientist.
Check connectionContacts the service again, the same as the reconnect button in the header.
Terms of useShows the terms. Once accepted, this is a way of reading them back and asks nothing.
Open conversations folderOpens the folder on this computer where conversations are saved.
About the Co-ScientistWhat the assistant is, the state of its connection, and a reminder about checking results.

The conversation

The middle of the panel is the conversation itself, oldest at the top. Your messages, the assistant's answers, the record of each operation it carried out, and any plan, question or request for approval all appear here in the order they happened. When you scroll back to read something earlier, a Latest button appears at the bottom of the conversation and returns you to the newest message.

The message box

Part What it does
The text boxWhere you type. It grows as you write, up to eight lines. Press Enter to send and Shift+Enter to start a new line. With the box empty, Up brings back your earlier messages one at a time.
The prompt in the empty boxGrey text that says what is expected of you at that moment, so read it when you are unsure why nothing is happening. Normally it reads Ask the Co-Scientist to fetch, prepare, dock or analyse.... It changes to Choose Run or Don't run above, or type what to do instead while an approval is waiting, to Choose an option above, or type your answer while a question is waiting, and to The job runs in the background. Type to ask something meanwhile... during a docking run or a validation.
The attach buttonThe paperclip, Attach files (structures, ligands, logs). Opens the Attach files dialog to choose files for the assistant to work with. You can also drag files from a file manager onto the box. Each attached file appears as a chip above the text, with a cross to remove it. A message can consist of attachments alone. The file itself is not uploaded with the message: the assistant is told where the file is, and then opens or reads it in the session as it would any other file, so attach a file when you want it loaded or read without typing its location.
The session chipsSmall labels between the attach button and the send button that summarise the session the assistant will act on: the receptor and whether it is prepared, the number of ligands, Site set or Site validated, and Docking... or Validating... while a job runs. Hover over one for the detail. In a narrow panel the ones that do not fit are left out.
The send buttonThe round button, Send (Enter). Sends the message. While the assistant is working it becomes a stop button, Stop (Esc), and Esc does the same.

The footer

The line under the message box reads The Co-Scientist can make mistakes. Check important results. It is there permanently because it is permanently true. Hovering over it shows how many tokens the current conversation has used.

Connection states

When the assistant cannot be used, the status in the header says why in a word or two, and the start screen shows a card with the full message and a button for the usual remedy. If the problem arises in the middle of a conversation, the message appears in the conversation instead, with a Retry button or a button for the remedy where there is one.

Status in the header What it means What to do
OfflineThe service did not answer at all. Either this computer has no internet connection or the service cannot be reached from it. The card reads You're offline.Check the connection, then press Try again. The rest of the application is unaffected.
Activate licenceThere is no activated licence on this computer for the Co-Scientist to sign in with.Press Licence information, which opens Help › Licence Information, and activate. See Licence and activation.
Licence inactiveThe licence was found but cannot use the Co-Scientist, for example because its period has ended or because it does not include the assistant. The card reads The Co-Scientist is not available for this licence and gives the reason.Press Licence information to see the state of the licence. Renew it, or contact Geinforce if you believe the licence should include the assistant.
Allowance usedThis licence's allowance for the current period has been used up, and the service is refusing further requests. The allowance meter turns red.Wait for the reset date shown when you hover over the meter, then press Check again. Nothing already in the session is affected.
Update requiredThis version of GeinDock Suite is older than the service now accepts.Press Check for updates and install the newer version. The application also offers the update check by itself when it meets this state.
UnavailableThe service answered, but cannot serve requests at the moment. This includes the case where Geinforce has switched the assistant off for a time, when the message box is disabled and the footer carries the explanation.Wait a few minutes and press Try again.
Connection problemThe service was reached but the connection could not be completed. The card reads The Co-Scientist could not connect and gives the reason.Press Try again. If it persists, restart the application, and report the message shown if that does not clear it.
Terms not acceptedThe terms of use have not been accepted, or have changed since you accepted them. The message box is disabled.Press Read the terms, read them and accept.
The reconnect button is always safe to press. It asks the service for its current state and changes nothing else. Use it whenever the status looks out of date, for instance after the network has come back.

Where to go next

Working with the Co-Scientist covers what happens once you send a request: how its work is shown, when it asks before acting, and what it can do. Conversations, allowance and privacy covers saved conversations, the allowance, and what is sent to the service.