@promptbook/components 0.103.0-3 → 0.103.0-4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -213,7 +213,6 @@ The main challenge is to narrow it down, constrain it, set the proper **context,
213
213
  Promptbook takes the best from both worlds. You are defining your AI behavior by simple **books**, which are very explicit. They are automatically enforced, but they are very easy to understand, very easy to write, and very reliable and portable.
214
214
 
215
215
 
216
-
217
216
  <img
218
217
  alt="Paul Smith & Associés Book"
219
218
  src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.&width=800&height=450&nonce=0"
@@ -232,7 +231,6 @@ You can look at it as prompting (or writing a system message), but decorated by
232
231
  Personas define the character of your AI persona, its role, and how it should interact with users. It sets the tone and style of communication.
233
232
 
234
233
 
235
-
236
234
  <img
237
235
  alt="Paul Smith & Associés Book"
238
236
  src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.&width=800&height=450&nonce=0"
@@ -247,7 +245,6 @@ This can include domain-specific knowledge, company policies, or any other relev
247
245
  Promptbook Engine will automatically enforce this knowledge during interactions. When the knowledge is short enough, it will be included in the prompt. When it is too long, it will be stored in vector databases and RAG retrieved when needed. But you don't need to care about it.
248
246
 
249
247
 
250
-
251
248
  <img
252
249
  alt="Paul Smith & Associés Book"
253
250
  src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%20https%3A%2F%2Fcompany.com%2Fcompany-policies.pdf%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fcompany.com%2Finternal-documents%2Femployee-handbook.docx&width=800&height=450&nonce=0"
@@ -260,7 +257,6 @@ Rules will enforce specific behaviors or constraints on the AI's responses. This
260
257
  Depending on rule strictness, Promptbook will either propagate it to the prompt or use other techniques, like adversary agent, to enforce it.
261
258
 
262
259
 
263
-
264
260
  <img
265
261
  alt="Paul Smith & Associés Book"
266
262
  src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.%0A%20%20%20%20%20%20%7C%20RULE%20Always%20ensure%20compliance%20with%20laws%20and%20regulations.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20outside%20your%20area%20of%20expertise.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20about%20criminal%20law.%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%20https%3A%2F%2Fcompany.com%2Fcompany-policies.pdf%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fcompany.com%2Finternal-documents%2Femployee-handbook.docx&width=800&height=450&nonce=0"
@@ -271,7 +267,6 @@ Depending on rule strictness, Promptbook will either propagate it to the prompt
271
267
  Action Commitment allows you to define specific actions that the AI can take during interactions. This can include things like posting on a social media platform, sending emails, creating calendar events, or interacting with your internal systems.
272
268
 
273
269
 
274
-
275
270
  <img
276
271
  alt="Paul Smith & Associés Book"
277
272
  src="https://promptbook.studio/embed/book-preview.png?book=Paul%20Smith%20%26%20Associ%C3%A9s%0A%20%20%20%20%20%20%7C%20PERSONA%20You%20are%20a%20company%20lawyer.%0A%20%20%20%20%20%20%7C%20Your%20job%20is%20to%20provide%20legal%20advice%20and%20support%20to%20the%20company%20and%20its%20employees.%0A%20%20%20%20%20%20%7C%20You%20are%20knowledgeable%2C%20professional%2C%20and%20detail-oriented.%0A%20%20%20%20%20%20%7C%20RULE%20Always%20ensure%20compliance%20with%20laws%20and%20regulations.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20outside%20your%20area%20of%20expertise.%0A%20%20%20%20%20%20%7C%20RULE%20Never%20provide%20legal%20advice%20about%20criminal%20law.%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%20https%3A%2F%2Fcompany.com%2Fcompany-policies.pdf%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fcompany.com%2Finternal-documents%2Femployee-handbook.docx%0A%20%20%20%20%20%20%7C%20ACTION%20When%20a%20user%20asks%20about%20an%20issue%20that%20could%20be%20treated%20as%20a%20crime%2C%20notify%20legal%40company.com.&width=800&height=450&nonce=0"
@@ -322,10 +317,14 @@ Now you want to use it. There are several ways how to write your first book:
322
317
 
323
318
  We have written ai asistant in book who can help you with writing your first book.
324
319
 
320
+
321
+
325
322
  #### Your AI twin
326
323
 
327
324
  Copy your own behavior, personality, and knowledge into book and create your AI twin. It can help you with your work, personal life, or any other task.
328
325
 
326
+
327
+
329
328
  #### AI persona workpool
330
329
 
331
330
  Or you can pick from our library of pre-written books for various roles and tasks. You can find books for customer support, coding, marketing, sales, HR, legal, and many other roles.
@@ -443,209 +442,7 @@ Join our growing community of developers and users:
443
442
 
444
443
 
445
444
 
446
- ## 📘 Book Language Blueprint
447
-
448
- <blockquote style="color:#FFE600">
449
- ⚠ This file is a work in progress and may be incomplete or inaccurate.
450
- </blockquote>
451
-
452
- ---
453
-
454
- Book is a simple format do define AI apps and agents. It is the source code the soul of AI apps and agents.. It's purpose is to avoid ambiguous UIs with multiple fields and low-level ways like programming in langchain.
455
-
456
- Book is defined in file with `.book` extension
457
-
458
- ### Examples
459
-
460
-
461
-
462
- <img
463
- alt="Write an article about {topic} Book"
464
- src="https://promptbook.studio/embed/book-preview.png?book=Write%20an%20article%20about%20%7Btopic%7D%0A%20%20%20%20%20%20%7C%20PERSONA%20Jane%2C%20marketing%20specialist%20with%20prior%20experience%20in%20tech%20and%20AI%20writing%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20https%3A%2F%2Fwikipedia.org%2F%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20.%2Fjournalist-ethics.pdf%0A%20%20%20%20%20%20%7C%20EXPECT%201%20Sentence%20-%205%20Pages%0A%20%20%20%20%20%20%7C%20RESULT%20%7Barticle%7D&width=800&height=450&nonce=0"
465
- />
466
-
467
- ---
468
-
469
-
470
-
471
- <img
472
- alt="Make post on LinkedIn based on @Input. Book"
473
- src="https://promptbook.studio/embed/book-preview.png?book=Make%20post%20on%20LinkedIn%20based%20on%20%40Input.%0A%20%20%20%20%20%20%7C%20PERSONA%20%40Jane%2C%20an%20experienced%20copywriter%20and%20HR%20expert%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20cetin.cz%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20linkedin.com%2Fcompany%2Fcetin%2F&width=800&height=450&nonce=0"
474
- />
475
-
476
- ---
477
-
478
-
479
-
480
- <img
481
- alt="Odpověz na Email Book"
482
- src="https://promptbook.studio/embed/book-preview.png?book=Odpov%C4%9Bz%20na%20Email%0A%20%20%20%20%20%20%7C%20%7BEmail%20content%7D%0A%20%20%20%20%20%20%7C%20PERSONA%20%40Pavol%20-%20pavolhejny.com%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20.%2Finstructions.pdf%0A%20%20%20%20%20%20%7C%20STYLE%20Professional%20tone%20of%20voice&width=800&height=450&nonce=0"
483
- />
484
-
485
- ---
486
-
487
-
488
-
489
- <img
490
- alt="Analyzuj {Případ}. Book"
491
- src="https://promptbook.studio/embed/book-preview.png?book=Analyzuj%20%7BP%C5%99%C3%ADpad%7D.%0A%20%20%20%20%20%20%7C%20%7BDetaily%7D%0A%20%20%20%20%20%20%7C%20PERSONA%20%40Ji%C5%99%C3%AD%2C%20pr%C3%A1vn%C3%ADk%2C%20kter%C3%BD%20nikdy%20neode%C5%A1le%20informace%20o%20klientech%20mimo%20EU%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20%7B89%2F2012%20Sb.%20Ob%C4%8Dansk%C3%BD%20z%C3%A1kon%C3%ADk%7D&width=800&height=450&nonce=0"
492
- />
493
-
494
- iframe:
495
-
496
- <iframe frameborder="0" style="width:100%;height:455px;" src="https://viewer.diagrams.net/?tags=%7B%7D&lightbox=1&highlight=0000ff&edit=_blank&layers=1&nav=1&title=#R%3Cmxfile%20scale%3D%221%22%20border%3D%220%22%20disableSvgWarning%3D%22true%22%20linkTarget%3D%22_blank%22%3E%3Cdiagram%20name%3D%22Page-1%22%20id%3D%22zo4WBBcyATChdUDADUly%22%3E7ZxtU%2BM2EMc%2FjWfaF2b8kMTwEkKOu%2Fa468BM77ViK4mKLLmy8nSfvitbihPiNEAaIHTfYHm1luzVT7vG%2F5l4cT9f3ChSTG5lRrkXBdnCi6%2B9KAo7YQ8OxrK0liBKastYsczaGsM9%2B0mdo7VOWUbLDUctJdes2DSmUgia6g0bUUrON91Gkm%2FOWpCxnTFoDPcp4XTL7QfL9KS2nnfXvD9TNp64mcPA9uTEOVtDOSGZnK%2BZ4oEX95WUum7liz7lJnouLvV1n3b0rm5MUaGfcoFdiRnhU%2Ftsf1KlGTwqWPtSaMIEVfZe9dIFoJyznBMBZ1fzCdP0viCp6ZrDgoNtonMOZyE07fgwKF3svMdw9eTADJU51WoJLvYCP7qw0bK8JPZ03sQ%2B7lnbZC3ukQs7ses9Xo3dhAQaNirtEbrYipAX9TjMcFUWRDSOvb%2BnZtGuMpmWPhOaKkG4b0j1R2EcdbNO6iej0cgfhufQGiaJnw7PaXIRJT2adpsBoDW2x2qaYiP0zovDuvjuYS%2FDs%2FgcjDlRYyZ8LQtjiwrd2IZSa5k35vX5goypzcG12n0%2F9rG3b2kEuPhltVkvwWE1UVB1jEjO%2BLLugmtIbkCxV95JuD0JHbdSyMedXtQ3Owd6ypqyq2pnc6nqwdR4%2BEtQO7nDr7XTkKQPYyWnIvPX%2FLUionT0rW5vRhQjcBTTnCqW1q5Cqhx2wrYXJaX2SQntPY6EVyBok63%2B1bGQJdNM7huP5vIvtu0zs5sW5mNjO8aQlNRQUntU29SvImiCwUlR2nUqFC2pmtFHUNSLfkseqPGRpYaDNAv%2FlYkHmn0RdorM2R0fsKFqRN4%2FNhe1Uxh060YUJi9AZ%2B52IRgSYBCh2gOV1wm%2BiGKqT5AYTDRHYuJsDwxgLl5WGTtRGHW3imOntTgGH7A2ht34YGgxxT0T5z8Gd%2Fffv11iWURmnlMWfzP%2FU50eMFgVj4VEFdBqwemigMhQkVZv3KkslnMFY6qq35g%2B3zmvfS9WB9TSoLddSwMspZgWj7cHfv%2F2%2FcfXwfXN4DSLKebGI3GRUs3EWfoTkx0muw8D9TGSXYjJ7uS54NVHV5PvIN9En%2BAvrP7StEwWNGLG87NgxmbI1P%2BYKbfoQ9VCyw6IWpjZcn6kFWq6MPY1TdA%2ByDWnI9PjHvDSmnOWZXyXtFgtOTWSW7CabI%2B62GtXF62Y2HmimBg64yFiohOw37XeGjod20bIf2qI%2FhO9NQxRcH3%2FL4eYlFFwxS%2FLpwIVCq7IBAqur4Usfjh5A5xRcEVmUHDFqoiCK5ZSTIsH7QEUXJGLNi5QcMVk9%2BGgRsEVuWjjAgVXZAoFV%2B9FgmsYtOuLb6K4RieouK504tdRXGNUXN%2F%2F2yFmZVRc8dPyqUCFiisygYrrayGLX07eAGdUXJEZVFyxKqLiiqUU0%2BJBewAVV%2BSijQtUXDHZfTioUXFFLtq4QMUVmULF1XuZ4hq9meIKp83PFVd9N82vPseDfwA%3D%3C%2Fdiagram%3E%3C%2Fmxfile%3E"></iframe>
497
-
498
- books.svg
499
-
500
- ![Books](./books/diagram/books.svg)
501
-
502
- books.png
503
-
504
- ![Books](./books/diagram/books.png)
505
-
506
- ### Basic Commitments:
507
-
508
- Book is composed of commitments, which are the building blocks of the book. Each commitment defines a specific task or action to be performed by the AI agent. The commitments are defined in a structured format, allowing for easy parsing and execution.
509
-
510
- #### `PERSONA`
511
-
512
- defines basic contour of
513
-
514
- > PERSONA @Joe Average man with
515
-
516
- also the PERSONA is
517
-
518
- Describes
519
-
520
- #### `RULE` or `RULES`
521
-
522
- defines
523
-
524
- #### `STYLE`
525
-
526
- xxx
527
445
 
528
- #### `SAMPLE`
529
-
530
- xxx
531
-
532
- #### `KNOWLEDGE`
533
-
534
- xxx
535
-
536
- #### `EXPECT`
537
-
538
- xxx
539
-
540
- #### `FORMAT`
541
-
542
- xxx
543
-
544
- #### `JOKER`
545
-
546
- xxx
547
-
548
- #### `MODEL`
549
-
550
- xxx
551
-
552
- #### `ACTION`
553
-
554
- xxx
555
-
556
- #### `META`
557
-
558
- ### Names
559
-
560
- each commitment is
561
-
562
- `PERSONA`
563
-
564
- Variable names
565
-
566
- ### Types
567
-
568
- ### Miscellaneous aspects of Book language
569
-
570
- #### Named vs Anonymous commitments
571
-
572
- #### Single line vs multiline
573
-
574
- #### Bookish vs Non-bookish definitions
575
-
576
- ---
577
-
578
- ## **\_\_\_\_**
579
-
580
- Great context and prompt can make or break you AI app. In last few years we have came from simple one-shot prompts. When you want to add conplexity you have finetunned the model or add better orchestration. But with really large large language models the context seems to be a king.
581
-
582
- The Book is the language to describe and define your AI app. Its like a shem for a Golem, book is the shem and model is the golem.
583
-
584
-
585
-
586
- <img
587
- alt="Franz Kafka Book"
588
- src="https://promptbook.studio/embed/book-preview.png?book=Franz%20Kafka%0A%20%20%20%20%20%20%7C%20PERSONA%20Franz%20Kafka%2C%20a%20writer%20who%20is%20interested%20in%20the%20human%20condition%20and%20the%20absurdity%20of%20life%2C%20speaks%20German%20and%20Czech%20and%20English%0A%20%20%20%20%20%20%7C%20STYLE%20%7Bkafka.com%2Fthe-castle%7D%0A%20%20%20%20%20%20%7C%20STYLE%20%7Bkafka.com%2Fthe-trial.pdf%7D%0A%20%20%20%20%20%20%7C%20STYLE%20%7Bkafka.com%2Fmetamorphosis.docx%7D%0A%20%20%20%20%20%20%7C%20KNOWLEDGE%20Franz%20Kafka%20has%20a%20deep%20understanding%20of%20existentialism%2C%20surrealism%2C%20and%20the%20human%20psyche%0A%20%20%20%20%20%20%7C%20GOAL%20Write%20a%20short%20story%20that%20explores%20the%20themes%20of%20alienation%2C%20bureaucracy%2C%20and%20the%20absurd%0A%20%20%20%20%20%20%7C%20ACTION%20%7Bmcp&width=800&height=450&nonce=0"
589
- />
590
-
591
- ## Who, what and how?
592
-
593
- To write a good prompt and the book you will be answering 3 main questions
594
-
595
- - **Who** is working on the task, is it a team or an individual? What is the role of the person in the team? What is the background of the person? What is the motivation of the person to work on this task?
596
- You rather want `Paul, an typescript developer who prefers SOLID code` not `gemini-2`
597
- - **What**
598
- - **How**
599
-
600
- each commitment (described bellow) is connected with one of theese 3 questions.
601
-
602
- ### Commitments
603
-
604
- Commitment is one piece of book, you can imagine it as one paragraph of book.
605
-
606
- Each commitment starts in a new line with commitment name, its usually in UPPERCASE and follows a contents of that commitment. Contents of the commithemt is defined in natural language.
607
-
608
- Commitments are chained one after another, in general commitments which are written later are more important and redefines things defined earlier.
609
-
610
- Each commitment falls into one or more of cathegory who, what or how
611
-
612
- Here are some basic commintemts:
613
-
614
- - `PERSONA` tells **who** is working on the task
615
- - `KNOWLEDGE` describes **what** knowledge the person has
616
- - `GOAL` describes **what** is the goal of the task
617
- - `ACTION` describes **what** actions can be done
618
- - `RULE` describes **what** rules should be followed
619
- - `STYLE` describes **how** the output should be presented
620
-
621
- ### Variables and references
622
-
623
- When the prompt should be to be useful it should have some fixed static part and some variable dynamic part
624
-
625
-
626
-
627
- <img
628
- alt="Untitled Book"
629
- src="https://promptbook.studio/embed/book-preview.png?book=&width=800&height=450&nonce=0"
630
- />
631
-
632
- ### Imports
633
-
634
- ### Layering
635
-
636
- ### Book defined in book
637
-
638
- ###
639
-
640
- Book vs:
641
-
642
- - Why just dont pick the right model
643
- - Orchestration frameworks - Langchain, Google Agent ..., Semantic Kernel,...
644
- - Finetunning
645
- - Temperature, top_t, top_k,... etc.
646
- - System message
647
- - MCP server
648
- - function calling
649
446
 
650
447
 
651
448
 
@@ -725,6 +522,8 @@ The following glossary is used to clarify certain concepts:
725
522
 
726
523
  _Note: This section is not a complete dictionary, more list of general AI / LLM terms that has connection with Promptbook_
727
524
 
525
+
526
+
728
527
  ### 💯 Core concepts
729
528
 
730
529
  - [📚 Collection of pipelines](https://github.com/webgptorg/promptbook/discussions/65)