Merge pull request #58 from Callgent/blog

Blog

Author: Jamesp918

blog/2024-06-17-generative-ui-home-cooked-software-development/generative-ui.md

@@ -50,6 +50,6 @@ With predefined business services and standard widgets, the `Home-Cooked Softwar
 
 Callgent's core functionality is to do native function-calling to orchestrate business services.
 
-Callgent has server endpoints and client endpoints to adapt various invocation scenarios.
+Callgent has server entries and client entries to adapt various invocation scenarios.
 
-Specifically, widget based User Interface, is just one more type of client endpoints, to adapt human interactions.
+Specifically, widget based User Interface, is just one more type of client entries, to adapt human interactions.

developer/guide.md

@@ -7,7 +7,7 @@ description: Explore the innovative architecture of Callgent, where services and
 # Concepts and Architecture
 
 The core of the callgent architecture, is to encapsulate every **service** and **user** behind a `callgent`.  
-Then build various endpoints into third-party platforms, so that any users and services are naturally connected anywhere in their native ways: webpages, chatting, email, APIs..  
+Then build various entries into third-party platforms, so that any users and services are naturally connected anywhere in their native ways: webpages, chatting, email, APIs..  
 
 Above this, we add a layer of semantic invocations, empowered by large language models (LLMs), to make the callgent able to understand and react to any user/system's intents.
 
@@ -27,7 +27,7 @@ Each system service, and every user is encapsulated into a `Callgent`.
 
 ### Calling Anywhere
 
-Requesting a callgent is done through various `Calling Endpoint`, integrated into third-party platforms. So systems and users are naturally connected anywhere in their native ways: Webpages, chatting, email, APIs..
+Requesting a callgent is done through various `Client Entries`, integrated into third-party platforms. So systems and users are naturally connected anywhere in their native ways: Webpages, chatting, email, APIs..
 
 #### User-as-a-Service
 

…opics/callgent-endpoints/_category_.json …-topics/callgent-entries/_category_.jsondocs/advanced-topics/callgent-endpoints/_category_.json renamed to docs/advanced-topics/callgent-entries/_category_.json docs/advanced-topics/callgent-endpoints/_category_.json renamed to docs/advanced-topics/callgent-entries/_category_.json

@@ -1,8 +1,8 @@
 {
-  "label": "Callgent Endpoints",
+  "label": "Callgent Entries",
   "position": 1,
   "link": {
     "type": "doc",
-    "id": "endpoints"
+    "id": "entries"
   }
 }

…cs/callgent-endpoints/client-endpoint.md …-topics/callgent-entries/client-entry.mddocs/advanced-topics/callgent-endpoints/client-endpoint.md renamed to docs/advanced-topics/callgent-entries/client-entry.md docs/advanced-topics/callgent-endpoints/client-endpoint.md renamed to docs/advanced-topics/callgent-entries/client-entry.md

@@ -1,33 +1,33 @@
-# Callgent Endpoints
+# Callgent Entries
 
-Callgents endpoints are adaptors to collect callgent to external systems or users.
+Callgents entries are adaptors to collect callgent to external systems or users.
 
-There are three types of endpoints:
+There are three types of entries:
 
-- [Server Endpoint](./server-endpoint)
+- [Server Entry](./server-entry)
   Responsible for converting requests into the encapsulated target system invocation or user chatting, and retrieving invocation response.
-- [Client Endpoint](./client-endpoint)
+- [Client Entry](./client-entry)
   Responsible for receiving requests into callgent task queue, and responding back to caller when task has any progress.
-- [Event Endpoint](./event-endpoint)
+- [Event Entry](./event-entry)
   Responsible for listening to events from the encapsulated target system or user, and notifying registered event observers on callgent.
 
-## Add a new endpoint to callgent
+## Add a new entry to callgent
 
-When you want to connect your callgent to a new external system / user, you need to integrate them by adding a new endpoint.  
-You can add any number of endpoints to your callgent.
+When you want to connect your callgent to a new external system / user, you need to integrate them by adding a new entry.  
+You can add any number of entries to your callgent.
 
 ### choose a callgent
 
 FIXME: list your callgents
 
-### Step 1, choose a type of endpoint
+### Step 1, choose a type of entry
 
-Client endpoint to accept tasks from external system, and server endpoint to send tasks to external system / user.
+Client entry to accept tasks from external system, and server entry to send tasks to external system / user.
 
 ### Step 2, choose an adaptor to the external system
 
 You can also develop your own adaptor to the external system, if needed.
 
-### Step 3, configure the endpoint
+### Step 3, configure the entry
 
-### Step 4, initialize the endpoint
+### Step 4, initialize the entry

…d-topics/callgent-endpoints/endpoints.md …anced-topics/callgent-entries/entries.mddocs/advanced-topics/callgent-endpoints/endpoints.md renamed to docs/advanced-topics/callgent-entries/entries.md docs/advanced-topics/callgent-endpoints/endpoints.md renamed to docs/advanced-topics/callgent-entries/entries.md

@@ -34,18 +34,18 @@ Follow the instructions to fill in the API key, then confirm the creation.
 On successful creation, you will see a webhook URL on the callgent card. You must set this webhook URL on your canny.io > Settings > API > Webhooks.
 
 :::info
-The webhook URL is a event endpoint for canny.io to receive notification events to your callgent.
+The webhook URL is an event entry for canny.io to receive notification events to your callgent.
 :::
 
 ## Using your canny.io callgent
 
-### Client endpoint
+### Client entry
 
 Every user interactions on canny.io will go directly into your callgent task queue.
 
-### Server endpoint
+### Server entry
 
-You can add any server endpoint to your callgent. So that you can respond to these tasks anywhere, e.g.
+You can add any server entry to your callgent. So that you can respond to these tasks anywhere, e.g.
 
 - send to your Slack channels
 - as a github issue

…ics/callgent-endpoints/event-endpoint.md …d-topics/callgent-entries/event-entry.mddocs/advanced-topics/callgent-endpoints/event-endpoint.md renamed to docs/advanced-topics/callgent-entries/event-entry.md docs/advanced-topics/callgent-endpoints/event-endpoint.md renamed to docs/advanced-topics/callgent-entries/event-entry.md

@@ -1,7 +1,7 @@
 ---
 sidebar_position: 2
 keywords: [composite callgent, group callgent, Nested Callgents]
-description: Learn how to create and manage a Composite Callgent. Discover how to handle complex call requests, utilize nested callgents, and perform map/reduce operations. Simplify your call process with a single call endpoint and efficient callgent orchestration..
+description: Learn how to create and manage a Composite Callgent. Discover how to handle complex call requests, utilize nested callgents, and perform map/reduce operations. Simplify your call process with a single call entry and efficient callgent orchestration..
 ---
 
 # Group of Callgents
@@ -10,12 +10,12 @@ Multiple callgents can naturally be combined to form a new composite callgent, w
 
 ## Creating a Composite Callgent
 
-Similar to a regular callgent, which maintains a list of `function entries` to automatically map each request to a function entry, call it, and return the result, a composite callgent maintains a list of callgents. This allows each request to be automatically mapped to a `callgent entry`, called, and the result returned.
+Similar to a regular callgent, which maintains a list of `functional endpoints` to automatically map each request to an endpoint, call it, and return the result, a composite callgent maintains a list of callgents. This allows each request to be automatically mapped to a `callgent entry`, called, and the result returned.
 
 :::tip
-Callgent entries come in two types: `function entries` and `callgent entries`. These two types of entries can be mixed together.
+Callgent entries come in two types: `functional entries` and `callgentive entries`. These two types of entries can be mixed together.
 
-A callgent that contains `callgent entries` is typically referred to as a composite callgent.
+A callgent that contains `callgentive entries` is typically referred to as a composite callgent.
 :::
 
 ## Composite Callgent Invocation Process
@@ -30,15 +30,15 @@ Composite callgents can be nested, forming a call tree. Each node in the call tr
 
 ## Multiple Internal Invocations
 
-A callgent automatically maps a single request to an entry for processing and retrieves the response result. Based on the original request, the callgent decides whether to return the response to the caller or continue calling the next entry. This process repeats until the final result is returned to the caller.
+A callgent automatically maps a single request to an endpoint for processing and retrieves the response result. Based on the original request, the callgent decides whether to return the response to the caller or continue calling the next endpoint. This process repeats until the final result is returned to the caller.
 
 ### Request with Collection Data
 
 If the request contains collection data, the callgent may automatically perform map/reduce operations on the collection and map it to entry calls as needed.
 
 ## Advantages of Composite Callgent
 
-Composite Callgent allows multiple callgents to work together while maintaining a single call endpoint, enabling the handling of complex call requests.
+Composite Callgent allows multiple callgents to work together while maintaining a single call entry, enabling the handling of complex call requests.
 
 :::info
 Composite Callgent allows you to interact with a single callgent to invoke multiple callgents, simplifying the call process.

…cs/callgent-endpoints/server-endpoint.md …-topics/callgent-entries/server-entry.mddocs/advanced-topics/callgent-endpoints/server-endpoint.md renamed to docs/advanced-topics/callgent-entries/server-entry.md docs/advanced-topics/callgent-endpoints/server-endpoint.md renamed to docs/advanced-topics/callgent-entries/server-entry.md

@@ -16,7 +16,7 @@ Now you may request the callgent for a task, in the following ways.
 
 You may directly send an email to：<Email />
 
-then wait for reply from the callgent's [Service Endpoint](#connect-the-callgent-to-a-service-endpoint).
+then wait for reply from the callgent's [Service Entry](#connect-the-callgent-to-a-service-entry).
 
 :::tip
 The email address and API url below, contains callgent Id, which is available after you've [created the callgent](#create-a-new-callgent).
@@ -41,4 +41,4 @@ You may also generate a web page with a form or button to send a task to the cal
 For example, you may also want to connect the callgent to `Slack`, `Jira`, ..., Apps, so that colleagues can interact with the callgent in the channels;  
 Or connect it to your personal Apps like `WhatsApp`, `Instagram`, to let the callgent assist you anywhere seamlessly.
 
-This is achieved by adding more adaptive `Client Endpoint`s to the callgent, then do some neccessary configurations. You may learn more in the [Client Endpoint](../advanced-topics/callgent-endpoints/client-endpoint) section.
+This is achieved by adding more adaptive `Client Entry`s to the callgent, then do some neccessary configurations. You may learn more in the [Client Entry](../advanced-topics/callgent-entries/client-entry) section.