Merge branch 'main' into feat/veafaas-a2a-mcp

Author: zakahan

docs/docs/veadk-studio.md

@@ -6,20 +6,56 @@ VeADK Studio是我们提供的一站式Agent开发平台，提供本地Agent优
 
 ## 前置准备
 
+首先安装如下依赖：
+
+```bash
+# 评测功能
+pip install "veadk-python[eval]"
+
+# prompt 优化
+pip install "veadk-python[cli]"
+```
+
 你需要在你的Agent项目中准备一个`agent.py`文件，导出`agent`和`short_term_memory`两个全局变量：
 
 ```python
-agent = ...
+from veadk import Agent
+from veadk.memory.short_term_memory import ShortTermMemory
+
+agent = Agent(...)
+
+short_term_memory = ShortTermMemory(...)
+```
 
-short_term_memory = ...
+此外，还需要在你的`config.yaml`中配置如下变量：
+
+```yaml
+# 基础模型运行
+model:
+  agent:
+    provider: openai
+    name: doubao-1-5-pro-256k-250115
+    api_base: https://ark.cn-beijing.volces.com/api/v3/
+    api_key: 
+  judge:  
+    name: doubao-1-5-pro-256k-250115
+    api_base: https://ark.cn-beijing.volces.com/api/v3/
+    api_key: 
+
+volcengine:
+  access_key: 
+  secret_key: 
+
+agent_pilot:
+  api_key: 
 ```
 
 ## 启动
 
 在你准备好的Agent项目目录下执行以下命令：
 
 ```bash
-veadk-studio
+veadk studio
 ```
 
 Studio将会自动加载你的`agent.py`文件，启动一个本地服务器。注意，服务地址与端口必须固定为`127.0.0.1:8000`。

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "veadk-python"
-version = "0.1.0"
+version = "0.2.0"
 description = "Volcengine agent development kit, integrations with Volcengine cloud services."
 readme = "README.md"
 requires-python = ">=3.10"

tests/test_tracing.py

@@ -14,6 +14,12 @@
 
 
 import pytest
+from opentelemetry import trace as trace_api
+from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import (
+    OTLPSpanExporter,
+)
+from opentelemetry.sdk import trace as trace_sdk
+from opentelemetry.sdk.trace.export import BatchSpanProcessor
 
 from veadk.tracing.telemetry.exporters.apmplus_exporter import (
     APMPlusExporter,
@@ -29,12 +35,6 @@
 )
 from veadk.tracing.telemetry.opentelemetry_tracer import OpentelemetryTracer
 
-from opentelemetry import trace as trace_api
-from opentelemetry.sdk import trace as trace_sdk
-from opentelemetry.sdk.trace.export import BatchSpanProcessor
-from opentelemetry.exporter.otlp.proto.grpc.trace_exporter import (
-    OTLPSpanExporter,
-)
 
 APP_NAME = "app"
 USER_ID = "testuser"

veadk/tracing/telemetry/opentelemetry_tracer.py

@@ -19,12 +19,11 @@
 from typing import Any
 
 from openinference.instrumentation.google_adk import GoogleADKInstrumentor
-from opentelemetry.sdk import trace as trace_sdk
 from opentelemetry import trace as trace_api
+from opentelemetry.sdk import trace as trace_sdk
 from opentelemetry.sdk.resources import Resource
 from opentelemetry.sdk.trace import TracerProvider
 from opentelemetry.sdk.trace.export import BatchSpanProcessor, SimpleSpanProcessor
-
 from pydantic import BaseModel, ConfigDict, Field
 from typing_extensions import override
 

veadk/version.py

@@ -12,4 +12,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
-VERSION = "0.1.0"
+VERSION = "0.2.0"