@runflow-ai/sdk 1.0.17 → 1.0.19
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 +14 -4
- package/dist/core/agent.d.ts +5 -30
- package/dist/core/agent.d.ts.map +1 -1
- package/dist/core/agent.js +259 -472
- package/dist/core/agent.js.map +1 -1
- package/dist/core/context.d.ts.map +1 -1
- package/dist/core/context.js +1 -11
- package/dist/core/context.js.map +1 -1
- package/dist/core/helpers/agent-context.d.ts +23 -0
- package/dist/core/helpers/agent-context.d.ts.map +1 -0
- package/dist/core/helpers/agent-context.js +90 -0
- package/dist/core/helpers/agent-context.js.map +1 -0
- package/dist/core/helpers/agent-memory.d.ts +17 -0
- package/dist/core/helpers/agent-memory.d.ts.map +1 -0
- package/dist/core/helpers/agent-memory.js +194 -0
- package/dist/core/helpers/agent-memory.js.map +1 -0
- package/dist/core/helpers/agent-rag.d.ts +22 -0
- package/dist/core/helpers/agent-rag.d.ts.map +1 -0
- package/dist/core/helpers/agent-rag.js +216 -0
- package/dist/core/helpers/agent-rag.js.map +1 -0
- package/dist/core/helpers/agent-utils.d.ts +13 -0
- package/dist/core/helpers/agent-utils.d.ts.map +1 -0
- package/dist/core/helpers/agent-utils.js +35 -0
- package/dist/core/helpers/agent-utils.js.map +1 -0
- package/dist/core/logger.d.ts +22 -0
- package/dist/core/logger.d.ts.map +1 -0
- package/dist/core/logger.js +91 -0
- package/dist/core/logger.js.map +1 -0
- package/dist/core/performance-logger.d.ts +45 -0
- package/dist/core/performance-logger.d.ts.map +1 -0
- package/dist/core/performance-logger.js +140 -0
- package/dist/core/performance-logger.js.map +1 -0
- package/dist/observability/trace-collector.d.ts.map +1 -1
- package/dist/observability/trace-collector.js +0 -16
- package/dist/observability/trace-collector.js.map +1 -1
- package/dist/types/all-types.d.ts +11 -3
- package/dist/types/all-types.d.ts.map +1 -1
- package/package.json +3 -1
package/README.md
CHANGED
|
@@ -788,22 +788,32 @@ const results = await knowledge.multiQuery(
|
|
|
788
788
|
);
|
|
789
789
|
```
|
|
790
790
|
|
|
791
|
-
#### Knowledge no Agent (
|
|
791
|
+
#### Knowledge no Agent (Agentic RAG)
|
|
792
792
|
|
|
793
793
|
```typescript
|
|
794
794
|
const agent = new Agent({
|
|
795
795
|
name: 'Support Agent',
|
|
796
|
-
instructions: '
|
|
796
|
+
instructions: 'You are a helpful support agent.',
|
|
797
797
|
model: openai('gpt-4o'),
|
|
798
798
|
rag: {
|
|
799
799
|
vectorStore: 'support-docs',
|
|
800
|
-
autoSearch: true, // Busca automática
|
|
801
800
|
k: 5,
|
|
802
801
|
threshold: 0.7,
|
|
802
|
+
|
|
803
|
+
// Prompt customizável - orienta quando buscar
|
|
804
|
+
searchPrompt: `Use searchKnowledge tool when user asks about:
|
|
805
|
+
- Technical problems
|
|
806
|
+
- Process questions
|
|
807
|
+
- Specific information
|
|
808
|
+
|
|
809
|
+
Don't use for greetings or casual chat.`,
|
|
810
|
+
|
|
811
|
+
toolDescription: 'Search in support documentation for solutions',
|
|
803
812
|
},
|
|
804
813
|
});
|
|
805
814
|
|
|
806
|
-
// Agent
|
|
815
|
+
// Agent tem tool 'searchKnowledge' gerada automaticamente
|
|
816
|
+
// LLM decide quando buscar (não busca sempre - mais eficiente!)
|
|
807
817
|
const result = await agent.process({
|
|
808
818
|
message: 'How do I reset my password?',
|
|
809
819
|
companyId: 'company_123',
|
package/dist/core/agent.d.ts
CHANGED
|
@@ -3,7 +3,7 @@ export declare class Agent {
|
|
|
3
3
|
private config;
|
|
4
4
|
private apiClient?;
|
|
5
5
|
private traceCollector?;
|
|
6
|
-
private
|
|
6
|
+
private logger;
|
|
7
7
|
constructor(config: AgentConfig);
|
|
8
8
|
_setAPIClient(apiClient: RunflowAPIClient): void;
|
|
9
9
|
generate(input: string | Array<{
|
|
@@ -25,40 +25,15 @@ export declare class Agent {
|
|
|
25
25
|
process(input: AgentInput, context?: ExecutionContext): Promise<AgentOutput>;
|
|
26
26
|
private processMultiAgent;
|
|
27
27
|
private createSupervisor;
|
|
28
|
-
|
|
28
|
+
/**
|
|
29
|
+
* Resolve o nível de log baseado na configuração de debug
|
|
30
|
+
*/
|
|
31
|
+
private resolveLogLevel;
|
|
29
32
|
get name(): string;
|
|
30
33
|
get instructions(): string;
|
|
31
34
|
get model(): import("../types").ModelProvider;
|
|
32
35
|
get tools(): Record<string, import("../types").RunflowTool>;
|
|
33
36
|
get isMultiAgent(): boolean;
|
|
34
|
-
private getUsedTools;
|
|
35
|
-
/**
|
|
36
|
-
* Resolver configuração de debug
|
|
37
|
-
*/
|
|
38
|
-
private resolveDebugConfig;
|
|
39
|
-
/**
|
|
40
|
-
* Generate unique execution ID
|
|
41
|
-
*/
|
|
42
|
-
private generateExecutionId;
|
|
43
|
-
/**
|
|
44
|
-
* Generate threadId based on input (fallback quando não fornecido)
|
|
45
|
-
*/
|
|
46
|
-
private generateThreadId;
|
|
47
|
-
/**
|
|
48
|
-
* Infer entityType from input metadata
|
|
49
|
-
*/
|
|
50
|
-
private inferEntityType;
|
|
51
|
-
/**
|
|
52
|
-
* Infer entityValue from input metadata
|
|
53
|
-
*/
|
|
54
|
-
private inferEntityValue;
|
|
55
|
-
/**
|
|
56
|
-
* Infer userId from input metadata
|
|
57
|
-
*/
|
|
58
|
-
private inferUserId;
|
|
59
|
-
private loadMemory;
|
|
60
|
-
private saveToMemory;
|
|
61
|
-
private processStreamChunks;
|
|
62
37
|
processStream(input: AgentInput, context?: ExecutionContext): Promise<AsyncIterable<{
|
|
63
38
|
text: string;
|
|
64
39
|
done: boolean;
|
package/dist/core/agent.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;
|
|
1
|
+
{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/core/agent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAsBpG,qBAAa,KAAK;IAChB,OAAO,CAAC,MAAM,CAAc;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAmB;IACrC,OAAO,CAAC,cAAc,CAAC,CAAM;IAC7B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,WAAW;IA4C/B,aAAa,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI;IAa1C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAC,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAoD3F,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAgCvF,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,GAAG,CAAA;KAAC,CAAC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAuRjG,OAAO,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;YA+TpE,iBAAiB;IAiD/B,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,IAAI,KAAK,qCAER;IAED,IAAI,KAAK,mDAER;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAGK,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CA6H5H"}
|