diff --git a/README.md b/README.md index 2c12f3603..7c9c35361 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,12 @@
-435380213-b6253409-8741-462b-a346-834cd18565a9 +voltagent -
-
+

+AI Agent Engineering Platform +

+
English | 繁體中文 | 简体中文 | 日本語 | 한국어
@@ -34,30 +36,18 @@ English | 繁體中文 | +

⭐ Like what we're doing? Give us a star ⬆️ -

+ -
- -VoltAgent is an end-to-end AI Agent Engineering Platform. The open-source TypeScript framework handles Memory, RAG, tools, and agent runtime; VoltOps delivers observability, automation, and deployment for production. (This repository contains the core framework.) - -Together, you can build agents with full code control and ship them with production-ready visibility and operations. - -## Why VoltAgent? +VoltAgent is an end-to-end AI Agent Engineering Platform that consists of two main parts: -- **End-to-End Development Platform**: Everything you need to build, observe, and deploy production-ready multi-agent systems in one place. -- **Production-Ready from Day One**: Ship agents with built-in memory, workflows, and observability instead of building infrastructure from scratch. -- **Code with Confidence**: Full TypeScript support with type-safe tools, automatic inference, and compile-time safety across your entire agent system. -- **Debug Like a Pro**: Built-in VoltOps observability lets you trace every decision, monitor performance, and optimize workflows in real-time without external tools. -- **Build Complex Systems Simply**: Orchestrate multi-agent teams with supervisor coordination, declarative workflows, and modular architecture that scales from prototypes to production. -- **Automate with Actions & Triggers**: Connect agents to external events like webhooks, schedules, or custom triggers to run workflows automatically without manual intervention. +- **[Open-Source TypeScript Framework](#core-framework)** – Memory, RAG, Guardrails, Tools, MCP, Voice, Workflow, and more. +- **[VoltOps Console](#voltops-console)** `Cloud` `Self-Hosted` – Observability, Automation, Deployment, Evals, Guardrails, Prompts, and more. -VoltAgent provides a complete platform for developing and monitoring AI agents through two complementary tools. +Build agents with full code control and ship them with production-ready visibility and operations. -### Core Framework +

Core TypeScript Framework

With the open-source framework, you can build intelligent agents with memory, tools, and multi-step workflows while connecting to any AI provider. Create sophisticated multi-agent systems where specialized agents work together under supervisor coordination. @@ -69,13 +59,9 @@ With the open-source framework, you can build intelligent agents with memory, to - **[Memory](https://voltagent.dev/docs/agents/memory/overview/)**: Attach durable memory adapters so agents remember important context across runs. - **[Retrieval & RAG](https://voltagent.dev/docs/rag/overview/)**: Plug in retriever agents to pull facts from your data sources and ground responses (RAG) before the model answers. - **[VoltAgent Knowledge Base](https://voltagent.dev/docs/rag/voltagent/)**: Use the managed RAG service for document ingestion, chunking, embeddings, and search. -- **[Evals](https://voltagent.dev/docs/evals/overview/)**: Ship guardrails faster by running agent eval suites alongside your workflows. - -### VoltOps Console: LLM Observability - Automation - Deployment - -VoltOps provides observability, automation, and deployment so you can monitor and debug agents in real-time with detailed execution traces, performance metrics, and visual dashboards. - -[More info](https://voltagent.dev/observability-docs/). +- **[Voice](https://voltagent.dev/docs/agents/voice/)**: Add text-to-speech and speech-to-text capabilities with OpenAI, ElevenLabs, or custom voice providers. +- **[Guardrails](https://voltagent.dev/docs/guardrails/overview/)**: Intercept and validate agent input or output at runtime to enforce content policies and safety rules. +- **[Evals](https://voltagent.dev/docs/evals/overview/)**: Run agent eval suites alongside your workflows to measure and improve agent behavior. #### MCP Server (@voltagent/mcp-docs-server) @@ -273,9 +259,9 @@ For more examples, visit our [examples repository](https://github.com/VoltAgent/ - **[AI Recipe Generator Agent](https://voltagent.dev/examples/agents/recipe-generator)** - Create personalized cooking suggestions based on ingredients and preferences. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) | [Video](https://youtu.be/KjV1c6AhlfY)) - **[AI Research Assistant Agent](https://voltagent.dev/examples/agents/research-assistant)** - Multi-agent research workflow for generating comprehensive reports. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) | [Video](https://youtu.be/j6KAUaoZMy4)) -## VoltOps Console +

VoltOps Console: LLM Observability - Automation - Deployment

-VoltOps Console is the platform side of VoltAgent where you get comprehensive observability, automation, and deployment for your agents in production. +VoltOps Console is the platform side of VoltAgent, providing observability, automation, and deployment so you can monitor and debug agents in production with real-time execution traces, performance metrics, and visual dashboards. 🎬 [Try Live Demo](https://console.voltagent.dev/demo) diff --git a/i18n/README-cn-bsc.md b/i18n/README-cn-bsc.md index 8f673d017..310bdf71c 100644 --- a/i18n/README-cn-bsc.md +++ b/i18n/README-cn-bsc.md @@ -1,10 +1,12 @@
-435380213-b6253409-8741-462b-a346-834cd18565a9 +voltagent -
-
+

+AI Agent 工程平台 +

+
English | 繁體中文 | 简体中文 | 日本語 | 한국어
@@ -22,7 +24,6 @@
-[![GitHub stars](https://img.shields.io/github/stars/voltagent/voltagent?style=social)](https://github.com/voltagent/voltagent) [![GitHub issues](https://img.shields.io/github/issues/voltagent/voltagent)](https://github.com/voltagent/voltagent/issues) [![GitHub pull requests](https://img.shields.io/github/issues-pr/voltagent/voltagent)](https://github.com/voltagent/voltagent/pulls) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) @@ -35,31 +36,20 @@
-
- -
+

⭐ 喜欢我们的项目吗?给我们一个星标 ⬆️ -

- -
- -**VoltAgent** 是一个开源的 TypeScript 框架,用于构建和编排 AI 代理。 -您可以构建具有记忆、工作流、工具和内置 LLM 可观测性的生产级代理。 + -## 为什么选择 VoltAgent? +VoltAgent 是一个端到端的 AI Agent 工程平台,由两个主要部分组成: -- **从第一天就准备就绪进行生产部署**:使用内置的记忆、工作流和可观测性部署代理,无需从零开始构建基础架构。 -- **自信编码**:完整的 TypeScript 支持,具有类型安全的工具、自动推断和整个代理系统的编译时安全性。 -- **像专业人士一样调试**:内置的 VoltOps 可观测性让您可以追踪每个决策、监控性能,并在不借助外部工具的情况下实时优化工作流。 -- **简单构建复杂系统**:通过主管协调、声明式工作流和模块化架构编排多代理团队,从原型扩展到生产环境。 +- **[开源 TypeScript 框架](#core-framework)** – Memory、RAG、Guardrails、Tools、MCP、Voice、Workflow 等。 +- **[VoltOps 控制台](#voltops-console)** `Cloud` `Self-Hosted` – 可观测性、自动化、部署、评估、安全护栏、提示词等。 -## 代理开发平台 +以完全的代码控制构建代理,并以生产就绪的可视化和操作来发布它们。 -VoltAgent 通过两个互补的工具提供完整的开发和监控 AI 代理平台。 +

核心 TypeScript 框架

-### 核心框架 - -使用核心框架,您可以构建具有记忆、工具和多步骤工作流的智能代理,同时连接到任何 AI 提供商。创建专业代理在主管协调下协同工作的精密多代理系统。 +使用开源框架,您可以构建具有记忆、工具和多步骤工作流的智能代理,同时连接到任何 AI 提供商。创建专业代理在主管协调下协同工作的精密多代理系统。 - **[核心运行时](https://voltagent.dev/docs/agents/overview/) (`@voltagent/core`)**:在一个地方定义具有类型化角色、工具、记忆和模型提供商的代理,使一切保持有序。 - **[工作流引擎](https://voltagent.dev/docs/workflows/overview/)**:声明式描述多步骤自动化,而不是拼接自定义控制流程。 @@ -69,11 +59,9 @@ VoltAgent 通过两个互补的工具提供完整的开发和监控 AI 代理平 - **[记忆](https://voltagent.dev/docs/agents/memory/overview/)**:附加持久记忆适配器,使代理能够跨运行记住重要上下文。 - **[检索与 RAG](https://voltagent.dev/docs/rag/overview/)**:插入检索器代理,从您的数据源提取事实并在模型回答之前奠定响应基础(RAG)。 - **[VoltAgent 知识库](https://voltagent.dev/docs/rag/voltagent/)**:使用托管的 RAG 服务进行文档摄入、分块、嵌入和搜索。 -- **[评估](https://voltagent.dev/docs/evals/overview/)**:与您的工作流一起运行代理评估套件,更快地提供防护栏。 - -### VoltOps LLM 可观测性平台 - -VoltAgent 配备内置的 [VoltOps](#使用-voltops-的内置-llm-可观测性) LLM 可观测性,可即时监控和调试您的代理,提供详细的执行跟踪、性能指标和视觉化仪表板。检查代理做出的每个决策,跟踪工具使用情况,并使用内置的基于 OpenTelemetry 的可观测性优化您的工作流。 +- **[语音](https://voltagent.dev/docs/agents/voice/)**:使用 OpenAI、ElevenLabs 或自定义语音提供商添加文本转语音和语音转文本功能。 +- **[安全护栏](https://voltagent.dev/docs/guardrails/overview/)**:在运行时拦截和验证代理输入或输出,以执行内容策略和安全规则。 +- **[评估](https://voltagent.dev/docs/evals/overview/)**:与您的工作流一起运行代理评估套件,以衡量和改进代理行为。 #### MCP 服务器 (@voltagent/mcp-docs-server) @@ -116,7 +104,7 @@ const memory = new Memory({ // 项目的简单通用代理 const agent = new Agent({ name: "my-agent", - instructions: "可以检查天气并协助各种任务的有用助手", + instructions: "A helpful assistant that can check weather and help with various tasks", model: openai("gpt-4o-mini"), tools: [weatherTool], memory, @@ -161,7 +149,7 @@ Test your agents with VoltOps Console: https://console.voltagent.dev 4. 开始聊天:在代理详情页面上,点击右下角的聊天图标以打开聊天窗口。 5. 发送消息:输入"你好"之类的消息并按 Enter。 -![VoltAgent VoltOps Platform Demo](https://github.com/user-attachments/assets/0adbec33-1373-4cf4-b67d-825f7baf1cb4) +[![VoltAgent Demo](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7)](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7) ### 运行您的第一个工作流 @@ -242,7 +230,7 @@ export const expenseApprovalWorkflow = createWorkflowChain({ 您可以直接从 VoltOps 控制台测试预建的 `expenseApprovalWorkflow`: -![VoltOps Workflow Observability](https://github.com/user-attachments/assets/9b877c65-f095-407f-9237-d7879964c38a) +[![expense-approval](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18)](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18) 1. **前往工作流页面**:启动服务器后,直接前往[工作流页面](https://console.voltagent.dev/workflows)。 2. **选择您的项目**:使用项目选择器选择您的项目(例如"my-agent-app")。 @@ -258,9 +246,22 @@ export const expenseApprovalWorkflow = createWorkflowChain({ ``` 5. **查看结果**:执行后,您可以检查每个步骤的详细日志,并直接在控制台中查看最终输出。 -## 使用 VoltOps 的内置 LLM 可观测性 +## 示例 + +有关更多示例,请访问我们的[示例仓库](https://github.com/VoltAgent/voltagent/tree/main/examples)。 -VoltAgent 配备 VoltOps,这是一个内置的 LLM 可观测性平台,可帮助您即时监控、调试和优化代理。 +- **[Airtable 代理](https://voltagent.dev/examples/guides/airtable-agent)** - 响应新记录并通过 VoltOps 操作将更新写回 Airtable。 +- **[Slack 代理](https://voltagent.dev/examples/guides/slack-agent)** - 响应频道消息并通过 VoltOps Slack 操作进行回复。 +- **[ChatGPT 应用与 VoltAgent](https://voltagent.dev/examples/agents/chatgpt-app)** - 通过 MCP 部署 VoltAgent 并连接到 ChatGPT 应用。 +- **[WhatsApp 订单代理](https://voltagent.dev/examples/agents/whatsapp-ai-agent)** - 构建一个 WhatsApp 聊天机器人,通过自然对话处理食品订单。([源代码](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp)) +- **[YouTube 转博客代理](https://voltagent.dev/examples/agents/youtube-blog-agent)** - 使用主管代理与 MCP 工具将 YouTube 视频转换为 Markdown 博客文章。([源代码](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog)) +- **[AI 广告生成代理](https://voltagent.dev/examples/agents/ai-instagram-ad-agent)** - 使用 BrowserBase Stagehand 和 Google Gemini AI 生成 Instagram 广告。([源代码](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator)) +- **[AI 食谱生成代理](https://voltagent.dev/examples/agents/recipe-generator)** - 根据食材和偏好创建个性化烹饪建议。([源代码](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) | [视频](https://youtu.be/KjV1c6AhlfY)) +- **[AI 研究助手代理](https://voltagent.dev/examples/agents/research-assistant)** - 用于生成全面报告的多代理研究工作流。([源代码](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) | [视频](https://youtu.be/j6KAUaoZMy4)) + +

VoltOps 控制台:LLM 可观测性 - 自动化 - 部署

+ +VoltOps 控制台是 VoltAgent 的平台端,提供可观测性、自动化和部署功能,让您可以通过实时执行跟踪、性能指标和可视化仪表板在生产环境中监控和调试代理。 🎬 [试用实时演示](https://console.voltagent.dev/demo) @@ -272,22 +273,17 @@ VoltAgent 配备 VoltOps,这是一个内置的 LLM 可观测性平台,可帮 通过详细的跟踪和性能指标深入了解代理执行流程。 -
- -![VoltOps Observability Overview](https://cdn.voltagent.dev/console/observability.png) +1 ### 仪表板 获取所有代理、工作流和系统性能指标的全面概览。 -
- -![VoltOps Dashboard](https://cdn.voltagent.dev/console/dashboard.png) +dashboard ### 日志 跟踪每个代理交互和工作流步骤的详细执行日志。 -
![VoltOps Logs](https://cdn.voltagent.dev/console/logs.png) @@ -295,145 +291,61 @@ VoltAgent 配备 VoltOps,这是一个内置的 LLM 可观测性平台,可帮 检查和管理代理记忆、上下文和对话历史。 -
- ![VoltOps Memory Overview](https://cdn.voltagent.dev/console/memory.png) ### 跟踪 分析完整的执行跟踪以了解代理行为并优化性能。 -
- ![VoltOps Traces](https://cdn.voltagent.dev/console/traces.png) ### 提示生成器 直接在控制台中设计、测试和改进提示。 -
- -![VoltOps Prompt Builder](https://cdn.voltagent.dev/console/prompt.png) +prompts ### 部署 通过一键 GitHub 集成和托管基础架构将您的代理部署到生产环境。 -
- -![VoltOps Deploy](https://cdn.voltagent.dev/website/feature-showcase/deployment.png) +deployment 📖 [VoltOps 部署文档](https://voltagent.dev/docs/deployment/voltops/) -## 示例 - -探索具有完整源代码和视频教程的 VoltAgent 实际实现。 - -有关更多示例和用例,请访问我们的[示例仓库](https://github.com/VoltAgent/voltagent/tree/main/examples)。 - -### WhatsApp 订单代理 - -构建一个 WhatsApp 聊天机器人,通过自然对话处理食品订单,从数据库管理菜单项,并使用完整的对话上下文处理订单。 - -
- -whatsapp +### 触发器与操作 -
-
- - -- 📖 [教程](https://voltagent.dev/examples/agents/whatsapp-ai-agent) -- 💻 [源代码](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp) - -### YouTube 转博客代理 - -使用主管代理协调具有 MCP 工具、共享工作记忆和 VoltOps 可观测性的子代理,将 YouTube 视频转换为 Markdown 博客文章。 - -
- -youtube - -
-
- - -- 📖 [教程](https://voltagent.dev/examples/agents/youtube-blog-agent) -- 💻 [源代码](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog) - -### AI 广告生成代理 - -实现一个 Instagram 广告生成器,使用 BrowserBase Stagehand 分析着陆页、提取品牌数据并通过 Google Gemini AI 生成视觉效果。 - -
- - -instagram - +使用 webhooks、计划和自定义触发器自动化代理工作流,以响应外部事件。 -
-
+triggers +### 监控 -- 📖 [教程](https://voltagent.dev/examples/agents/ai-instagram-ad-agent) -- 💻 [源代码](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator) +监控整个系统的代理健康状况、性能指标和资源使用情况。 -### AI 食谱生成代理 +monitoring -构建一个智能食谱推荐系统,根据可用食材、饮食偏好和时间限制创建个性化烹饪建议。 - -
+### 安全护栏 - -cook - +设置安全边界和内容过滤器,确保代理在定义的参数范围内运行。 -
-
+guardrails +### 评估 -- 📖 [教程](https://voltagent.dev/examples/agents/recipe-generator) -- 📹 [观看视频](https://youtu.be/KjV1c6AhlfY) -- 💻 [源代码](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) +运行评估套件以测试代理行为、准确性和性能基准。 -### AI 研究助手代理 +evals -创建一个多代理研究工作流,其中不同的 AI 代理协作研究主题并生成具有类型安全数据流的全面报告。 +### RAG(知识库) -
+将您的代理连接到知识源,具有内置的检索增强生成功能。 - -research - - -
-
- - -- 📖 [教程](https://voltagent.dev/examples/agents/research-assistant) -- 📹 [观看视频](https://youtu.be/j6KAUaoZMy4) -- 💻 [源代码](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) - -## 用例 - -为不同行业的实际业务需求构建 AI 代理: - -- **[HR 代理](https://voltagent.dev/use-cases/hr-agent/)** - 自动化招聘、员工入职和 HR 支持任务。 -- **[客户支持代理](https://voltagent.dev/use-cases/customer-support-agent/)** - 构建处理客户问题和疑问的支持代理。 -- **[销售团队](https://voltagent.dev/use-cases/sales-teams/)** - 验证潜在客户、收集客户数据并个性化销售外展。 -- **[财务代理](https://voltagent.dev/use-cases/finance-agent/)** - 管理发票、跟踪费用并生成财务报告。 -- **[开发代理](https://voltagent.dev/use-cases/development-agent/)** - 审查代码、管理部署并帮助开发团队。 -- **[营销代理](https://voltagent.dev/use-cases/marketing-agent/)** - 规划活动、创建内容并分析营销性能。 -- **[法律代理](https://voltagent.dev/use-cases/legal-agent/)** - 审查合同、检查合规性并处理法律任务。 -- **[保险代理](https://voltagent.dev/use-cases/insurance-agent/)** - 处理索赔、评估风险并管理保单。 -- **[工业代理](https://voltagent.dev/use-cases/industrial-agent/)** - 监控设备、预测维护需求并确保安全。 -- **[教育代理](https://voltagent.dev/use-cases/education-agent/)** - 提供个性化辅导、跟踪学生进度并支持学习。 -- **[政府代理](https://voltagent.dev/use-cases/government-agent/)** - 处理许可申请、处理福利并服务公民。 -- **[文档代理](https://voltagent.dev/use-cases/documentation-agent/)** - 创建 API 文档、编写变更日志并从代码生成教程。 +rag ## 学习 VoltAgent -- 📖 **[从互动式教程开始](https://voltagent.dev/tutorial/introduction/)**以学习构建 AI 代理的基础知识。 +- **[从互动式教程开始](https://voltagent.dev/tutorial/introduction/)** 以学习构建 AI 代理的基础知识。 - **[文档](https://voltagent.dev/docs/)**:深入了解指南、概念和教程。 - **[示例](https://github.com/voltagent/voltagent/tree/main/examples)**:探索实际实现。 - **[博客](https://voltagent.dev/blog/)**:阅读更多技术见解和最佳实践。 @@ -448,10 +360,8 @@ VoltAgent 配备 VoltOps,这是一个内置的 LLM 可观测性平台,可帮 VoltAgent 是一项社区努力,正是因为有像您这样的人,它才不断变得更好。 -![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=100) - -您的星星帮助我们接触更多开发者!如果您发现 VoltAgent 有用,请考虑在 GitHub 上给我们一颗星以支持该项目并帮助其他人发现它。 +![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=500&columns=20&anon=1) ## 许可证 -在 MIT 许可证下授权,Copyright © 2025-present VoltAgent。 +在 MIT 许可证下授权,Copyright © 2026-present VoltAgent。 diff --git a/i18n/README-cn-traditional.md b/i18n/README-cn-traditional.md index fc254ebd6..fcbf78603 100644 --- a/i18n/README-cn-traditional.md +++ b/i18n/README-cn-traditional.md @@ -1,10 +1,12 @@
-435380213-b6253409-8741-462b-a346-834cd18565a9 +voltagent -
-
+

+AI Agent 工程平台 +

+
English | 繁體中文 | 简体中文 | 日本語 | 한국어
@@ -22,7 +24,6 @@
-[![GitHub stars](https://img.shields.io/github/stars/voltagent/voltagent?style=social)](https://github.com/voltagent/voltagent) [![GitHub issues](https://img.shields.io/github/issues/voltagent/voltagent)](https://github.com/voltagent/voltagent/issues) [![GitHub pull requests](https://img.shields.io/github/issues-pr/voltagent/voltagent)](https://github.com/voltagent/voltagent/pulls) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) @@ -35,31 +36,20 @@
-
- -
-⭐ 喜歡我們的項目嗎?給我們一個星標 ⬆️ -
- -
- -**VoltAgent** 是一個開源的 TypeScript 框架,用於構建和編排 AI 代理。 -您可以構建具有記憶、工作流程、工具和內建 LLM 可觀測性的生產就緒代理。 - -## 為什麼選擇 VoltAgent? +

+⭐ 喜歡我們的專案嗎?給我們一個星標 ⬆️ +

-- **從第一天就準備好生產環境**:部署具有內建記憶、工作流程和可觀測性的代理,而無需從頭開始構建基礎設施。 -- **自信編碼**:全面的 TypeScript 支援,具有類型安全的工具、自動推斷和整個代理系統的編譯時安全性。 -- **像專業人士一樣調試**:內建的 VoltOps 可觀測性讓您追蹤每個決策、監控效能並即時優化工作流程,無需外部工具。 -- **簡單構建複雜系統**:使用監督協調、聲明式工作流程和模組化架構編排多代理團隊,從原型擴展到生產環境。 +VoltAgent 是一個端到端的 AI Agent 工程平台,由兩個主要部分組成: -## 代理開發平台 +- **[開源 TypeScript 框架](#core-framework)** – Memory、RAG、Guardrails、Tools、MCP、Voice、Workflow 等。 +- **[VoltOps 控制台](#voltops-console)** `Cloud` `Self-Hosted` – 可觀測性、自動化、部署、評估、安全護欄、提示詞等。 -VoltAgent 通過兩個互補的工具提供完整的開發和監控 AI 代理平台。 +以完全的程式碼控制構建代理,並以生產就緒的可視化和操作來發布它們。 -### 核心框架 +

核心 TypeScript 框架

-使用核心框架,您可以構建具有記憶、工具和多步驟工作流程的智能代理,同時連接到任何 AI 提供商。創建專業代理在監督協調下協同工作的精密多代理系統。 +使用開源框架,您可以構建具有記憶、工具和多步驟工作流程的智慧代理,同時連接到任何 AI 提供商。創建專業代理在監督協調下協同工作的精密多代理系統。 - **[核心運行時](https://voltagent.dev/docs/agents/overview/) (`@voltagent/core`)**:在一個地方定義具有類型化角色、工具、記憶和模型提供商的代理,使一切保持有序。 - **[工作流程引擎](https://voltagent.dev/docs/workflows/overview/)**:聲明式描述多步驟自動化,而不是拼接自定義控制流程。 @@ -69,11 +59,9 @@ VoltAgent 通過兩個互補的工具提供完整的開發和監控 AI 代理平 - **[記憶](https://voltagent.dev/docs/agents/memory/overview/)**:附加持久記憶適配器,使代理能夠跨運行記住重要上下文。 - **[檢索與 RAG](https://voltagent.dev/docs/rag/overview/)**:插入檢索器代理,從您的數據源提取事實並在模型回答之前奠定響應基礎(RAG)。 - **[VoltAgent 知識庫](https://voltagent.dev/docs/rag/voltagent/)**:使用託管的 RAG 服務進行文檔攝入、分塊、嵌入和搜索。 -- **[評估](https://voltagent.dev/docs/evals/overview/)**:與您的工作流程一起運行代理評估套件,更快地提供防護欄。 - -### VoltOps LLM 可觀測性平台 - -VoltAgent 配備內建的 [VoltOps](#使用-voltops-的內建-llm-可觀測性) LLM 可觀測性,可即時監控和調試您的代理,提供詳細的執行追蹤、效能指標和視覺化儀表板。檢查代理做出的每個決策,追蹤工具使用情況,並使用內建的基於 OpenTelemetry 的可觀測性優化您的工作流程。 +- **[語音](https://voltagent.dev/docs/agents/voice/)**:使用 OpenAI、ElevenLabs 或自定義語音提供商添加文字轉語音和語音轉文字功能。 +- **[安全護欄](https://voltagent.dev/docs/guardrails/overview/)**:在運行時攔截和驗證代理輸入或輸出,以執行內容策略和安全規則。 +- **[評估](https://voltagent.dev/docs/evals/overview/)**:與您的工作流程一起運行代理評估套件,以衡量和改進代理行為。 #### MCP 伺服器 (@voltagent/mcp-docs-server) @@ -116,7 +104,7 @@ const memory = new Memory({ // 專案的簡單通用代理 const agent = new Agent({ name: "my-agent", - instructions: "可以檢查天氣並協助各種任務的有用助手", + instructions: "A helpful assistant that can check weather and help with various tasks", model: openai("gpt-4o-mini"), tools: [weatherTool], memory, @@ -161,7 +149,7 @@ Test your agents with VoltOps Console: https://console.voltagent.dev 4. 開始聊天:在代理詳情頁面上,點擊右下角的聊天圖示以打開聊天視窗。 5. 發送訊息:輸入「你好」之類的訊息並按 Enter。 -![VoltAgent VoltOps Platform Demo](https://github.com/user-attachments/assets/0adbec33-1373-4cf4-b67d-825f7baf1cb4) +[![VoltAgent Demo](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7)](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7) ### 運行您的第一個工作流程 @@ -242,7 +230,7 @@ export const expenseApprovalWorkflow = createWorkflowChain({ 您可以直接從 VoltOps 控制台測試預建的 `expenseApprovalWorkflow`: -![VoltOps Workflow Observability](https://github.com/user-attachments/assets/9b877c65-f095-407f-9237-d7879964c38a) +[![expense-approval](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18)](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18) 1. **前往工作流程頁面**:啟動伺服器後,直接前往[工作流程頁面](https://console.voltagent.dev/workflows)。 2. **選擇您的專案**:使用專案選擇器選擇您的專案(例如「my-agent-app」)。 @@ -258,9 +246,22 @@ export const expenseApprovalWorkflow = createWorkflowChain({ ``` 5. **查看結果**:執行後,您可以檢查每個步驟的詳細日誌,並直接在控制台中查看最終輸出。 -## 使用 VoltOps 的內建 LLM 可觀測性 +## 範例 -VoltAgent 配備 VoltOps,這是一個內建的 LLM 可觀測性平台,可幫助您即時監控、調試和優化代理。 +有關更多範例,請訪問我們的[範例存儲庫](https://github.com/VoltAgent/voltagent/tree/main/examples)。 + +- **[Airtable 代理](https://voltagent.dev/examples/guides/airtable-agent)** - 響應新記錄並通過 VoltOps 操作將更新寫回 Airtable。 +- **[Slack 代理](https://voltagent.dev/examples/guides/slack-agent)** - 響應頻道訊息並通過 VoltOps Slack 操作進行回覆。 +- **[ChatGPT 應用與 VoltAgent](https://voltagent.dev/examples/agents/chatgpt-app)** - 通過 MCP 部署 VoltAgent 並連接到 ChatGPT 應用。 +- **[WhatsApp 訂單代理](https://voltagent.dev/examples/agents/whatsapp-ai-agent)** - 構建一個 WhatsApp 聊天機器人,通過自然對話處理食品訂單。([原始碼](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp)) +- **[YouTube 轉部落格代理](https://voltagent.dev/examples/agents/youtube-blog-agent)** - 使用監督者代理與 MCP 工具將 YouTube 視訊轉換為 Markdown 部落格文章。([原始碼](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog)) +- **[AI 廣告生成代理](https://voltagent.dev/examples/agents/ai-instagram-ad-agent)** - 使用 BrowserBase Stagehand 和 Google Gemini AI 生成 Instagram 廣告。([原始碼](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator)) +- **[AI 食譜生成代理](https://voltagent.dev/examples/agents/recipe-generator)** - 根據食材和偏好創建個性化烹飪建議。([原始碼](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) | [視訊](https://youtu.be/KjV1c6AhlfY)) +- **[AI 研究助手代理](https://voltagent.dev/examples/agents/research-assistant)** - 用於生成全面報告的多代理研究工作流程。([原始碼](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) | [視訊](https://youtu.be/j6KAUaoZMy4)) + +

VoltOps 控制台:LLM 可觀測性 - 自動化 - 部署

+ +VoltOps 控制台是 VoltAgent 的平台端,提供可觀測性、自動化和部署功能,讓您可以通過實時執行追蹤、效能指標和可視化儀表板在生產環境中監控和調試代理。 🎬 [試用即時演示](https://console.voltagent.dev/demo) @@ -272,22 +273,17 @@ VoltAgent 配備 VoltOps,這是一個內建的 LLM 可觀測性平台,可幫 通過詳細的追蹤和效能指標深入了解代理執行流程。 -
- -![VoltOps Observability Overview](https://cdn.voltagent.dev/console/observability.png) +1 ### 儀表板 獲取所有代理、工作流程和系統效能指標的全面概覽。 -
- -![VoltOps Dashboard](https://cdn.voltagent.dev/console/dashboard.png) +dashboard ### 日誌 追蹤每個代理互動和工作流程步驟的詳細執行日誌。 -
![VoltOps Logs](https://cdn.voltagent.dev/console/logs.png) @@ -295,140 +291,61 @@ VoltAgent 配備 VoltOps,這是一個內建的 LLM 可觀測性平台,可幫 檢查和管理代理記憶、上下文和對話歷史。 -
- ![VoltOps Memory Overview](https://cdn.voltagent.dev/console/memory.png) ### 追蹤 分析完整的執行追蹤以了解代理行為並優化效能。 -
- ![VoltOps Traces](https://cdn.voltagent.dev/console/traces.png) ### 提示生成器 直接在控制台中設計、測試和改進提示。 -
- -![VoltOps Prompt Builder](https://cdn.voltagent.dev/console/prompt.png) +prompts ### 部署 透過一鍵 GitHub 整合和託管基礎設施將您的代理部署到生產環境。 -
- -![VoltOps Deploy](https://cdn.voltagent.dev/website/feature-showcase/deployment.png) +deployment 📖 [VoltOps 部署文檔](https://voltagent.dev/docs/deployment/voltops/) -## 範例 +### 觸發器與操作 -探索具有完整原始碼和視訊教程的 VoltAgent 實際實現。 +使用 webhooks、計劃和自定義觸發器自動化代理工作流程,以響應外部事件。 -有關更多範例和用例,請訪問我們的[範例存儲庫](https://github.com/VoltAgent/voltagent/tree/main/examples)。 +triggers -### WhatsApp 訂單代理 +### 監控 -構建一個 WhatsApp 聊天機器人,通過自然對話處理食品訂單,從數據庫管理菜單項,並使用完整的對話上下文處理訂單。 +監控整個系統的代理健康狀況、效能指標和資源使用情況。 -
+monitoring -whatsapp +### 安全護欄 -
-
+設置安全邊界和內容過濾器,確保代理在定義的參數範圍內運行。 -- 📖 [教程](https://voltagent.dev/examples/agents/whatsapp-ai-agent) -- 💻 [原始碼](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp) +guardrails -### YouTube 轉部落格代理 +### 評估 -使用監督者代理協調具有 MCP 工具、共享工作記憶和 VoltOps 可觀測性的子代理,將 YouTube 視訊轉換為 Markdown 部落格文章。 +運行評估套件以測試代理行為、準確性和效能基準。 -
+evals -youtube +### RAG(知識庫) -
-
- -- 📖 [教程](https://voltagent.dev/examples/agents/youtube-blog-agent) -- 💻 [原始碼](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog) - -### AI 廣告生成代理 - -實現一個 Instagram 廣告生成器,使用 BrowserBase Stagehand 分析著陸頁、提取品牌數據並通過 Google Gemini AI 生成視覺效果。 - -
- - -instagram - - -
-
- -- 📖 [教程](https://voltagent.dev/examples/agents/ai-instagram-ad-agent) -- 💻 [原始碼](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator) +將您的代理連接到知識源,具有內建的檢索增強生成功能。 -### AI 食譜生成代理 - -構建一個智能食譜推薦系統,根據可用食材、飲食偏好和時間限制創建個性化烹飪建議。 - -
- - -cook - - -
-
- -- 📖 [教程](https://voltagent.dev/examples/agents/recipe-generator) -- 📹 [觀看視訊](https://youtu.be/KjV1c6AhlfY) -- 💻 [原始碼](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) - -### AI 研究助手代理 - -創建一個多代理研究工作流程,其中不同的 AI 代理協作研究主題並生成具有類型安全數據流的全面報告。 - -
- - -research - - -
-
- -- 📖 [教程](https://voltagent.dev/examples/agents/research-assistant) -- 📹 [觀看視訊](https://youtu.be/j6KAUaoZMy4) -- 💻 [原始碼](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) - -## 用例 - -為不同行業的實際業務需求構建 AI 代理: - -- **[HR 代理](https://voltagent.dev/use-cases/hr-agent/)** - 自動化招聘、員工入職和 HR 支援任務。 -- **[客戶支援代理](https://voltagent.dev/use-cases/customer-support-agent/)** - 構建處理客戶問題和疑問的支援代理。 -- **[銷售團隊](https://voltagent.dev/use-cases/sales-teams/)** - 驗證潛在客戶、收集客戶數據並個性化銷售外展。 -- **[財務代理](https://voltagent.dev/use-cases/finance-agent/)** - 管理發票、追蹤費用並生成財務報告。 -- **[開發代理](https://voltagent.dev/use-cases/development-agent/)** - 審查程式碼、管理部署並幫助開發團隊。 -- **[行銷代理](https://voltagent.dev/use-cases/marketing-agent/)** - 規劃活動、創建內容並分析行銷效能。 -- **[法律代理](https://voltagent.dev/use-cases/legal-agent/)** - 審查合約、檢查合規性並處理法律任務。 -- **[保險代理](https://voltagent.dev/use-cases/insurance-agent/)** - 處理索賠、評估風險並管理保單。 -- **[工業代理](https://voltagent.dev/use-cases/industrial-agent/)** - 監控設備、預測維護需求並確保安全。 -- **[教育代理](https://voltagent.dev/use-cases/education-agent/)** - 提供個性化輔導、追蹤學生進度並支援學習。 -- **[政府代理](https://voltagent.dev/use-cases/government-agent/)** - 處理許可申請、處理福利並服務公民。 -- **[文檔代理](https://voltagent.dev/use-cases/documentation-agent/)** - 創建 API 文檔、編寫變更日誌並從程式碼生成教程。 +rag ## 學習 VoltAgent -- 📖 **[從互動式教程開始](https://voltagent.dev/tutorial/introduction/)**以學習構建 AI 代理的基礎知識。 +- **[從互動式教程開始](https://voltagent.dev/tutorial/introduction/)** 以學習構建 AI 代理的基礎知識。 - **[文檔](https://voltagent.dev/docs/)**:深入了解指南、概念和教程。 - **[範例](https://github.com/voltagent/voltagent/tree/main/examples)**:探索實際實現。 - **[部落格](https://voltagent.dev/blog/)**:閱讀更多技術見解和最佳實踐。 @@ -443,10 +360,8 @@ VoltAgent 配備 VoltOps,這是一個內建的 LLM 可觀測性平台,可幫 VoltAgent 是一項社群努力,正是因為有像您這樣的人,它才不斷變得更好。 -![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=100) - -您的星星幫助我們接觸更多開發者!如果您發現 VoltAgent 有用,請考慮在 GitHub 上給我們一顆星以支援該專案並幫助其他人發現它。 +![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=500&columns=20&anon=1) ## 許可證 -在 MIT 許可證下授權,Copyright © 2025-present VoltAgent。 +在 MIT 許可證下授權,Copyright © 2026-present VoltAgent。 diff --git a/i18n/README-jp.md b/i18n/README-jp.md index 5278ce7f6..99e68426f 100644 --- a/i18n/README-jp.md +++ b/i18n/README-jp.md @@ -1,10 +1,12 @@
-435380213-b6253409-8741-462b-a346-834cd18565a9 +voltagent -
-
+

+AIエージェントエンジニアリングプラットフォーム +

+
English | 繁體中文 | 简体中文 | 日本語 | 한국어
@@ -12,7 +14,7 @@
- ホーム | + ホームページ | ドキュメント | サンプル
@@ -22,7 +24,6 @@
-[![GitHub stars](https://img.shields.io/github/stars/voltagent/voltagent?style=social)](https://github.com/voltagent/voltagent) [![GitHub issues](https://img.shields.io/github/issues/voltagent/voltagent)](https://github.com/voltagent/voltagent/issues) [![GitHub pull requests](https://img.shields.io/github/issues-pr/voltagent/voltagent)](https://github.com/voltagent/voltagent/pulls) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) @@ -35,25 +36,20 @@
-
- -**VoltAgent**は、AIエージェントを構築し、オーケストレーションするためのオープンソースTypeScriptフレームワークです。 -メモリ、ワークフロー、ツール、組み込みのLLM可観測性を備えた本番環境対応のエージェントを構築できます。 - -## なぜVoltAgentなのか? +

+⭐ 気に入ったらスターをください ⬆️ +

-- **初日から本番環境対応**: インフラをゼロから構築する代わりに、組み込みのメモリ、ワークフロー、可観測性を備えたエージェントをデプロイします。 -- **自信を持ってコーディング**: エージェントシステム全体で型安全なツール、自動推論、コンパイル時の安全性を備えた完全なTypeScriptサポート。 -- **プロのようにデバッグ**: 組み込みのVoltOps可観測性により、すべての決定を追跡し、パフォーマンスを監視し、外部ツールなしでリアルタイムでワークフローを最適化します。 -- **複雑なシステムをシンプルに構築**: プロトタイプから本番環境までスケールする、スーパーバイザーの調整、宣言的ワークフロー、モジュラーアーキテクチャでマルチエージェントチームをオーケストレーションします。 +VoltAgentは、2つの主要な部分で構成されるエンドツーエンドのAIエージェントエンジニアリングプラットフォームです: -## エージェント開発プラットフォーム +- **[オープンソースTypeScriptフレームワーク](#core-framework)** – メモリ、RAG、ガードレール、ツール、MCP、音声、ワークフローなど。 +- **[VoltOpsコンソール](#voltops-console)** `クラウド` `セルフホスト` – 可観測性、自動化、デプロイ、評価、ガードレール、プロンプトなど。 -VoltAgentは、2つの補完的なツールを通じてAIエージェントを開発および監視するための完全なプラットフォームを提供します。 +完全なコード制御でエージェントを構築し、本番環境対応の可視性とオペレーションでリリースできます。 -### コアフレームワーク +

コアTypeScriptフレームワーク

-コアフレームワークを使用すると、任意のAIプロバイダーに接続しながら、メモリ、ツール、複数ステップのワークフローを備えたインテリジェントなエージェントを構築できます。専門化されたエージェントがスーパーバイザーの調整下で連携する洗練されたマルチエージェントシステムを作成します。 +オープンソースフレームワークを使用すると、任意のAIプロバイダーに接続しながら、メモリ、ツール、複数ステップのワークフローを備えたインテリジェントなエージェントを構築できます。専門化されたエージェントがスーパーバイザーの調整下で連携する洗練されたマルチエージェントシステムを作成します。 - **[コアランタイム](https://voltagent.dev/docs/agents/overview/) (`@voltagent/core`)**: 型付きの役割、ツール、メモリ、モデルプロバイダーを1か所で定義し、すべてを整理された状態に保ちます。 - **[ワークフローエンジン](https://voltagent.dev/docs/workflows/overview/)**: カスタム制御フローをつなぎ合わせる代わりに、複数ステップの自動化を宣言的に記述します。 @@ -62,11 +58,10 @@ VoltAgentは、2つの補完的なツールを通じてAIエージェントを - **[LLM互換性](https://voltagent.dev/docs/getting-started/providers-models/)**: エージェントロジックを書き直さずに、設定を変更するだけでOpenAI、Anthropic、Googleなどのプロバイダー間を切り替えます。 - **[メモリ](https://voltagent.dev/docs/agents/memory/overview/)**: 永続的なメモリアダプターを接続して、エージェントが実行間で重要なコンテキストを記憶できるようにします。 - **[検索とRAG](https://voltagent.dev/docs/rag/overview/)**: データソースから事実を取得し、モデルが回答する前に応答を根拠づける(RAG)レトリーバーエージェントをプラグインします。 -- **[評価](https://voltagent.dev/docs/evals/overview/)**: ワークフローと並行してエージェント評価スイートを実行し、ガードレールをより速く提供します。 - -### VoltOps LLM可観測性プラットフォーム - -VoltAgentには、詳細な実行トレース、パフォーマンスメトリクス、ビジュアルダッシュボードでエージェントをリアルタイムで監視およびデバッグするための組み込みの[VoltOps](#voltopsによる組み込みllm可観測性) LLM可観測性が付属しています。エージェントが行うすべての決定を検査し、ツールの使用を追跡し、組み込みのOpenTelemetryベースの可観測性でワークフローを最適化します。 +- **[VoltAgentナレッジベース](https://voltagent.dev/docs/rag/voltagent/)**: ドキュメントの取り込み、チャンク化、埋め込み、検索のためのマネージドRAGサービスを使用します。 +- **[音声](https://voltagent.dev/docs/agents/voice/)**: OpenAI、ElevenLabs、またはカスタム音声プロバイダーでテキスト読み上げと音声認識機能を追加します。 +- **[ガードレール](https://voltagent.dev/docs/guardrails/overview/)**: 実行時にエージェントの入力または出力を傍受して検証し、コンテンツポリシーと安全ルールを適用します。 +- **[評価](https://voltagent.dev/docs/evals/overview/)**: ワークフローと並行してエージェント評価スイートを実行し、エージェントの動作を測定および改善します。 #### MCPサーバー (@voltagent/mcp-docs-server) @@ -154,7 +149,7 @@ Test your agents with VoltOps Console: https://console.voltagent.dev 4. チャットを開始:エージェント詳細ページで、右下のチャットアイコンをクリックしてチャットウィンドウを開きます。 5. メッセージを送信:「こんにちは」のようなメッセージを入力してEnterキーを押します。 -![VoltAgent VoltOps Platform Demo](https://github.com/user-attachments/assets/0adbec33-1373-4cf4-b67d-825f7baf1cb4) +[![VoltAgent Demo](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7)](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7) ### 最初のワークフローの実行 @@ -235,7 +230,7 @@ export const expenseApprovalWorkflow = createWorkflowChain({ VoltOpsコンソールから直接、事前構築された`expenseApprovalWorkflow`をテストできます: -![VoltOps Workflow Observability](https://github.com/user-attachments/assets/9b877c65-f095-407f-9237-d7879964c38a) +[![expense-approval](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18)](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18) 1. **ワークフローページに移動**:サーバーを起動した後、[ワークフローページ](https://console.voltagent.dev/workflows)に直接移動します。 2. **プロジェクトを選択**:プロジェクトセレクターを使用してプロジェクトを選択します(例:「my-agent-app」)。 @@ -251,9 +246,22 @@ VoltOpsコンソールから直接、事前構築された`expenseApprovalWorkfl ``` 5. **結果を表示**:実行後、各ステップの詳細なログを検査し、コンソールで直接最終出力を確認できます。 -## VoltOpsによる組み込みLLM可観測性 +## サンプル -VoltAgentには、エージェントをリアルタイムで監視、デバッグ、最適化するのに役立つ組み込みのLLM可観測性プラットフォームであるVoltOpsが付属しています。 +より多くのサンプルについては、[サンプルリポジトリ](https://github.com/VoltAgent/voltagent/tree/main/examples)をご覧ください。 + +- **[Airtableエージェント](https://voltagent.dev/examples/guides/airtable-agent)** - 新しいレコードに反応し、VoltOpsアクションでAirtableに更新を書き戻します。 +- **[Slackエージェント](https://voltagent.dev/examples/guides/slack-agent)** - チャンネルメッセージに応答し、VoltOps Slackアクションで返信します。 +- **[ChatGPTアプリとVoltAgent](https://voltagent.dev/examples/agents/chatgpt-app)** - VoltAgentをMCP経由でデプロイし、ChatGPTアプリに接続します。 +- **[WhatsApp注文エージェント](https://voltagent.dev/examples/agents/whatsapp-ai-agent)** - 自然な会話で食品注文を処理するWhatsAppチャットボットを構築します。([ソースコード](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp)) +- **[YouTubeからブログエージェント](https://voltagent.dev/examples/agents/youtube-blog-agent)** - MCPツールを使用したスーパーバイザーエージェントでYouTube動画をMarkdownブログ投稿に変換します。([ソースコード](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog)) +- **[AI広告生成エージェント](https://voltagent.dev/examples/agents/ai-instagram-ad-agent)** - BrowserBase StagehandとGoogle Gemini AIを使用してInstagram広告を生成します。([ソースコード](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator)) +- **[AIレシピ生成エージェント](https://voltagent.dev/examples/agents/recipe-generator)** - 材料と好みに基づいてパーソナライズされた料理提案を作成します。([ソースコード](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) | [ビデオ](https://youtu.be/KjV1c6AhlfY)) +- **[AI研究アシスタントエージェント](https://voltagent.dev/examples/agents/research-assistant)** - 包括的なレポートを生成するマルチエージェント研究ワークフロー。([ソースコード](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) | [ビデオ](https://youtu.be/j6KAUaoZMy4)) + +

VoltOpsコンソール:LLM可観測性 - 自動化 - デプロイ

+ +VoltOpsコンソールは、VoltAgentのプラットフォーム側であり、可観測性、自動化、デプロイを提供し、リアルタイムの実行トレース、パフォーマンスメトリクス、ビジュアルダッシュボードで本番環境のエージェントを監視およびデバッグできます。 🎬 [ライブデモを試す](https://console.voltagent.dev/demo) @@ -265,22 +273,17 @@ VoltAgentには、エージェントをリアルタイムで監視、デバッ 詳細なトレースとパフォーマンスメトリクスでエージェントの実行フローを深く掘り下げます。 -
- -![VoltOps Observability Overview](https://cdn.voltagent.dev/console/observability.png) +1 ### ダッシュボード すべてのエージェント、ワークフロー、システムパフォーマンスメトリクスの包括的な概要を取得します。 -
- -![VoltOps Dashboard](https://cdn.voltagent.dev/console/dashboard.png) +dashboar ### ログ すべてのエージェントインタラクションとワークフローステップの詳細な実行ログを追跡します。 -
![VoltOps Logs](https://cdn.voltagent.dev/console/logs.png) @@ -288,132 +291,63 @@ VoltAgentには、エージェントをリアルタイムで監視、デバッ エージェントのメモリ、コンテキスト、会話履歴を検査および管理します。 -
- ![VoltOps Memory Overview](https://cdn.voltagent.dev/console/memory.png) ### トレース エージェントの動作を理解し、パフォーマンスを最適化するために完全な実行トレースを分析します。 -
- ![VoltOps Traces](https://cdn.voltagent.dev/console/traces.png) ### プロンプトビルダー コンソールで直接プロンプトを設計、テスト、改良します。 -
- -![VoltOps Prompt Builder](https://cdn.voltagent.dev/console/prompt.png) - -## 例 - -完全なソースコードとビデオチュートリアルを備えたVoltAgentの実世界の実装を探索します。 - -より多くの例とユースケースについては、[例のリポジトリ](https://github.com/VoltAgent/voltagent/tree/main/examples)をご覧ください。 - -### WhatsApp注文エージェント - -自然な会話を通じて食品注文を処理し、データベースからメニュー項目を管理し、完全な会話コンテキストで注文を処理するWhatsAppチャットボットを構築します。 - -
- -whatsapp +prompts -
-
+### デプロイ -- 📖 [チュートリアル](https://voltagent.dev/examples/agents/whatsapp-ai-agent) -- 💻 [ソースコード](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp) +ワンクリックのGitHub統合とマネージドインフラストラクチャでエージェントを本番環境にデプロイします。 -### YouTube to ブログエージェント +deployment -MCPツール、共有ワーキングメモリ、VoltOps可観測性を備えたサブエージェントを調整するスーパーバイザーエージェントを使用して、YouTube動画をMarkdownブログ投稿に変換します。 +📖 [VoltOpsデプロイドキュメント](https://voltagent.dev/docs/deployment/voltops/) -
+### トリガーとアクション -youtube +ウェブフック、スケジュール、カスタムトリガーでエージェントワークフローを自動化し、外部イベントに反応します。 -
-
+triggers -- 📖 [チュートリアル](https://voltagent.dev/examples/agents/youtube-blog-agent) -- 💻 [ソースコード](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog) +### モニタリング -### AI広告生成エージェント +システム全体のエージェントの健全性、パフォーマンスメトリクス、リソース使用量を監視します。 -BrowserBase Stagehandを使用してランディングページを分析し、ブランドデータを抽出し、Google Gemini AIを通じてビジュアルを生成するInstagram広告ジェネレーターを実装します。 +monitoring -
+### ガードレール - -instagram - +エージェントが定義されたパラメーター内で動作するように、安全境界とコンテンツフィルターを設定します。 -
-
+guardrails -- 📖 [チュートリアル](https://voltagent.dev/examples/agents/ai-instagram-ad-agent) -- 💻 [ソースコード](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator) +### 評価 -### AIレシピ生成エージェント +ベンチマークに対してエージェントの動作、精度、パフォーマンスをテストする評価スイートを実行します。 -利用可能な材料、食事の好み、時間制約に基づいてパーソナライズされた料理提案を作成するインテリジェントなレシピ推奨システムを構築します。 +evals -
+### RAG(ナレッジベース) - -cook - - -
-
+組み込みの検索拡張生成機能でエージェントをナレッジソースに接続します。 -- 📖 [チュートリアル](https://voltagent.dev/examples/agents/recipe-generator) -- 📹 [ビデオを見る](https://youtu.be/KjV1c6AhlfY) -- 💻 [ソースコード](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) - -### AI研究アシスタントエージェント - -型安全なデータフローでトピックを研究し、包括的なレポートを生成するために、さまざまなAIエージェントが協力するマルチエージェント研究ワークフローを作成します。 - -
- - -research - - -
-
- -- 📖 [チュートリアル](https://voltagent.dev/examples/agents/research-assistant) -- 📹 [ビデオを見る](https://youtu.be/j6KAUaoZMy4) -- 💻 [ソースコード](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) - -## ユースケース - -さまざまな業界の実際のビジネスニーズに対応するAIエージェントを構築します: - -- **[HRエージェント](https://voltagent.dev/use-cases/hr-agent/)** - 採用、従業員のオンボーディング、HRサポートタスクを自動化します。 -- **[カスタマーサポートエージェント](https://voltagent.dev/use-cases/customer-support-agent/)** - 顧客の質問や問題を処理するサポートエージェントを構築します。 -- **[営業チーム](https://voltagent.dev/use-cases/sales-teams/)** - リードを検証し、顧客データを収集し、営業アウトリーチをパーソナライズします。 -- **[財務エージェント](https://voltagent.dev/use-cases/finance-agent/)** - 請求書を管理し、経費を追跡し、財務報告書を生成します。 -- **[開発エージェント](https://voltagent.dev/use-cases/development-agent/)** - コードをレビューし、デプロイを管理し、開発チームを支援します。 -- **[マーケティングエージェント](https://voltagent.dev/use-cases/marketing-agent/)** - キャンペーンを計画し、コンテンツを作成し、マーケティングパフォーマンスを分析します。 -- **[法務エージェント](https://voltagent.dev/use-cases/legal-agent/)** - 契約をレビューし、コンプライアンスを確認し、法的タスクを処理します。 -- **[保険エージェント](https://voltagent.dev/use-cases/insurance-agent/)** - 請求を処理し、リスクを評価し、ポリシーを管理します。 -- **[産業エージェント](https://voltagent.dev/use-cases/industrial-agent/)** - 機器を監視し、メンテナンスニーズを予測し、安全性を確保します。 -- **[教育エージェント](https://voltagent.dev/use-cases/education-agent/)** - パーソナライズされた指導を提供し、学生の進捗を追跡し、学習をサポートします。 -- **[政府エージェント](https://voltagent.dev/use-cases/government-agent/)** - 許可申請を処理し、給付金を処理し、市民にサービスを提供します。 -- **[ドキュメントエージェント](https://voltagent.dev/use-cases/documentation-agent/)** - APIドキュメントを作成し、変更ログを書き、コードからチュートリアルを生成します。 +rag ## VoltAgentを学ぶ -- 📖 **[インタラクティブチュートリアルから始める](https://voltagent.dev/tutorial/introduction/)**ことで、AIエージェント構築の基礎を学びます。 +- **[インタラクティブチュートリアルから始める](https://voltagent.dev/tutorial/introduction/)** ことで、AIエージェント構築の基礎を学びます。 - **[ドキュメント](https://voltagent.dev/docs/)**: ガイド、概念、チュートリアルを深く掘り下げます。 -- **[例](https://github.com/voltagent/voltagent/tree/main/examples)**: 実用的な実装を探索します。 +- **[サンプル](https://github.com/voltagent/voltagent/tree/main/examples)**: 実用的な実装を探索します。 - **[ブログ](https://voltagent.dev/blog/)**: 技術的な洞察とベストプラクティスについて詳しく読みます。 ## 貢献 @@ -426,10 +360,8 @@ BrowserBase Stagehandを使用してランディングページを分析し、 VoltAgentはコミュニティの努力であり、あなたのような人々のおかげで継続的に改善されています。 -![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=100) - -あなたのスターは、より多くの開発者にリーチするのに役立ちます!VoltAgentが役立つと思ったら、プロジェクトをサポートし、他の人が発見できるようにGitHubでスターを付けることを検討してください。 +![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=500&columns=20&anon=1) ## ライセンス -MITライセンスの下でライセンスされています、Copyright © 2025-present VoltAgent. +MITライセンスの下でライセンスされています、Copyright © 2026-present VoltAgent. diff --git a/i18n/README-kr.md b/i18n/README-kr.md index bc4cbf0f8..da30db6bb 100644 --- a/i18n/README-kr.md +++ b/i18n/README-kr.md @@ -1,10 +1,12 @@
-435380213-b6253409-8741-462b-a346-834cd18565a9 +voltagent -
-
+

+AI 에이전트 엔지니어링 플랫폼 +

+
English | 繁體中文 | 简体中文 | 日本語 | 한국어
@@ -22,7 +24,6 @@
-[![GitHub stars](https://img.shields.io/github/stars/voltagent/voltagent?style=social)](https://github.com/voltagent/voltagent) [![GitHub issues](https://img.shields.io/github/issues/voltagent/voltagent)](https://github.com/voltagent/voltagent/issues) [![GitHub pull requests](https://img.shields.io/github/issues-pr/voltagent/voltagent)](https://github.com/voltagent/voltagent/pulls) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) @@ -35,25 +36,20 @@
-
- -**VoltAgent**는 AI 에이전트를 구축하고 오케스트레이션하기 위한 오픈 소스 TypeScript 프레임워크입니다. -메모리, 워크플로, 도구, 그리고 내장된 LLM 관찰 가능성을 갖춘 프로덕션급 에이전트를 구축할 수 있습니다. - -## 왜 VoltAgent인가요? +

+⭐ 마음에 드시면 스타를 눌러주세요 ⬆️ +

-- **첫날부터 프로덕션 준비**: 인프라를 처음부터 구축하는 대신 내장 메모리, 워크플로, 관찰 가능성을 갖춘 에이전트를 배포하세요. -- **자신감 있게 코딩**: 전체 에이전트 시스템에서 타입 안전 도구, 자동 추론, 컴파일 타임 안전성을 갖춘 완전한 TypeScript 지원. -- **프로처럼 디버그**: 내장 VoltOps 관찰 가능성으로 모든 결정을 추적하고, 성능을 모니터링하며, 외부 도구 없이 실시간으로 워크플로를 최적화하세요. -- **복잡한 시스템을 간단하게 구축**: 프로토타입에서 프로덕션까지 확장되는 감독자 조정, 선언적 워크플로, 모듈식 아키텍처로 멀티 에이전트 팀을 오케스트레이션하세요. +VoltAgent는 두 가지 주요 부분으로 구성된 엔드투엔드 AI 에이전트 엔지니어링 플랫폼입니다: -## 에이전트 개발 플랫폼 +- **[오픈소스 TypeScript 프레임워크](#core-framework)** – 메모리, RAG, 가드레일, 도구, MCP, 음성, 워크플로 등. +- **[VoltOps 콘솔](#voltops-console)** `클라우드` `셀프 호스팅` – 관찰 가능성, 자동화, 배포, 평가, 가드레일, 프롬프트 등. -VoltAgent는 두 가지 보완적인 도구를 통해 AI 에이전트를 개발하고 모니터링하기 위한 완전한 플랫폼을 제공합니다. +완전한 코드 제어로 에이전트를 구축하고 프로덕션 준비된 가시성과 운영으로 출시하세요. -### 코어 프레임워크 +

코어 TypeScript 프레임워크

-코어 프레임워크를 사용하면 모든 AI 제공자에 연결하면서 메모리, 도구, 다단계 워크플로를 갖춘 지능형 에이전트를 구축할 수 있습니다. 전문화된 에이전트가 감독자 조정 하에 함께 작동하는 정교한 멀티 에이전트 시스템을 만드세요. +오픈소스 프레임워크를 사용하면 모든 AI 제공자에 연결하면서 메모리, 도구, 다단계 워크플로를 갖춘 지능형 에이전트를 구축할 수 있습니다. 전문화된 에이전트가 감독자 조정 하에 함께 작동하는 정교한 멀티 에이전트 시스템을 만드세요. - **[코어 런타임](https://voltagent.dev/docs/agents/overview/) (`@voltagent/core`)**: 타입이 지정된 역할, 도구, 메모리, 모델 제공자를 한 곳에 정의하여 모든 것을 체계적으로 유지하세요. - **[워크플로 엔진](https://voltagent.dev/docs/workflows/overview/)**: 커스텀 제어 흐름을 연결하는 대신 다단계 자동화를 선언적으로 설명하세요. @@ -62,11 +58,10 @@ VoltAgent는 두 가지 보완적인 도구를 통해 AI 에이전트를 개발 - **[LLM 호환성](https://voltagent.dev/docs/getting-started/providers-models/)**: 에이전트 로직을 다시 작성하지 않고 구성을 변경하여 OpenAI, Anthropic, Google 또는 다른 제공자 간 전환하세요. - **[메모리](https://voltagent.dev/docs/agents/memory/overview/)**: 내구성 있는 메모리 어댑터를 연결하여 에이전트가 실행 간 중요한 컨텍스트를 기억하도록 하세요. - **[검색 & RAG](https://voltagent.dev/docs/rag/overview/)**: 데이터 소스에서 사실을 가져오고 모델이 답변하기 전에 응답을 기반으로 하는(RAG) 검색기 에이전트를 연결하세요. -- **[평가](https://voltagent.dev/docs/evals/overview/)**: 워크플로와 함께 에이전트 평가 스위트를 실행하여 가드레일을 더 빠르게 제공하세요. - -### VoltOps LLM 관찰 가능성 플랫폼 - -VoltAgent는 상세한 실행 추적, 성능 메트릭, 시각적 대시보드로 에이전트를 실시간으로 모니터링하고 디버그하기 위한 내장 [VoltOps](#built-in-llm-observability-with-voltops) LLM 관찰 가능성과 함께 제공됩니다. 에이전트가 내리는 모든 결정을 검사하고, 도구 사용을 추적하며, 내장 OpenTelemetry 기반 관찰 가능성으로 워크플로를 최적화하세요. +- **[VoltAgent 지식 베이스](https://voltagent.dev/docs/rag/voltagent/)**: 문서 수집, 청킹, 임베딩, 검색을 위한 매니지드 RAG 서비스를 사용하세요. +- **[음성](https://voltagent.dev/docs/agents/voice/)**: OpenAI, ElevenLabs 또는 커스텀 음성 제공자로 텍스트 음성 변환 및 음성 텍스트 변환 기능을 추가하세요. +- **[가드레일](https://voltagent.dev/docs/guardrails/overview/)**: 런타임에 에이전트 입력 또는 출력을 가로채고 검증하여 콘텐츠 정책 및 안전 규칙을 적용하세요. +- **[평가](https://voltagent.dev/docs/evals/overview/)**: 워크플로와 함께 에이전트 평가 스위트를 실행하여 에이전트 동작을 측정하고 개선하세요. #### MCP 서버 (@voltagent/mcp-docs-server) @@ -154,7 +149,7 @@ Test your agents with VoltOps Console: https://console.voltagent.dev 4. 채팅 시작: 에이전트 세부정보 페이지에서 오른쪽 하단의 채팅 아이콘을 클릭하여 채팅 창을 엽니다. 5. 메시지 보내기: "안녕하세요"와 같은 메시지를 입력하고 Enter를 누르세요. -![VoltAgent VoltOps Platform Demo](https://github.com/user-attachments/assets/0adbec33-1373-4cf4-b67d-825f7baf1cb4) +[![VoltAgent Demo](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7)](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7) ### 첫 번째 워크플로 실행하기 @@ -235,7 +230,7 @@ export const expenseApprovalWorkflow = createWorkflowChain({ VoltOps 콘솔에서 직접 사전 구축된 `expenseApprovalWorkflow`를 테스트할 수 있습니다: -![VoltOps Workflow Observability](https://github.com/user-attachments/assets/9b877c65-f095-407f-9237-d7879964c38a) +[![expense-approval](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18)](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18) 1. **워크플로 페이지로 이동**: 서버를 시작한 후 [워크플로 페이지](https://console.voltagent.dev/workflows)로 직접 이동하세요. 2. **프로젝트 선택**: 프로젝트 선택기를 사용하여 프로젝트를 선택하세요(예: "my-agent-app"). @@ -251,9 +246,22 @@ VoltOps 콘솔에서 직접 사전 구축된 `expenseApprovalWorkflow`를 테스 ``` 5. **결과 보기**: 실행 후 각 단계에 대한 상세 로그를 검사하고 콘솔에서 직접 최종 출력을 볼 수 있습니다. -## VoltOps를 통한 내장 LLM 관찰 가능성 +## 예제 + +더 많은 예제는 [예제 리포지토리](https://github.com/VoltAgent/voltagent/tree/main/examples)를 방문하세요. + +- **[Airtable 에이전트](https://voltagent.dev/examples/guides/airtable-agent)** - 새 레코드에 반응하고 VoltOps 액션으로 Airtable에 업데이트를 작성합니다. +- **[Slack 에이전트](https://voltagent.dev/examples/guides/slack-agent)** - 채널 메시지에 응답하고 VoltOps Slack 액션으로 답장합니다. +- **[ChatGPT 앱과 VoltAgent](https://voltagent.dev/examples/agents/chatgpt-app)** - VoltAgent를 MCP를 통해 배포하고 ChatGPT 앱에 연결합니다. +- **[WhatsApp 주문 에이전트](https://voltagent.dev/examples/agents/whatsapp-ai-agent)** - 자연스러운 대화로 음식 주문을 처리하는 WhatsApp 챗봇을 구축합니다. ([소스 코드](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp)) +- **[YouTube to 블로그 에이전트](https://voltagent.dev/examples/agents/youtube-blog-agent)** - MCP 도구를 사용한 감독자 에이전트로 YouTube 비디오를 Markdown 블로그 게시물로 변환합니다. ([소스 코드](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog)) +- **[AI 광고 생성 에이전트](https://voltagent.dev/examples/agents/ai-instagram-ad-agent)** - BrowserBase Stagehand와 Google Gemini AI를 사용하여 Instagram 광고를 생성합니다. ([소스 코드](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator)) +- **[AI 레시피 생성 에이전트](https://voltagent.dev/examples/agents/recipe-generator)** - 재료와 선호도에 따라 개인화된 요리 제안을 만듭니다. ([소스 코드](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) | [비디오](https://youtu.be/KjV1c6AhlfY)) +- **[AI 연구 어시스턴트 에이전트](https://voltagent.dev/examples/agents/research-assistant)** - 포괄적인 보고서를 생성하는 멀티 에이전트 연구 워크플로. ([소스 코드](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) | [비디오](https://youtu.be/j6KAUaoZMy4)) + +

VoltOps 콘솔: LLM 관찰 가능성 - 자동화 - 배포

-VoltAgent는 에이전트를 실시간으로 모니터링, 디버그 및 최적화하는 데 도움이 되는 내장 LLM 관찰 가능성 플랫폼인 VoltOps와 함께 제공됩니다. +VoltOps 콘솔은 VoltAgent의 플랫폼 측면으로, 관찰 가능성, 자동화, 배포를 제공하여 실시간 실행 추적, 성능 메트릭, 시각적 대시보드로 프로덕션 에이전트를 모니터링하고 디버그할 수 있습니다. 🎬 [라이브 데모 체험](https://console.voltagent.dev/demo) @@ -265,22 +273,17 @@ VoltAgent는 에이전트를 실시간으로 모니터링, 디버그 및 최적 상세한 추적 및 성능 메트릭으로 에이전트 실행 흐름을 깊이 있게 살펴보세요. -
- -![VoltOps Observability Overview](https://cdn.voltagent.dev/console/observability.png) +1 ### 대시보드 모든 에이전트, 워크플로 및 시스템 성능 메트릭에 대한 포괄적인 개요를 얻으세요. -
- -![VoltOps Dashboard](https://cdn.voltagent.dev/console/dashboard.png) +dashboar ### 로그 모든 에이전트 상호작용 및 워크플로 단계에 대한 상세한 실행 로그를 추적하세요. -
![VoltOps Logs](https://cdn.voltagent.dev/console/logs.png) @@ -288,130 +291,61 @@ VoltAgent는 에이전트를 실시간으로 모니터링, 디버그 및 최적 에이전트 메모리, 컨텍스트 및 대화 기록을 검사하고 관리하세요. -
- ![VoltOps Memory Overview](https://cdn.voltagent.dev/console/memory.png) ### 추적 에이전트 동작을 이해하고 성능을 최적화하기 위해 완전한 실행 추적을 분석하세요. -
- ![VoltOps Traces](https://cdn.voltagent.dev/console/traces.png) ### 프롬프트 빌더 콘솔에서 직접 프롬프트를 설계, 테스트 및 개선하세요. -
- -![VoltOps Prompt Builder](https://cdn.voltagent.dev/console/prompt.png) - -## 예제 - -완전한 소스 코드 및 비디오 튜토리얼과 함께 VoltAgent의 실제 구현을 탐색하세요. - -더 많은 예제 및 사용 사례는 [예제 리포지토리](https://github.com/VoltAgent/voltagent/tree/main/examples)를 방문하세요. - -### WhatsApp 주문 에이전트 - -자연스러운 대화를 통해 음식 주문을 처리하고, 데이터베이스에서 메뉴 항목을 관리하며, 완전한 대화 컨텍스트로 주문을 처리하는 WhatsApp 챗봇을 구축하세요. - -
- -whatsapp - -
-
- -- 📖 [튜토리얼](https://voltagent.dev/examples/agents/whatsapp-ai-agent) -- 💻 [소스 코드](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp) - -### YouTube to 블로그 에이전트 - -MCP 도구, 공유 작업 메모리 및 VoltOps 관찰 가능성을 갖춘 서브 에이전트를 조정하는 감독자 에이전트를 사용하여 YouTube 비디오를 Markdown 블로그 게시물로 변환하세요. - -
- -youtube - -
-
- -- 📖 [튜토리얼](https://voltagent.dev/examples/agents/youtube-blog-agent) -- 💻 [소스 코드](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog) +prompts -### AI 광고 생성 에이전트 +### 배포 -BrowserBase Stagehand를 사용하여 랜딩 페이지를 분석하고, 브랜드 데이터를 추출하며, Google Gemini AI를 통해 비주얼을 생성하는 Instagram 광고 생성기를 구현하세요. +원클릭 GitHub 통합 및 매니지드 인프라로 에이전트를 프로덕션에 배포하세요. -
+deployment - -instagram - +📖 [VoltOps 배포 문서](https://voltagent.dev/docs/deployment/voltops/) -
-
+### 트리거 & 액션 -- 📖 [튜토리얼](https://voltagent.dev/examples/agents/ai-instagram-ad-agent) -- 💻 [소스 코드](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator) +웹훅, 스케줄, 커스텀 트리거로 에이전트 워크플로를 자동화하여 외부 이벤트에 반응하세요. -### AI 레시피 생성 에이전트 +triggers -사용 가능한 재료, 식단 선호도 및 시간 제약을 기반으로 개인화된 요리 제안을 생성하는 지능형 레시피 추천 시스템을 구축하세요. +### 모니터링 -
+전체 시스템에서 에이전트 상태, 성능 메트릭 및 리소스 사용량을 모니터링하세요. - -cook - +monitoring -
-
+### 가드레일 -- 📖 [튜토리얼](https://voltagent.dev/examples/agents/recipe-generator) -- 📹 [비디오 시청](https://youtu.be/KjV1c6AhlfY) -- 💻 [소스 코드](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) +에이전트가 정의된 매개변수 내에서 작동하도록 안전 경계 및 콘텐츠 필터를 설정하세요. -### AI 연구 어시스턴트 에이전트 +guardrails -타입 안전 데이터 흐름으로 주제를 연구하고 포괄적인 보고서를 생성하기 위해 다양한 AI 에이전트가 협업하는 멀티 에이전트 연구 워크플로를 생성하세요. +### 평가 -
+벤치마크에 대해 에이전트 동작, 정확도 및 성능을 테스트하는 평가 스위트를 실행하세요. - -research - +evals -
-
+### RAG (지식 베이스) -- 📖 [튜토리얼](https://voltagent.dev/examples/agents/research-assistant) -- 📹 [비디오 시청](https://youtu.be/j6KAUaoZMy4) -- 💻 [소스 코드](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) +내장된 검색 증강 생성 기능으로 에이전트를 지식 소스에 연결하세요. -## 사용 사례 - -다양한 산업 전반의 실제 비즈니스 요구 사항을 위한 AI 에이전트를 구축하세요: - -- **[HR 에이전트](https://voltagent.dev/use-cases/hr-agent/)** - 채용, 직원 온보딩 및 HR 지원 작업을 자동화합니다. -- **[고객 지원 에이전트](https://voltagent.dev/use-cases/customer-support-agent/)** - 고객 질문 및 문제를 처리하는 지원 에이전트를 구축합니다. -- **[영업 팀](https://voltagent.dev/use-cases/sales-teams/)** - 리드를 검증하고, 고객 데이터를 수집하며, 영업 아웃리치를 개인화합니다. -- **[재무 에이전트](https://voltagent.dev/use-cases/finance-agent/)** - 송장을 관리하고, 비용을 추적하며, 재무 보고서를 생성합니다. -- **[개발 에이전트](https://voltagent.dev/use-cases/development-agent/)** - 코드를 검토하고, 배포를 관리하며, 개발 팀을 지원합니다. -- **[마케팅 에이전트](https://voltagent.dev/use-cases/marketing-agent/)** - 캠페인을 계획하고, 콘텐츠를 생성하며, 마케팅 성과를 분석합니다. -- **[법률 에이전트](https://voltagent.dev/use-cases/legal-agent/)** - 계약을 검토하고, 규정 준수를 확인하며, 법률 작업을 처리합니다. -- **[보험 에이전트](https://voltagent.dev/use-cases/insurance-agent/)** - 청구를 처리하고, 위험을 평가하며, 정책을 관리합니다. -- **[산업 에이전트](https://voltagent.dev/use-cases/industrial-agent/)** - 장비를 모니터링하고, 유지 보수 필요를 예측하며, 안전을 보장합니다. -- **[교육 에이전트](https://voltagent.dev/use-cases/education-agent/)** - 개인화된 튜터링을 제공하고, 학생 진행 상황을 추적하며, 학습을 지원합니다. -- **[정부 에이전트](https://voltagent.dev/use-cases/government-agent/)** - 허가 신청을 처리하고, 혜택을 처리하며, 시민을 서비스합니다. -- **[문서화 에이전트](https://voltagent.dev/use-cases/documentation-agent/)** - API 문서를 생성하고, 변경 로그를 작성하며, 코드에서 튜토리얼을 생성합니다. +rag ## VoltAgent 학습하기 -- 📖 **[대화형 튜토리얼로 시작](https://voltagent.dev/tutorial/introduction/)**하여 AI 에이전트 구축의 기본을 배우세요. +- **[대화형 튜토리얼로 시작](https://voltagent.dev/tutorial/introduction/)**하여 AI 에이전트 구축의 기본을 배우세요. - **[문서](https://voltagent.dev/docs/)**: 가이드, 개념 및 튜토리얼을 깊이 있게 살펴보세요. - **[예제](https://github.com/voltagent/voltagent/tree/main/examples)**: 실용적인 구현을 탐색하세요. - **[블로그](https://voltagent.dev/blog/)**: 기술적 통찰력 및 모범 사례에 대해 더 읽어보세요. @@ -426,10 +360,8 @@ BrowserBase Stagehand를 사용하여 랜딩 페이지를 분석하고, 브랜 VoltAgent는 커뮤니티의 노력이며, 여러분과 같은 사람들 덕분에 계속해서 더 나아지고 있습니다. -![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=100) - -여러분의 스타는 더 많은 개발자에게 다가가는 데 도움이 됩니다! VoltAgent가 유용하다고 생각하신다면, 프로젝트를 지원하고 다른 사람들이 발견할 수 있도록 GitHub에서 스타를 주는 것을 고려해주세요. +![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=500&columns=20&anon=1) ## 라이선스 -MIT 라이선스 하에 라이선스가 부여됩니다, Copyright © 2025-present VoltAgent. +MIT 라이선스 하에 라이선스가 부여됩니다, Copyright © 2026-present VoltAgent. diff --git a/packages/core/README.md b/packages/core/README.md index 3381b72e5..4ef78b06f 100644 --- a/packages/core/README.md +++ b/packages/core/README.md @@ -1,86 +1,63 @@
-435380213-b6253409-8741-462b-a346-834cd18565a9 +voltagent -
-
+

+AI Agent Engineering Platform +


-
- VoltAgent is an open source TypeScript framework for building and orchestrating AI agents.
-Escape the limitations of no-code builders and the complexity of starting from scratch. -
-
-
-
-[![npm version](https://img.shields.io/npm/v/@voltagent/core.svg)](https://www.npmjs.com/package/@voltagent/core) +[![GitHub issues](https://img.shields.io/github/issues/voltagent/voltagent)](https://github.com/voltagent/voltagent/issues) +[![GitHub pull requests](https://img.shields.io/github/issues-pr/voltagent/voltagent)](https://github.com/voltagent/voltagent/pulls) +[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.0-4baaaa.svg)](CODE_OF_CONDUCT.md) +[![npm version](https://img.shields.io/npm/v/@voltagent/core.svg)](https://www.npmjs.com/package/@voltagent/core) + +[![npm downloads](https://img.shields.io/npm/dm/@voltagent/core.svg)](https://www.npmjs.com/package/@voltagent/core) [![Discord](https://img.shields.io/discord/1361559153780195478.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://s.voltagent.dev/discord) [![Twitter Follow](https://img.shields.io/twitter/follow/voltagent_dev?style=social)](https://twitter.com/voltagent_dev)
-
- -
- -flow - - -
- -## What is VoltAgent? - -> An **AI Agent Framework** provides the foundational structure and tools needed to build applications powered by autonomous agents. These agents, often driven by Large Language Models (LLMs), can perceive their environment, make decisions, and take actions to achieve specific goals. Building such agents from scratch involves managing complex interactions with LLMs, handling state, connecting to external tools and data, and orchestrating workflows. - -**VoltAgent** is an open-source TypeScript framework that acts as this essential toolkit. It simplifies the development of AI agent applications by providing modular building blocks, standardized patterns, and abstractions. Whether you're creating chatbots, virtual assistants, automated workflows, or complex multi-agent systems, VoltAgent handles the underlying complexity, allowing you to focus on defining your agents' capabilities and logic. +VoltAgent is an end-to-end AI Agent Engineering Platform that consists of two main parts: -Instead of building everything from scratch, VoltAgent provides ready-made, modular building blocks: +- **[Open-Source TypeScript Framework](#core-framework)** – Memory, RAG, Guardrails, Tools, MCP, Voice, Workflow, and more. +- **[VoltOps Console](#voltops-console)** `Cloud` `Self-Hosted` – Observability, Automation, Deployment, Evals, Guardrails, Prompts, and more. -- **Core Engine (`@voltagent/core`)**: The heart of VoltAgent, providing fundamental capabilities for your AI agents Define individual agents with specific roles, tools, and memory. -- **Multi-Agent Systems**: Architect complex applications by coordinating multiple specialized agents using Supervisors. -- **Workflow Engine**: Go beyond simple request-response. Orchestrate multi-step automations that can process data, call APIs, run tasks in parallel, and execute conditional logic. -- **Extensible Packages**: Enhance functionality with packages like `@voltagent/voice` for voice interactions. -- **Tooling & Integrations**: Equip agents with tools to connect to external APIs, databases, and services, enabling them to perform real-world tasks. **Supports the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) for standardized tool interactions.** -- **Data Retrieval & RAG**: Implement specialized retriever agents for efficient information fetching and **Retrieval-Augmented Generation (RAG)**. -- **Memory**: Enable agents to remember past interactions for more natural and context-aware conversations. -- **LLM Compatibility**: Works with popular AI models from OpenAI, Google, Anthropic, and more, allowing easy switching. -- **Developer Ecosystem**: Includes helpers like `create-voltagent-app`, `@voltagent/cli`, and the visual [VoltOps LLM Observability Platform](https://console.voltagent.dev) for quick setup, monitoring, and debugging. +Build agents with full code control and ship them with production-ready visibility and operations. -In essence, VoltAgent helps developers build sophisticated AI applications faster and more reliably, avoiding repetitive setup and the limitations of simpler tools. +

Core TypeScript Framework

-## Why VoltAgent? +With the open-source framework, you can build intelligent agents with memory, tools, and multi-step workflows while connecting to any AI provider. Create sophisticated multi-agent systems where specialized agents work together under supervisor coordination. -Building AI applications often involves a trade-off: +- **[Core Runtime](https://voltagent.dev/docs/agents/overview/) (`@voltagent/core`)**: Define agents with typed roles, tools, memory, and model providers in one place so everything stays organized. +- **[Workflow Engine](https://voltagent.dev/docs/workflows/overview/)**: Describe multi-step automations declaratively rather than stitching together custom control flow. +- **[Supervisors & Sub-Agents](https://voltagent.dev/docs/agents/sub-agents/)**: Run teams of specialized agents under a supervisor runtime that routes tasks and keeps them in sync. +- **[Tool Registry](https://voltagent.dev/docs/agents/tools/) & [MCP](https://voltagent.dev/docs/agents/mcp/)**: Ship Zod-typed tools with lifecycle hooks and cancellation, and connect to [Model Context Protocol](https://modelcontextprotocol.io/) servers without extra glue code. +- **[LLM Compatibility](https://voltagent.dev/docs/getting-started/providers-models/)**: Swap between OpenAI, Anthropic, Google, or other providers by changing config, not rewriting agent logic. +- **[Memory](https://voltagent.dev/docs/agents/memory/overview/)**: Attach durable memory adapters so agents remember important context across runs. +- **[Retrieval & RAG](https://voltagent.dev/docs/rag/overview/)**: Plug in retriever agents to pull facts from your data sources and ground responses (RAG) before the model answers. +- **[VoltAgent Knowledge Base](https://voltagent.dev/docs/rag/voltagent/)**: Use the managed RAG service for document ingestion, chunking, embeddings, and search. +- **[Voice](https://voltagent.dev/docs/agents/voice/)**: Add text-to-speech and speech-to-text capabilities with OpenAI, ElevenLabs, or custom voice providers. +- **[Guardrails](https://voltagent.dev/docs/guardrails/overview/)**: Intercept and validate agent input or output at runtime to enforce content policies and safety rules. +- **[Evals](https://voltagent.dev/docs/evals/overview/)**: Run agent eval suites alongside your workflows to measure and improve agent behavior. -1. **DIY Approach:** Using basic AI provider tools offers control but leads to complex, hard-to-manage code and repeated effort. -2. **No-Code Builders:** Simpler initially but often restrictive, limiting customization, provider choice, and complexity. +#### MCP Server (@voltagent/mcp-docs-server) -VoltAgent provides a middle ground, offering structure and components without sacrificing flexibility: +You can use the MCP server `@voltagent/mcp-docs-server` to teach your LLM how to use VoltAgent for AI-powered coding assistants like Claude, Cursor, or Windsurf. This allows AI assistants to access VoltAgent documentation, examples, and changelogs directly while you code. -- **Build Faster:** Accelerate development with pre-built components compared to starting from scratch. -- **Maintainable Code:** Encourages organization for easier updates and debugging. -- **Scalability:** Start simple and easily scale to complex, multi-agent systems handling intricate workflows. -- **Build Sophisticated Automations:** It's not just for chat. The workflow engine lets you build complex, multi-step processes for tasks like data analysis pipelines, automated content generation, or intelligent decision-making systems. -- **Flexibility:** Full control over agent behavior, LLM choice, tool integrations, and UI connections. -- **Avoid Lock-in:** Freedom to switch AI providers and models as needed. -- **Cost Efficiency:** Features designed to optimize AI service usage and reduce redundant calls. -- **Visual Monitoring:** Use the [VoltOps LLM Observability Platform](https://console.voltagent.dev) to track agent performance, inspect state, and debug visually. - -VoltAgent empowers developers to build their envisioned AI applications efficiently, from simple helpers to complex systems. +📖 [How to setup MCP docs server](https://voltagent.dev/docs/getting-started/mcp-docs-server/) ## ⚡ Quick Start @@ -162,13 +139,88 @@ Your agent is now running! To interact with it: 4. Start Chatting: On the agent detail page, click the chat icon in the bottom right corner to open the chat window. 5. Send a Message: Type a message like "Hello" and press Enter. -[![VoltAgent VoltOps Platform Demo](https://github.com/user-attachments/assets/0adbec33-1373-4cf4-b67d-825f7baf1cb4)](https://console.voltagent.dev/) +[![VoltAgent Demo](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7)](https://github.com/user-attachments/assets/26340c6a-be34-48a5-9006-e822bf6098a7) ### Running Your First Workflow -Your new project also includes a powerful workflow engine. You can test the pre-built `expenseApprovalWorkflow` directly from the VoltOps console: +Your new project also includes a powerful workflow engine. + +The expense approval workflow demonstrates human-in-the-loop automation with suspend/resume capabilities: + +```typescript +import { createWorkflowChain } from "@voltagent/core"; +import { z } from "zod"; + +export const expenseApprovalWorkflow = createWorkflowChain({ + id: "expense-approval", + name: "Expense Approval Workflow", + purpose: "Process expense reports with manager approval for high amounts", + + input: z.object({ + employeeId: z.string(), + amount: z.number(), + category: z.string(), + description: z.string(), + }), + result: z.object({ + status: z.enum(["approved", "rejected"]), + approvedBy: z.string(), + finalAmount: z.number(), + }), +}) + // Step 1: Validate expense and check if approval needed + .andThen({ + id: "check-approval-needed", + resumeSchema: z.object({ + approved: z.boolean(), + managerId: z.string(), + comments: z.string().optional(), + adjustedAmount: z.number().optional(), + }), + execute: async ({ data, suspend, resumeData }) => { + // If we're resuming with manager's decision + if (resumeData) { + return { + ...data, + approved: resumeData.approved, + approvedBy: resumeData.managerId, + finalAmount: resumeData.adjustedAmount || data.amount, + }; + } + + // Check if manager approval is needed (expenses over $500) + if (data.amount > 500) { + await suspend("Manager approval required", { + employeeId: data.employeeId, + requestedAmount: data.amount, + }); + } + + // Auto-approve small expenses + return { + ...data, + approved: true, + approvedBy: "system", + finalAmount: data.amount, + }; + }, + }) + // Step 2: Process the final decision + .andThen({ + id: "process-decision", + execute: async ({ data }) => { + return { + status: data.approved ? "approved" : "rejected", + approvedBy: data.approvedBy, + finalAmount: data.finalAmount, + }; + }, + }); +``` -![VoltOps Workflow Observability](https://github.com/user-attachments/assets/9b877c65-f095-407f-9237-d7879964c38a) +You can test the pre-built `expenseApprovalWorkflow` directly from the VoltOps console: + +[![expense-approval](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18)](https://github.com/user-attachments/assets/3d3ea67b-4ab5-4dc0-932d-cedd92894b18) 1. **Go to the Workflows Page:** After starting your server, go directly to the [Workflows page](https://console.voltagent.dev/workflows). 2. **Select Your Project:** Use the project selector to choose your project (e.g., "my-agent-app"). @@ -184,39 +236,106 @@ Your new project also includes a powerful workflow engine. You can test the pre- ``` 5. **View the Results:** After execution, you can inspect the detailed logs for each step and see the final output directly in the console. -## Key Features - -- **Agent Core:** Define agents with descriptions, LLM providers, tools, and memory management. -- **Workflow Engine:** Orchestrate complex, multi-step automations with a powerful and declarative API (`andThen`, `andAgent`, `andAll`, `andRace`, `andWhen`). -- **Multi-Agent Systems:** Build complex workflows using Supervisor Agents coordinating multiple specialized Sub-Agents. -- **Tool Usage & Lifecycle:** Equip agents with custom or pre-built tools (functions) with type-safety (Zod), lifecycle hooks, and cancellation support to interact with external systems. -- **Flexible LLM Support:** Integrate seamlessly with various LLM providers (OpenAI, Anthropic, Google, etc.) and easily switch between models. -- **Memory Management:** Enable agents to retain context across interactions using different configurable memory providers. -- **Observability & Debugging:** Visually monitor agent states, interactions, logs, and performance via the [VoltOps LLM Observability Platform](https://console.voltagent.dev). -- **Custom API Endpoints:** Extend the VoltAgent API server with your own custom endpoints to build specialized functionality on top of the core framework. -- **Voice Interaction:** Build voice-enabled agents capable of speech recognition and synthesis using the `@voltagent/voice` package. -- **Data Retrieval & RAG:** Integrate specialized retriever agents for efficient information fetching and **Retrieval-Augmented Generation (RAG)** from various sources. -- **Model Context Protocol (MCP) Support:** Connect to external tool servers (HTTP/stdio) adhering to the [MCP standard](https://modelcontextprotocol.io/) for extended capabilities. -- **Prompt Engineering Tools:** Leverage utilities like `createPrompt` for crafting and managing effective prompts for your agents. -- **Framework Compatibility:** Designed for easy integration into existing Node.js applications and popular frameworks. - -## Use Cases - -VoltAgent is versatile and can power a wide range of AI-driven applications: - -- **Complex Workflow Automation:** Orchestrate multi-step processes involving various tools, APIs, and decision points using coordinated agents. -- **Intelligent Data Pipelines:** Build agents that fetch, process, analyze, and transform data from diverse sources. -- **AI-Powered Internal Tools & Dashboards:** Create interactive internal applications that leverage AI for analysis, reporting, or task automation, often integrated with UIs using hooks. -- **Automated Customer Support Agents:** Develop sophisticated chatbots that can understand context (memory), use tools (e.g., check order status), and escalate complex issues. -- **Repository Analysis & Codebase Automation:** Analyze code repositories, automate refactoring tasks, generate documentation, or manage CI/CD processes. -- **Retrieval-Augmented Generation (RAG) Systems:** Build agents that retrieve relevant information from knowledge bases (using retriever agents) before generating informed responses. -- **Voice-Controlled Interfaces & Applications:** Utilize the `@voltagent/voice` package to create applications that respond to and generate spoken language. -- **Personalized User Experiences:** Develop agents that adapt responses and actions based on user history and preferences stored in memory. -- **Real-time Monitoring & Alerting:** Design agents that continuously monitor data streams or systems and trigger actions or notifications based on defined conditions. -- **And Virtually Anything Else...**: If you can imagine an AI agent doing it, VoltAgent can likely help you build it! ⚡ +## Examples + +For more examples, visit our [examples repository](https://github.com/VoltAgent/voltagent/tree/main/examples). + +- **[Airtable Agent](https://voltagent.dev/examples/guides/airtable-agent)** - React to new records and write updates back into Airtable with VoltOps actions. +- **[Slack Agent](https://voltagent.dev/examples/guides/slack-agent)** - Respond to channel messages and reply via VoltOps Slack actions. +- **[ChatGPT App With VoltAgent](https://voltagent.dev/examples/agents/chatgpt-app)** - Deploy VoltAgent over MCP and connect to ChatGPT Apps. +- **[WhatsApp Order Agent](https://voltagent.dev/examples/agents/whatsapp-ai-agent)** - Build a WhatsApp chatbot that handles food orders through natural conversation. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-whatsapp)) +- **[YouTube to Blog Agent](https://voltagent.dev/examples/agents/youtube-blog-agent)** - Convert YouTube videos into Markdown blog posts using a supervisor agent with MCP tools. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-youtube-to-blog)) +- **[AI Ads Generator Agent](https://voltagent.dev/examples/agents/ai-instagram-ad-agent)** - Generate Instagram ads using BrowserBase Stagehand and Google Gemini AI. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-ad-creator)) +- **[AI Recipe Generator Agent](https://voltagent.dev/examples/agents/recipe-generator)** - Create personalized cooking suggestions based on ingredients and preferences. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-recipe-generator) | [Video](https://youtu.be/KjV1c6AhlfY)) +- **[AI Research Assistant Agent](https://voltagent.dev/examples/agents/research-assistant)** - Multi-agent research workflow for generating comprehensive reports. ([Source](https://github.com/VoltAgent/voltagent/tree/main/examples/with-research-assistant) | [Video](https://youtu.be/j6KAUaoZMy4)) + +

VoltOps Console: LLM Observability - Automation - Deployment

+ +VoltOps Console is the platform side of VoltAgent, providing observability, automation, and deployment so you can monitor and debug agents in production with real-time execution traces, performance metrics, and visual dashboards. + +🎬 [Try Live Demo](https://console.voltagent.dev/demo) + +📖 [VoltOps Documentation](https://voltagent.dev/voltops-llm-observability-docs/) + +🚀 [VoltOps Platform](https://voltagent.dev/voltops-llm-observability/) + +### Observability & Tracing + +Deep dive into agent execution flow with detailed traces and performance metrics. + +1 + +### Dashboard + +Get a comprehensive overview of all your agents, workflows, and system performance metrics. + +dashboard + +### Logs + +Track detailed execution logs for every agent interaction and workflow step. + +![VoltOps Logs](https://cdn.voltagent.dev/console/logs.png) + +### Memory Management + +Inspect and manage agent memory, context, and conversation history. + +![VoltOps Memory Overview](https://cdn.voltagent.dev/console/memory.png) + +### Traces + +Analyze complete execution traces to understand agent behavior and optimize performance. + +![VoltOps Traces](https://cdn.voltagent.dev/console/traces.png) + +### Prompt Builder + +Design, test, and refine prompts directly in the console. + +prompts + +### Deployment + +Deploy your agents to production with one-click GitHub integration and managed infrastructure. + +deployment + +📖 [VoltOps Deploy Documentation](https://voltagent.dev/docs/deployment/voltops/) + +### Triggers & Actions + +Automate agent workflows with webhooks, schedules, and custom triggers to react to external events. + +triggers + +### Monitoring + +Monitor agent health, performance metrics, and resource usage across your entire system. + +monitoring + +### Guardrails + +Set up safety boundaries and content filters to ensure agents operate within defined parameters. + +guardrails + +### Evals + +Run evaluation suites to test agent behavior, accuracy, and performance against benchmarks. + +evals + +### RAG (Knowledge Base) + +Connect your agents to knowledge sources with built-in retrieval-augmented generation capabilities. + +rag ## Learning VoltAgent +- **[Start with interactive tutorial](https://voltagent.dev/tutorial/introduction/)** to learn the fundamentals building AI Agents. - **[Documentation](https://voltagent.dev/docs/)**: Dive into guides, concepts, and tutorials. - **[Examples](https://github.com/voltagent/voltagent/tree/main/examples)**: Explore practical implementations. - **[Blog](https://voltagent.dev/blog/)**: Read more about technical insights, and best practices. @@ -231,10 +350,8 @@ Big thanks to everyone who's been part of the VoltAgent journey, whether you've VoltAgent is a community effort, and it keeps getting better because of people like you. -![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent) - -Your stars help us reach more developers! If you find VoltAgent useful, please consider giving us a star on GitHub to support the project and help others discover it. +![Contributors](https://contrib.rocks/image?repo=voltagent/voltagent&max=500&columns=20&anon=1) ## License -Licensed under the MIT License, Copyright © 2025-present VoltAgent. +Licensed under the MIT License, Copyright © 2026-present VoltAgent. diff --git a/website/docs/agents/plan-agent.md b/website/docs/agents/plan-agent.md index 584fe1255..0a32a79f7 100644 --- a/website/docs/agents/plan-agent.md +++ b/website/docs/agents/plan-agent.md @@ -61,7 +61,7 @@ const agent = new PlanAgent({ tools: [internetSearch], }); -const result = await agent.generateText("What is LangGraph?"); +const result = await agent.generateText("What is VoltAgent?"); console.log(result.text); ```