@agentica/chat 0.24.0 → 0.26.0

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
@@ -1,15 +1,21 @@
1
1
  # Agentica, AI Function Calling Framework
2
2
 
3
- <!-- https://github.com/user-attachments/assets/5326cc59-5129-470d-abcb-c3f458b5c488 -->
4
-
5
- ![Logo](https://wrtnlabs.io/agentica/og.jpg)
6
-
7
- [![GitHub License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/wrtnlabs/agentica/blob/master/LICENSE)
8
- [![NPM Version](https://img.shields.io/npm/v/@agentica/core.svg)](https://www.npmjs.com/package/@agentica/core)
9
- [![NPM Downloads](https://img.shields.io/npm/dm/@agentica/core.svg)](https://www.npmjs.com/package/@agentica/core)
10
- [![Build Status](https://github.com/wrtnlabs/agentica/workflows/build/badge.svg)](https://github.com/wrtnlabs/agentica/actions?query=workflow%3Abuild)
11
- [![Guide Documents](https://img.shields.io/badge/Guide-Documents-forestgreen)](https://wrtnlabs.io/agentica/)
12
- [![Discord Badge](https://dcbadge.limes.pink/api/server/https://discord.gg/aMhRmzkqCx?style=flat)](https://discord.gg/aMhRmzkqCx)
3
+ ![Agentica - ReadMe Diagram](https://github.com/user-attachments/assets/ecd06d51-b818-41c8-ab31-f0e40f48034e)
4
+
5
+ <!-- Github/NPM Badges -->
6
+ <p align="center">
7
+ <a href="https://github.com/wrtnlabs/agentica/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="MIT License"/></a>
8
+ <a href="https://www.npmjs.com/package/@agentica/core"><img src="https://img.shields.io/npm/v/@agentica/core.svg" alt="NPM Version"/></a>
9
+ <a href="https://www.npmjs.com/package/@agentica/core"><img src="https://img.shields.io/npm/dm/@agentica/core.svg" alt="NPM Downloads"/></a>
10
+ <a href="https://dormoshe.io/newsletters/373"><img src="https://img.shields.io/badge/DorMoshe%20Newsletter-Top%20%236%20of%201K-orange?style=flat&logo=rss" alt="Newsletter Top #6"/></a>
11
+ <a href="https://github.com/wrtnlabs/agentica/actions?query=workflow%3Abuild"><img src="https://github.com/wrtnlabs/agentica/workflows/build/badge.svg" alt="Build Status"/></a>
12
+ </p>
13
+
14
+ <!-- Youtube + Discord -->
15
+ <p align="center">
16
+ <a href="https://www.youtube.com/@wrtnlabs"><img src="https://img.shields.io/badge/YouTube%20Tutorial-0d1117?style=social&logo=youtube" alt="YouTube"/></a>&nbsp;
17
+ <a href="https://discord.gg/aMhRmzkqCx"><img src="https://img.shields.io/badge/Discord-0d1117?style=social&logo=discord" alt="Discord"/></a>
18
+ </p>
13
19
 
14
20
  Agentic AI framework specialized in AI Function Calling.
15
21
 
@@ -26,6 +32,7 @@ Are you a TypeScript developer? Then you're already an AI developer. Familiar wi
26
32
  <!-- eslint-skip -->
27
33
 
28
34
  ```typescript
35
+
29
36
  import { Agentica, assertHttpController } from "@agentica/core";
30
37
  import OpenAI from "openai";
31
38
  import typia from "typia";
@@ -39,12 +46,10 @@ const agent = new Agentica({
39
46
  },
40
47
  controllers: [
41
48
  // functions from TypeScript class
42
- {
43
- protocol: "class",
44
- name: "filesystem",
45
- application: typia.llm.application<MobileFileSystem, "chatgpt">(),
46
- execute: new MobileFileSystem(),
47
- },
49
+ typia.llm.controller<MobileFileSystem, "chatgpt">(
50
+ "filesystem",
51
+ MobileFileSystem(),
52
+ ),
48
53
  // functions from Swagger/OpenAPI
49
54
  assertHttpController({
50
55
  name: "shopping",
@@ -60,6 +65,7 @@ const agent = new Agentica({
60
65
  ],
61
66
  });
62
67
  await agent.conversate("I wanna buy MacBook Pro");
68
+
63
69
  ```
64
70
 
65
71
  ## 📦 Setup
@@ -102,9 +108,11 @@ Experience Agentica firsthand through our [interactive playground](https://wrtnl
102
108
  Our demonstrations showcase the power and simplicity of Agentica's function calling capabilities across different integration methods.
103
109
 
104
110
  - [TypeScript Class](https://wrtnlabs.io/agentica/playground/bbs)
105
- - [Swagger/OpenAPI Document](https://wrtnlabs.io/agentica/playground/swagger)
111
+ - [Swagger/OpenAPI Document](https://wrtnlabs.io/agentica/playground/uploader)
106
112
  - [Enterprise E-commerce Agent](https://wrtnlabs.io/agentica/playground/shopping)
107
113
 
114
+ ![E-commerce Agent Demo](https://github.com/user-attachments/assets/fbfa9f93-304c-4728-933e-deb8ecd7a2af)
115
+
108
116
  <!--
109
117
  @todo this section would be changed after making tutorial playground
110
118
  -->
@@ -115,11 +123,24 @@ Find comprehensive resources at our [official website](https://wrtnlabs.io/agent
115
123
 
116
124
  - [Home](https://wrtnlabs.io/agentica)
117
125
  - [Guide Documents](https://wrtnlabs.io/agentica/docs)
126
+ - [Setup](https://wrtnlabs.io/agentica/docs/setup/cli/)
127
+ - [Concepts](https://wrtnlabs.io/agentica/docs/concepts/function-calling/)
128
+ - [Core Library](https://wrtnlabs.io/agentica/docs/core/)
129
+ - [WebSocket Protocol](https://wrtnlabs.io/agentica/docs/websocket/)
130
+ - [Plugin Modules](https://wrtnlabs.io/agentica/docs/plugins/benchmark/)
118
131
  - [Tutorial](https://wrtnlabs.io/agentica/tutorial)
132
+ - [Productivity](https://wrtnlabs.io/agentica/tutorial/productivity/arxiv/)
133
+ - [Coding](https://wrtnlabs.io/agentica/tutorial/coding/file-system/)
134
+ - [React Native](https://wrtnlabs.io/agentica/tutorial/react-native/sms/)
135
+ - [Enterprise](https://wrtnlabs.io/agentica/tutorial/enterprise/shopping/)
119
136
  - [API Documents](https://wrtnlabs.io/agentica/api)
120
137
  - [Youtube](https://www.youtube.com/@wrtnlabs)
121
138
  - [Paper](https://wrtnlabs.io/agentica/paper)
122
139
 
140
+ https://github.com/user-attachments/assets/2f2a4cdc-6cf1-4304-b82d-04a8ed0be0dd
141
+
142
+ > Tutorial Videos: https://www.youtube.com/@wrtnlabs
143
+
123
144
  ## 🌟 Why Agentica?
124
145
 
125
146
  ```mermaid
@@ -154,6 +175,7 @@ Agentica enhances AI function calling by the following strategies:
154
175
  Thanks to these innovations, Agentica makes AI function calling easier, safer, and more accurate than before. Development becomes more intuitive since you only need to prepare functions relevant to your specific use case, and scaling your agent's capabilities is as simple as adding or removing functions.
155
176
 
156
177
  In 2023, when OpenAI announced function calling, many predicted that function calling-driven AI development would become the mainstream. However, in reality, due to the difficulty and instability of function calling, the trend in AI development became agent workflow. Agent workflow, which is inflexible and must be created for specific purposes, has conquered the AI agent ecosystem.
178
+
157
179
  By the way, as Agentica has resolved the difficulty and instability problems of function calling, the time has come to embrace function-driven AI development once again.
158
180
 
159
181
  | Type | Workflow | Vanilla Function Calling | Agentica Function Calling |
@@ -162,3 +184,20 @@ By the way, as Agentica has resolved the difficulty and instability problems of
162
184
  | Difficulty | ❌ Difficult | ❌ Difficult | 🟢 Easy |
163
185
  | Stability | 🟢 Stable | ❌ Unstable | 🟢 Stable |
164
186
  | Flexibility | ❌ Inflexible | 🟢 Flexible | 🟢 Flexible |
187
+
188
+ ## 💬 Community & Support
189
+
190
+ For support, questions, or to provide feedback, join our Discord community:
191
+
192
+ [![Discord](https://dcbadge.limes.pink/api/server/https://discord.gg/aMhRmzkqCx)](https://discord.gg/aMhRmzkqCx)
193
+
194
+ ## ⚖️ License
195
+
196
+ Agentica is open-source and available under the [MIT License](https://github.com/wrtnlabs/agentica/blob/master/LICENSE).
197
+
198
+ <p align="center">
199
+ <img src="https://github.com/user-attachments/assets/ecd0b82e-bfb7-4eb5-ae97-75be0cb22f10" alt="Wrtn Labs Logo" />
200
+ </p>
201
+ <div align="center">
202
+ Agentica is maintained by <a href="https://wrtnlabs.io">Wrtn Technologies</a> &mdash; Empowering developers to transform TypeScript functions and OpenAPI specs into powerful AI agents.
203
+ </div>