@agentica/core 0.15.7 → 0.16.1

package/src/orchestrate/select.ts

@@ -11,16 +11,16 @@ import type { AgenticaOperationSelection } from "../context/AgenticaOperationSel
 import type { __IChatFunctionReference } from "../context/internal/__IChatFunctionReference";
 import type { __IChatSelectFunctionsApplication } from "../context/internal/__IChatSelectFunctionsApplication";
 import type { AgenticaEvent } from "../events/AgenticaEvent";
-import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
-import type { AgenticaSelectPrompt } from "../prompts/AgenticaSelectPrompt";
-import type { AgenticaTextPrompt } from "../prompts/AgenticaTextPrompt";
+import type { AgenticaHistory } from "../histories/AgenticaHistory";
+import type { AgenticaSelectHistory } from "../histories/AgenticaSelectHistory";
+import type { AgenticaTextHistory } from "../histories/AgenticaTextHistory";
 
 import { AgenticaConstant } from "../constants/AgenticaConstant";
 import { AgenticaDefaultPrompt } from "../constants/AgenticaDefaultPrompt";
 import { AgenticaSystemPrompt } from "../constants/AgenticaSystemPrompt";
 import { createTextEvent } from "../factory/events";
+import { createSelectHistory, createTextHistory, decodeHistory } from "../factory/histories";
 import { createOperationSelection } from "../factory/operations";
-import { createSelectPrompt, createTextPrompt, decodePrompt } from "../factory/prompts";
 import { ChatGptCompletionMessageUtil } from "../utils/ChatGptCompletionMessageUtil";
 import { StreamUtil } from "../utils/StreamUtil";
 
@@ -37,7 +37,7 @@ interface IFailure {
   validation: IValidation.IFailure;
 }
 
-export async function select<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>): Promise<AgenticaPrompt<Model>[]> {
+export async function select<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>): Promise<AgenticaHistory<Model>[]> {
   if (ctx.operations.divided === undefined) {
     return step(ctx, ctx.operations.array, 0);
   }
@@ -45,7 +45,7 @@ export async function select<Model extends ILlmSchema.Model>(ctx: AgenticaContex
   const stacks: AgenticaOperationSelection<Model>[][]
       = ctx.operations.divided.map(() => []);
   const events: AgenticaEvent<Model>[] = [];
-  const prompts: AgenticaPrompt<Model>[][] = await Promise.all(
+  const prompts: AgenticaHistory<Model>[][] = await Promise.all(
     ctx.operations.divided.map(async (operations, i) =>
       step(
         {
@@ -82,7 +82,7 @@ export async function select<Model extends ILlmSchema.Model>(ctx: AgenticaContex
   }
 
   // RE-COLLECT SELECT FUNCTION EVENTS
-  const collection: AgenticaSelectPrompt<Model> = createSelectPrompt({
+  const collection: AgenticaSelectHistory<Model> = createSelectHistory({
     id: v4(),
     selections: [],
   });
@@ -98,7 +98,7 @@ export async function select<Model extends ILlmSchema.Model>(ctx: AgenticaContex
   return [collection];
 }
 
-async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>, operations: AgenticaOperation<Model>[], retry: number, failures?: IFailure[]): Promise<AgenticaPrompt<Model>[]> {
+async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>, operations: AgenticaOperation<Model>[], retry: number, failures?: IFailure[]): Promise<AgenticaHistory<Model>[]> {
   // ----
   // EXECUTE CHATGPT API
   // ----
@@ -141,7 +141,7 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
           ),
         },
         // PREVIOUS HISTORIES
-        ...ctx.histories.map(decodePrompt).flat(),
+        ...ctx.histories.map(decodeHistory).flat(),
         // USER INPUT
         {
           role: "user",
@@ -209,7 +209,7 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
   // ----
   // PROCESS COMPLETION
   // ----
-  const prompts: AgenticaPrompt<Model>[] = [];
+  const prompts: AgenticaHistory<Model>[] = [];
   for (const choice of completion.choices) {
     // TOOL CALLING HANDLER
     if (choice.message.tool_calls != null) {
@@ -227,8 +227,8 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
           continue;
         }
 
-        const collection: AgenticaSelectPrompt<Model>
-              = createSelectPrompt({
+        const collection: AgenticaSelectHistory<Model>
+              = createSelectHistory({
                 id: tc.id,
                 selections: [],
               });
@@ -259,7 +259,7 @@ async function step<Model extends ILlmSchema.Model>(ctx: AgenticaContext<Model>,
       choice.message.role === "assistant"
       && choice.message.content != null
     ) {
-      const text: AgenticaTextPrompt = createTextPrompt({
+      const text: AgenticaTextHistory = createTextHistory({
         role: "assistant",
         text: choice.message.content,
       });

package/src/structures/IAgenticaConfig.ts

@@ -1,21 +1,22 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
 import type { AgenticaContext } from "../context/AgenticaContext";
-import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+import type { AgenticaHistory } from "../histories/AgenticaHistory";
 
 import type { IAgenticaExecutor } from "./IAgenticaExecutor";
 import type { IAgenticaSystemPrompt } from "./IAgenticaSystemPrompt";
 
 /**
- * Configuration for Nestia Agent.
+ * Configuration for Agentic Agent.
  *
  * `IAgenticaConfig` is an interface that defines the configuration
  * properties of the {@link Agentica}. With this configuration, you
- * can set the user's locale, timezone, and some of system prompts.
+ * can set the user's {@link locale}, {@link timezone}, and some of
+ * {@link systemPrompt system prompts}.
  *
  * Also, you can affect to the LLM function selecing/calling logic by
  * configuring additional properties. For an example, if you configure the
- * {@link capacity} property, the A.I. chatbot will divide the functions
+ * {@link capacity} property, the AI chatbot will divide the functions
  * into the several groups with the configured capacity and select proper
  * functions to call by operating the multiple LLM function selecting
  * agents parallelly.
@@ -40,7 +41,7 @@ export interface IAgenticaConfig<Model extends ILlmSchema.Model> {
    */
   executor?:
     | Partial<IAgenticaExecutor<Model>>
-    | ((ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>);
+    | ((ctx: AgenticaContext<Model>) => Promise<AgenticaHistory<Model>[]>);
 
   /**
    * System prompt messages.

package/src/structures/IAgenticaController.ts

@@ -9,7 +9,7 @@ import type {
 } from "@samchon/openapi";
 
 /**
- * Controller of the Nestia Agent.
+ * Controller of the Agentica Agent.
  *
  * `IAgenticaController` is a type represents a controller of the
  * {@link Agentica}, which serves a set of functions to be called

package/src/structures/IAgenticaExecutor.ts

@@ -1,8 +1,9 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
 import type { AgenticaContext } from "../context/AgenticaContext";
-import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
-import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+import type { AgenticaOperation } from "../context/AgenticaOperation";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
+import type { AgenticaHistory } from "../histories/AgenticaHistory";
 
 /**
  * Executor of the Agentic AI.
@@ -23,8 +24,8 @@ import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
  * the executor logic, it can entirely break the {@link Agentica}'s
  * operation.
  *
- * @reference https://github.com/wrtnlabs/agentica?tab=readme-ov-file#principles
- * @reference https://github.com/wrtnlabs/agentica/blob/main/packages/agent/src/chatgpt/ChatGptAgent.ts
+ * @reference https://wrtnlabs.io/agentica/docs/concepts/function-calling/#orchestration-strategy
+ * @reference https://github.com/wrtnlabs/agentica/blob/main/packages/core/src/orchestrate/execute.ts
  * @author Samchon
  */
 export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
@@ -58,7 +59,7 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    */
   initialize:
     | null
-    | ((ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>);
+    | ((ctx: AgenticaContext<Model>) => Promise<AgenticaHistory<Model>[]>);
 
   /**
    * Function selector agent.
@@ -87,7 +88,7 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    * @param ctx Context of the agent
    * @returns List of prompts generated by the selector
    */
-  select: (ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>;
+  select: (ctx: AgenticaContext<Model>) => Promise<AgenticaHistory<Model>[]>;
 
   /**
    * Function caller agent.
@@ -108,13 +109,14 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    * calling to the user as markdown content.
    *
    * @param ctx Context of the agent
+   * @param operation Lit of candidate operations to call
    * @returns List of prompts generated by the caller
    * @warning Recommend not to customize, due to its validation
    *          feedback strategy is working very well, and the `call`
    *          agent is the most general topic which can be universally
    *          applied to all domain fields.
    */
-  call: (ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>;
+  call: (ctx: AgenticaContext<Model>, operations: AgenticaOperation<Model>[]) => Promise<AgenticaHistory<Model>[]>;
 
   /**
    * Describer agent of the function calling result.
@@ -128,8 +130,8 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    */
   describe: (
     ctx: AgenticaContext<Model>,
-    executes: AgenticaExecutePrompt<Model>[],
-  ) => Promise<AgenticaPrompt<Model>[]>;
+    executes: AgenticaExecuteHistory<Model>[],
+  ) => Promise<AgenticaHistory<Model>[]>;
 
   /**
    * Function canceler agent.
@@ -153,5 +155,5 @@ export interface IAgenticaExecutor<Model extends ILlmSchema.Model> {
    * @param ctx Context of the agent
    * @returns List of prompts generated by the canceler
    */
-  cancel: (ctx: AgenticaContext<Model>) => Promise<AgenticaPrompt<Model>[]>;
+  cancel: (ctx: AgenticaContext<Model>) => Promise<AgenticaHistory<Model>[]>;
 }

package/src/structures/IAgenticaProps.ts

@@ -1,13 +1,13 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
-import type { IAgenticaPromptJson } from "../json/IAgenticaPromptJson";
+import type { IAgenticaHistoryJson } from "../json/IAgenticaHistoryJson";
 
 import type { IAgenticaConfig } from "./IAgenticaConfig";
 import type { IAgenticaController } from "./IAgenticaController";
 import type { IAgenticaVendor } from "./IAgenticaVendor";
 
 /**
- * Properties of the Nestia Agent.
+ * Properties of the Agentica Agent.
  *
  * `IAgenticaProps` is an interface that defines the properties
  * of the {@link Agentica.constructor}. In the `IAgenticaProps`,
@@ -66,5 +66,5 @@ export interface IAgenticaProps<Model extends ILlmSchema.Model> {
    * If you're starting the conversation from an existing session,
    * assign the previouis prompt histories to this property.
    */
-  histories?: IAgenticaPromptJson[];
+  histories?: IAgenticaHistoryJson[];
 }

package/src/structures/IAgenticaSystemPrompt.ts

@@ -1,12 +1,12 @@
 import type { ILlmSchema } from "@samchon/openapi";
 
-import type { AgenticaExecutePrompt } from "../prompts/AgenticaExecutePrompt";
-import type { AgenticaPrompt } from "../prompts/AgenticaPrompt";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
+import type { AgenticaHistory } from "../histories/AgenticaHistory";
 
 import type { IAgenticaConfig } from "./IAgenticaConfig";
 
 /**
- * System prompt collection of the A.I. chatbot.
+ * System prompt collection of the Agentic AI.
  *
  * `IAgenticaSystemPrompt` is a type represents a collection of system
  * prompts that would be used by the A.I. chatbot of {@link Agentica}.
@@ -43,13 +43,13 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * In that case, the `initialize` system prompt would be used. You can
    * customize the `initialize` system prompt by assigning this function
-   * with the given {@link AgenticaPrompt histories} parameter.
+   * with the given {@link AgenticaHistory histories} parameter.
    *
    * @param histories Histories of the previous prompts
    * @returns initialize system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/initialize.md
    */
-  initialize?: (histories: AgenticaPrompt<Model>[]) => string;
+  initialize?: (histories: AgenticaHistory<Model>[]) => string;
 
   /**
    * Select system prompt.
@@ -60,7 +60,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * In that case, this `select` system prompt would be used. You can
    * customize it by assigning this function with the given
-   * {@link AgenticaPrompt histories} parameter.
+   * {@link AgenticaHistory histories} parameter.
    *
    * Note that, the `"select"` means only the function selection. It does
    * not contain the filling argument or executing the function. It
@@ -70,7 +70,7 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    * @returns select system promopt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/select.md
    */
-  select?: (histories: AgenticaPrompt<Model>[]) => string;
+  select?: (histories: AgenticaHistory<Model>[]) => string;
 
   /**
    * Cancel system prompt.
@@ -81,13 +81,13 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * In that case, this `cancel` system prompt would be used. You can
    * customize it by assigning this function with the given
-   * {@link AgenticaPrompt histories} parameter.
+   * {@link AgenticaHistory histories} parameter.
    *
    * @param histories Histories of the previous prompts
    * @returns cancel system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/cancel.md
    */
-  cancel?: (histories: AgenticaPrompt<Model>[]) => string;
+  cancel?: (histories: AgenticaHistory<Model>[]) => string;
 
   /**
    * Execute system prompt.
@@ -99,13 +99,13 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * In that case, this `execute` system prompt would be used. You can
    * customize it by assigning this function with the given
-   * {@link AgenticaPrompt histories} parameter.
+   * {@link AgenticaHistory histories} parameter.
    *
    * @param histories Histories of the previous prompts
    * @returns execute system prompt
    * https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/execute.md
    */
-  execute?: (histories: AgenticaPrompt<Model>[]) => string;
+  execute?: (histories: AgenticaHistory<Model>[]) => string;
 
   /**
    * Describe system prompt.
@@ -116,11 +116,11 @@ export interface IAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
    *
    * In that case, this `describe` system prompt would be used. You can
    * customize it by assigning this function with the given
-   * {@link AgenticaPrompt histories} parameter.
+   * {@link AgenticaHistory histories} parameter.
    *
    * @param histories Histories of the previous prompts
    * @returns describe system prompt
    * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/describe.md
    */
-  describe?: (histories: AgenticaExecutePrompt<Model>[]) => string;
+  describe?: (histories: AgenticaExecuteHistory<Model>[]) => string;
 }

package/src/structures/IAgenticaVendor.ts

@@ -1,7 +1,7 @@
 import type OpenAI from "openai";
 
 /**
- * LLM service vendor for Nestia Chat.
+ * LLM service vendor for Agentica Chat.
  *
  * `IAgenticaVendor` is a type represents an LLM
  * (Large Language Model) vendor of the {@link Agentica}.

package/src/structures/IMicroAgenticaConfig.ts

@@ -0,0 +1,82 @@
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { IMicroAgenticaExecutor } from "./IMicroAgenticaExecutor";
+import type { IMicroAgenticaSystemPrompt } from "./IMicroAgenticaSystemPrompt";
+
+/**
+ * Configuration for Micro Agentic Agent.
+ *
+ * `INicroAgenticaConfig` is an interface that defines the configuration
+ * properties of the {@link MicroAgentica}. With this configuration, you
+ * can set the user's {@link locale}, {@link timezone}, and some of
+ * {@link systemPrompt system prompts}.
+ *
+ * @author Samchon
+ */
+export interface IMicroAgenticaConfig<Model extends ILlmSchema.Model> {
+  /**
+   * Agent executor.
+   *
+   * Executor function of Agentic AI's iteration plan to internal agents
+   * running by the {@link Agentica.conversate} function.
+   *
+   * If you want to customize the agent execution plan, you can do it
+   * by assigning you logic function of entire or partial to this property.
+   * When customizing it, it would better to reference the
+   * {@link ChatGptAgent.execute} function.
+   *
+   * @param ctx Context of the agent
+   * @returns Lit of prompts generated by the executor
+   * @default ChatGptAgent.execute
+   */
+  executor?:
+    | undefined
+    | Partial<IMicroAgenticaExecutor<Model>>;
+
+  /**
+   * System prompt messages.
+   *
+   * System prompt messages if you want to customize the system prompt
+   * messages for each situation.
+   */
+  systemPrompt?: IMicroAgenticaSystemPrompt<Model>;
+
+  /**
+   * Locale of the A.I. chatbot.
+   *
+   * If you configure this property, the A.I. chatbot will conversate with
+   * the given locale. You can get the locale value by
+   *
+   * - Browser: `navigator.language`
+   * - NodeJS: `process.env.LANG.split(".")[0]`
+   *
+   * @default your_locale
+   */
+  locale?: string;
+
+  /**
+   * Timezone of the A.I. chatbot.
+   *
+   * If you configure this property, the A.I. chatbot will consider the
+   * given timezone. You can get the timezone value by
+   * `Intl.DateTimeFormat().resolvedOptions().timeZone`.
+   *
+   * @default your_timezone
+   */
+  timezone?: string;
+
+  /**
+   * Retry count.
+   *
+   * If LLM function calling composed arguments are invalid,
+   * the A.I. chatbot will retry to call the function with
+   * the modified arguments.
+   *
+   * By the way, if you configure it to 0 or 1, the A.I. chatbot
+   * will not retry the LLM function calling for correcting the
+   * arguments.
+   *
+   * @default 3
+   */
+  retry?: number;
+}

package/src/structures/IMicroAgenticaExecutor.ts

@@ -0,0 +1,63 @@
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { MicroAgenticaContext } from "../context/MicroAgenticaContext";
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
+import type { MicroAgenticaHistory } from "../histories/MicroAgenticaHistory";
+
+/**
+ * Executor of the Micro Agentic AI.
+ *
+ * `IMicroAgenticaExecutor` represents an executor of the
+ * {@link MicroAgentica}, composing its internal agents to accomplish
+ * the Agentic AI through the LLM (Large Language Model) function
+ * calling.
+ *
+ * You can customize one of these intnernal agents by configuring
+ * properties of the `IMicroAgenticaExecutor` type, and assigning
+ * it to the {@link IMicroAgenticaConfig.executor} property.
+ *
+ * @author Samchon
+ */
+export interface IMicroAgenticaExecutor<Model extends ILlmSchema.Model> {
+  /**
+   * Function caller agent.
+   *
+   * `Call` agent performs the LLM (Large Language Model) function
+   * calling from the candidate functions enrolled in the
+   * {@link AgenticaContext.stack}. And the scope of function calling
+   * is, not only just arguments filling, but also actual executing
+   * the function and returning the result.
+   *
+   * By the way, conversation context with user can be not enough to
+   * filling the arguments of the candidate functions. In that case,
+   * the `call` agent will ask the user to fill the missing arguments.
+   *
+   * Otherwise the cpnversation context is enough, so that succeeded
+   * to call some candidate functions, the `call` agent will step to
+   * the {@link describe} agent to explain the result of the function
+   * calling to the user as markdown content.
+   *
+   * @param ctx Context of the agent
+   * @returns List of prompts generated by the caller
+   * @warning Recommend not to customize, due to its validation
+   *          feedback strategy is working very well, and the `call`
+   *          agent is the most general topic which can be universally
+   *          applied to all domain fields.
+   */
+  call: (ctx: MicroAgenticaContext<Model>) => Promise<MicroAgenticaHistory<Model>[]>;
+
+  /**
+   * Describer agent of the function calling result.
+   *
+   * `Describe` agent explains the results of the function callings
+   * to the user as markdown content.
+   *
+   * @param ctx Context of the agent
+   * @param executes List of function calling results
+   * @returns List of prompts generated by the describer
+   */
+  describe: (
+    ctx: MicroAgenticaContext<Model>,
+    executes: AgenticaExecuteHistory<Model>[],
+  ) => Promise<MicroAgenticaHistory<Model>[]>;
+}

package/src/structures/IMicroAgenticaProps.ts

@@ -0,0 +1,70 @@
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { IMicroAgenticaHistoryJson } from "../json/IMicroAgenticaHistoryJson";
+
+import type { IAgenticaController } from "./IAgenticaController";
+import type { IAgenticaVendor } from "./IAgenticaVendor";
+import type { IMicroAgenticaConfig } from "./IMicroAgenticaConfig";
+
+/**
+ * Properties of the Micro Agentica Agent.
+ *
+ * `IMicroAgenticaProps` is an interface that defines the properties
+ * of the {@link MicroAgentica.constructor}. In the `IMicroAgenticaProps`,
+ * there're everything to prepare to create a Micro A.I. chatbot
+ * performing the LLM (Large Language Model) function calling.
+ *
+ * At first, you have to specify the LLM service {@link vendor} like
+ * OpenAI with its API key and client API. And then, you have to define
+ * the {@link controllers} serving the functions to call. The controllers
+ * are separated by two protocols; HTTP API and TypeScript class. At last,
+ * you can {@link config configure} the agent by setting the locale,
+ * timezone, and some of system prompts.
+ *
+ * Additionally, if you want to start from the previous A.I. chatbot
+ * session, you can accomplish it by assigning the previous prompt
+ * histories to the {@link histories} property.
+ *
+ * @author Samchon
+ */
+export interface IMicroAgenticaProps<Model extends ILlmSchema.Model> {
+  /**
+   * LLM schema model.
+   */
+  model: Model;
+
+  /**
+   * LLM service vendor.
+   */
+  vendor: IAgenticaVendor;
+
+  /**
+   * Controllers serving functions to call.
+   */
+  controllers: IAgenticaController<Model>[];
+
+  /**
+   * Configuration of agent.
+   *
+   * Configuration of A.I. chatbot agent including the user's locale,
+   * timezone, and some of system prompts. Also, you can affect to the
+   * LLM function selecting/calling logic by configuring additional
+   * properties.
+   *
+   * If you don't configure this property, these values would be default.
+   *
+   * - `locale`: your system's locale and timezone
+   * - `timezone`: your system's timezone
+   * - `systemPrompt`: default prompts written in markdown
+   *   - https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts
+   */
+  config?: IMicroAgenticaConfig<Model>;
+
+  /**
+   * Prompt histories.
+   *
+   * If you're starting the conversation from an existing session,
+   * assign the previouis prompt histories to this property.
+   */
+  histories?: IMicroAgenticaHistoryJson[];
+}

package/src/structures/IMicroAgenticaSystemPrompt.ts

@@ -0,0 +1,71 @@
+import type { ILlmSchema } from "@samchon/openapi";
+
+import type { AgenticaExecuteHistory } from "../histories/AgenticaExecuteHistory";
+import type { MicroAgenticaHistory } from "../histories/MicroAgenticaHistory";
+
+import type { IMicroAgenticaConfig } from "./IMicroAgenticaConfig";
+
+/**
+ * System prompt collection of the Micro Agentic AI.
+ *
+ * `IMicroAgenticaSystemPrompt` is a type represents a collection of
+ * system prompts that would be used by the A.I. chatbot of
+ * {@link MicroAgentica}.
+ *
+ * You can customize the system prompt by configuring the
+ * {@link IAgenticaConfig.systemPrompt} property when creating a new
+ * {@link Agentica} instance.
+ *
+ * If you don't configure any system prompts, the default system prompts
+ * would be used which are written in the below directory as markdown
+ * documents.
+ *
+ * - https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts
+ *
+ * @author Samchon
+ */
+export interface IMicroAgenticaSystemPrompt<Model extends ILlmSchema.Model> {
+  /**
+   * Common system prompt that would be used in every situation.
+   *
+   * @param config Configuration of the agent
+   * @returns The common system prompt
+   * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/common.md
+   */
+  common?: (config?: IMicroAgenticaConfig<Model> | undefined) => string;
+
+  /**
+   * Execute system prompt.
+   *
+   * The {@link Agentica} has a process filling the arguments of some
+   * selected candidate functions by the LLM (Large Language Model)
+   * function calling feature with the previous prompt histories, and
+   * executing the arguments filled function with validation feedback.
+   *
+   * In that case, this `execute` system prompt would be used. You can
+   * customize it by assigning this function with the given
+   * {@link AgenticaHistory histories} parameter.
+   *
+   * @param histories Histories of the previous prompts
+   * @returns execute system prompt
+   * https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/execute.md
+   */
+  execute?: null | ((histories: MicroAgenticaHistory<Model>[]) => string);
+
+  /**
+   * Describe system prompt.
+   *
+   * The {@link Agentica} has a process describing the return values of
+   * the executed functions by requesting to the A.I. agent with the
+   * previous prompt histories.
+   *
+   * In that case, this `describe` system prompt would be used. You can
+   * customize it by assigning this function with the given
+   * {@link AgenticaHistory histories} parameter.
+   *
+   * @param histories Histories of the previous prompts
+   * @returns describe system prompt
+   * @default https://github.com/wrtnlabs/agentica/tree/main/packages/core/prompts/describe.md
+   */
+  describe?: (histories: AgenticaExecuteHistory<Model>[]) => string;
+}