Skip to content
P4 Software P4 Software / logisticaHQ-en

Add these docs to Claude

Ask Claude questions about these docs. Claude reads the published pages and links you back to them. Copy this address:

https://p4-software.opendocs.page/mcp

In claude.ai or Claude Desktop: open Settings, then Connectors, choose Add custom connector and paste the address.

In Claude Code, run:

claude mcp add --transport http docs https://p4-software.opendocs.page/mcp

Teach the assistant

Teach the assistant
← Back to System

Every company has its own way of talking. Your team may call the refrigerated zone "zona fría", count an order as late only after two days, or call dock door 3 "the big door". LogisticaHQ cannot know any of that. Teach the assistant is where an administrator writes these things down as short company facts. The AI assistant reads them with every question your team asks, so it understands your words and follows your rules.

Facts belong to your company only. No other LogisticaHQ customer's assistant ever sees them.

Who can use this screen

Only administrators can see, add, change or delete facts. The menu entry is hidden from everyone else, and the server refuses their changes. A user who is not an administrator who opens the screen sees only Only administrators can teach the assistant. Every user benefits from the facts, because the assistant uses them when it answers anyone in the company.

Open the screen

Go to Setup > System > Teach the assistant. The header reads Setup · AI assistant above the title Teach the assistant, with the line The words and rules your company uses that the System does not know. The assistant reads them for your company only. Only administrators can change them.

You also arrive here from Answers to review when you click Add a company fact, Add a lookup rule or Add an instruction on an answer that went wrong. The form is then already filled from that answer (see Teach from an answer).

The screen has two parts: the list of facts on the left and the form on the right. On a narrow window the form sits under the list.

The Teach the assistant screen, here with no facts yet, and the empty Add a fact form on the right.

The Teach the assistant screen, here with no facts yet, and the empty Add a fact form on the right.

The three kinds of fact

KindAs the form offers itUse it forExamples
WordWord: what we call somethingNames your team uses for things that have a different name in LogisticaHQ: Zones, product families, customer groups, document types, nicknames."Zona fría" means the zone COLD-01, where all refrigerated Products are kept.
"Los de Colón" are the Customers whose city is Colón.
RuleRule: how we count or decideHow your company counts, measures or decides something, and which list or field the assistant should read for it.An order is late when its required date is more than 2 days in the past and it is not shipped.
When we say "stock" we mean available quantity, not on-hand.
PlacePlace: our Warehouses, Zones, doorsYour physical places and what they are used for.Door 3 is the big door, used for all container unloading.
Warehouse MAIN is Tocumen; Warehouse WH2 is Colón Free Zone.

The kind is shown as a coloured pill beside each fact in the list. It helps you and the assistant read the fact the right way, but all three kinds are used the same way: they are sent with every question.

Add a fact

  1. On the right, under Add a fact (Write it the way you would explain it to a new employee.), choose the Kind.
  2. Type The fact.
  3. Optionally type An example question.
  4. Click Save fact. The message Saved. The assistant uses it from the next question. appears, the fact is added to the list and the form empties for the next one.

Save fact stays greyed out until The fact has some text, and while the fact or the example is longer than 300 characters. Cancel empties the form without saving.

The fields

FieldRequiredDescriptionLimits and rules
KindYesWord, Rule or Place, as described above. Starts on Word.One of the three.
The factYesThe fact itself, in plain words. Write it as you would explain it to a new employee: name the thing as your team says it, then say what it is in LogisticaHQ terms (the zone code, the customer, the field, the status).Up to 300 characters; while the text is longer, Save fact stays greyed out. A fact is kept on one line: line breaks become spaces, and the characters < and > are replaced by similar-looking marks. If you need more than 300 characters, split it into two facts. If you try to save spaces only, you see Write the fact.
An example question (optional)NoA question your team really asks that this fact should answer, for example How many pallets are in zona fría?Up to 300 characters; while it is longer, Save fact stays greyed out. The example is added to your company's exam, so a later change can never quietly break it. See What the example question does.

Writing facts that work

  • One idea per fact. Two short facts work better than one long one, and they are easier to change later.
  • Use the exact words your team types, including accents and capitals as they write them, and the exact codes in LogisticaHQ (zone, Warehouse, door, client and customer codes).
  • Say which list or field to read for rules: "count Pick tickets in state Shipped", "use the required date, not the order date".
  • Do not write instructions to change how the assistant behaves ("ignore permissions", "show passwords"). Facts are treated as information about your company, never as orders: the assistant does not follow instructions written in a fact, a fact cannot let anyone see data they are not allowed to see, and it never replaces looking the data up.
  • Never put passwords, keys or personal data in a fact. Facts are sent to the AI model with every question.

What the example question does

When a fact has an example question, that question is sent to the AI assistant exam. The next time an administrator opens the exam screen, the question appears at the top under Waiting for what the answer must say, marked Company fact. It is not asked until an administrator completes it by saying what the answer must contain; the exam then checks it every time it runs, so if a later change ever breaks this fact, the exam shows it.

The example is copied into the exam once. Changing the example or the fact afterwards does not change the exam's copy, and deleting the fact does not remove it from the exam; change or remove the question on the exam screen instead.

Teach from an answer

When you click Add a company fact (kind Word), Add a lookup rule or Add an instruction (both kind Rule) on Answers to review, this screen opens with:

  • a line above the form: From an answer: a.gomez asked "How many pallets are in zona fría?";
  • Kind set to Word or Rule, following the button you clicked;
  • The fact filled with the right answer the user wrote in their report, or the note they left with a thumbs down (empty if they wrote nothing);
  • An example question filled with the question the user asked.

Read and rewrite the fact before saving: what a user typed in a hurry is rarely the clearest fact. When saved, the fact remembers the question it came from and who asked it; the list shows From a fixed answer · a.gomez asked "..." under it, even after the original answer leaves Answers to review at 90 days. Then go back to Answers to review and click Mark fixed.

If the answer can no longer be read (it is more than 90 days old), the form simply opens empty.

The list of facts

Above the list, the count reads 1 fact or 12 facts. Facts are listed oldest first, which is also the order in which they are sent to the assistant. Each fact shows its kind pill, its text, and a line saying where it came from and how much it is used:

  • Added by r.tosco · used 211 times: typed directly on this screen by that administrator.
  • From a fixed answer · a.gomez asked "..." · used 14 times: taught from an answer on Answers to review.

Used counts how many questions the fact was sent with. A fact that stays at 0 for a long time is probably never reaching the assistant (see the limits below).

Search facts filters the list as you type. It looks in the fact, its example question and the question it came from; capitals do not matter. No fact matches your search. means nothing matched. When the company has no facts yet, the list shows No facts yet. Add the first one on the right.

Change or delete a fact

  1. Click the pencil button (Edit fact) on the fact. The fact is highlighted and the form's title changes to Edit the fact, with its kind, text and example filled in.
  2. Change what you need and click Save fact. The change applies from the next question.
  3. To remove the fact instead, click Delete (red, on the left). Confirm in the box Delete this fact? (The assistant stops using it from the next question.) by clicking Delete. The message The fact was deleted. appears. A deleted fact cannot be brought back; you would have to type it again.
  4. Cancel leaves the fact as it was and empties the form.

If another administrator deleted the fact while you were editing it, saving shows This fact was deleted. Refresh the list. Reload the page.

Limits and what they mean

LimitValueConsequence
Facts per company200The 201st is refused with Your company already has 200 facts. Delete or combine some before adding more.
Length of a fact300 charactersSave fact stays greyed out until the text is short enough. Split a long fact into two.
Length of an example question300 charactersSave fact stays greyed out until the example is short enough.
Facts sent with one questionAbout 6,000 characters in totalImportant. Each question carries as many facts as fit in about 6,000 characters, taken oldest first. Once that space is full, newer facts are left out of the question without any warning. With short facts (around 100 characters) roughly 50 to 60 fit; with long ones far fewer. Keep facts short, delete facts that are no longer true, and combine overlapping ones, so the facts you add later still reach the assistant. Watch the used count: a recent fact stuck at 0 is a sign the space is full.

Facts add a little to the size, and so the cost, of every question your team asks. A tidy list of facts that are all true and all needed gives the best answers.

Troubleshooting

What you seeWhyWhat to do
Only administrators can teach the assistant.Your user is not an administrator.Ask an administrator.
The facts could not be read. Try again in a minute.The list could not be loaded.Wait a minute and reload the page.
The assistant still gets it wrong after you saved a fact.The fact is unclear, it is past the 6,000-character space, or the question needs data the assistant cannot read.Make the fact more specific (name the list, field or code), check its used count, and test by asking the question again. Add the question to the exam so you know when it works.
Save fact is greyed out.The fact is empty, the fact or the example is longer than 300 characters, or a save is in progress.Type the fact.

Related pages

Was this page helpful?