ni.agentkit 0.7.0__tar.gz → 0.7.2__tar.gz

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ni.agentkit
-Version: 0.7.0
+Version: 0.7.2
 Summary: A Python-native Agent framework with first-class Skill support and multi-LLM adapter
 Author-email: Krix Tam <krix.tam@qq.com>
 License: MIT
@@ -31,8 +31,6 @@ Provides-Extra: google
 Requires-Dist: google-genai>=1.0.0; extra == "google"
 Provides-Extra: memory
 Requires-Dist: mem0ai>=0.1.0; extra == "memory"
-Provides-Extra: docker
-Requires-Dist: docker>=7.0.0; extra == "docker"
 Provides-Extra: all
 Requires-Dist: openai>=1.0.0; extra == "all"
 Requires-Dist: anthropic>=0.30.0; extra == "all"
@@ -71,7 +69,6 @@ pip install "ni.agentkit[openai]"
 pip install "ni.agentkit[anthropic]"
 pip install "ni.agentkit[google]"
 pip install "ni.agentkit[memory]"
-pip install "ni.agentkit[docker]"
 pip install "ni.agentkit[all]"
 ```
 
@@ -119,7 +116,7 @@ print(agentkit.get_examples_dir()) # 示例目录路径
 
 ## 🧪 示例
 
-安装包内含 36 个可运行示例（标准版 × 18 + Ollama 本地版 × 18）：
+安装包内含可运行示例（标准版 24 个 + Ollama 本地版 26 个）：
 
 ```bash
 # Ollama 本地版（无需 API Key）
@@ -153,8 +150,8 @@ python "$(python -c "import agentkit, os; print(os.path.join(agentkit.get_exampl
 
 ```bash
 dist/
-├── ni_agentkit-0.7.0-py3-none-any.whl   # pip install 用这个
-└── ni_agentkit-0.7.0.tar.gz             # 源码分发
+├── ni_agentkit-0.7.2-py3-none-any.whl   # pip install 用这个
+└── ni_agentkit-0.7.2.tar.gz             # 源码分发
 ```
 
 ## 📄 License

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/README.md

@@ -29,7 +29,6 @@ pip install "ni.agentkit[openai]"
 pip install "ni.agentkit[anthropic]"
 pip install "ni.agentkit[google]"
 pip install "ni.agentkit[memory]"
-pip install "ni.agentkit[docker]"
 pip install "ni.agentkit[all]"
 ```
 
@@ -77,7 +76,7 @@ print(agentkit.get_examples_dir()) # 示例目录路径
 
 ## 🧪 示例
 
-安装包内含 36 个可运行示例（标准版 × 18 + Ollama 本地版 × 18）：
+安装包内含可运行示例（标准版 24 个 + Ollama 本地版 26 个）：
 
 ```bash
 # Ollama 本地版（无需 API Key）
@@ -111,8 +110,8 @@ python "$(python -c "import agentkit, os; print(os.path.join(agentkit.get_exampl
 
 ```bash
 dist/
-├── ni_agentkit-0.7.0-py3-none-any.whl   # pip install 用这个
-└── ni_agentkit-0.7.0.tar.gz             # 源码分发
+├── ni_agentkit-0.7.2-py3-none-any.whl   # pip install 用这个
+└── ni_agentkit-0.7.2.tar.gz             # 源码分发
 ```
 
 ## 📄 License

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/__init__.py

@@ -31,7 +31,7 @@ from .tools.function_tool import FunctionTool, function_tool
 from .tools.structured_data import ResultFormatter, StructuredDataTool
 from .tools.sqlite_tool import SQLiteTool, SQLiteResultFormatter
 
-__version__ = "0.7.0"
+__version__ = "0.7.2"
 
 
 def get_docs_dir() -> str:

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/docs/Architecture.md

@@ -620,8 +620,8 @@ agentkit/
 │   └── schema.py            #   函数签名 → JSON Schema
 │
 ├── examples/                # 示例
-│   ├── standard/            #   标准版示例（01-18，含 8A/8B/8C、9A/9B/9C）
-│   ├── ollama/              #   Ollama 版示例（01-19，含 8A/8B/8C、9A/9B/9C）
+│   ├── standard/            #   标准版示例（24 个：01-18 + 03B，含 8A/8B/8C、9A/9B/9C）
+│   ├── ollama/              #   Ollama 版示例（26 个：01-19 + 03B + 05_human_in_the_loop，含 8A/8B/8C、9A/9B/9C）
 │   ├── quickstart.py
 │   └── test_ollama.py
 │

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/docs/QuickStart.md

@@ -308,6 +308,66 @@ agent = Agent(
 )
 ```
 
+### 方式 C：通过 `SKILL.md` 的 `tools.entry` 动态注册工具
+
+当 Skill 需要自带工具实现时，可以在 `tools` 字段中声明 `entry`。Skill 激活后，AgentKit 会按 `entry` 自动发现并注册工具。
+
+Skill 目录结构：
+
+```text
+skills/weather-tools-entry/
+├── SKILL.md
+└── tools/
+    └── weather_tools.py
+```
+
+`SKILL.md`（关键片段）：
+
+```yaml
+---
+name: weather-tools-entry
+description: 通过 SKILL.md 的 tools.entry 动态注册天气查询工具
+tools:
+  - name: weather_lookup
+    description: 查询城市天气并给出简要信息
+    entry: tools/weather_tools.py:weather_lookup
+    parameters:
+      city: { type: string, description: "城市名称，如北京/上海/深圳" }
+---
+```
+
+`tools/weather_tools.py`：
+
+```python
+def weather_lookup(city: str) -> str:
+    data = {"北京": "晴，25°C", "深圳": "阵雨，28°C"}
+    return data.get(city, f"{city}：暂无数据")
+```
+
+加载并使用（无需手动把 `weather_lookup` 放入 `Agent.tools`）：
+
+```python
+from pathlib import Path
+from agentkit import Agent, Runner, load_skill_from_dir
+
+skill_dir = Path("./skills/weather-tools-entry")
+skill = load_skill_from_dir(skill_dir)
+
+agent = Agent(
+    name="skill-tools-entry-agent",
+    instructions="你是天气助手。遇到天气问题优先加载并使用 weather-tools-entry Skill。",
+    model="ollama/qwen3.5:cloud",
+    skills=[skill],
+)
+
+result = Runner.run_sync(agent, input="深圳今天适合穿什么？")
+print(result.final_output)
+```
+
+> 可运行示例：
+> - `examples/standard/03b_skill_tools_entry.py`
+> - `examples/ollama/03b_skill_tools_entry.py`
+
 ### Skill 三级加载机制
 
 AgentKit 的 Skill 采用三级渐进式加载，避免浪费 token：
@@ -1234,10 +1294,12 @@ agent = Agent(name="assistant", instructions="...")
 | [`01_basic_chat.py`](../examples/standard/01_basic_chat.py) | 示例 1：最简 Agent |
 | [`02_tool_calling.py`](../examples/standard/02_tool_calling.py) | 示例 2：工具调用 |
 | [`03_skill_usage.py`](../examples/standard/03_skill_usage.py) | 示例 3：Skill 使用 |
+| [`03b_skill_tools_entry.py`](../examples/standard/03b_skill_tools_entry.py) | 示例 3B：Skill tools.entry 动态注册/发现 |
 | [`04_multi_agent.py`](../examples/standard/04_multi_agent.py) | 示例 4：多 Agent 协作 |
 | [`05_guardrail.py`](../examples/standard/05_guardrail.py) | 示例 5：安全护栏 |
 | [`06_orchestration.py`](../examples/standard/06_orchestration.py) | 示例 6：编排 Agent |
 | [`07_sync_async_stream.py`](../examples/standard/07_sync_async_stream.py) | 示例 7：同步/异步/流式运行 |
+| [`08_memory.py`](../examples/standard/08_memory.py) | 示例 8：记忆系统（综合） |
 | [`08a_memory_simple_provider.py`](../examples/standard/08a_memory_simple_provider.py) | 示例 8A：记忆系统（SimpleMemory） |
 | [`08b_memory_mem0_provider.py`](../examples/standard/08b_memory_mem0_provider.py) | 示例 8B：记忆系统（Mem0Provider） |
 | [`08c_memory_file_provider.py`](../examples/standard/08c_memory_file_provider.py) | 示例 8C：记忆系统（文件持久化） |
@@ -1261,10 +1323,13 @@ agent = Agent(name="assistant", instructions="...")
 | [`01_basic_chat.py`](../examples/ollama/01_basic_chat.py) | 示例 1：最简 Agent |
 | [`02_tool_calling.py`](../examples/ollama/02_tool_calling.py) | 示例 2：工具调用 |
 | [`03_skill_usage.py`](../examples/ollama/03_skill_usage.py) | 示例 3：Skill 使用 |
+| [`03b_skill_tools_entry.py`](../examples/ollama/03b_skill_tools_entry.py) | 示例 3B：Skill tools.entry 动态注册/发现 |
 | [`04_multi_agent.py`](../examples/ollama/04_multi_agent.py) | 示例 4：多 Agent 协作 |
 | [`05_guardrail.py`](../examples/ollama/05_guardrail.py) | 示例 5：安全护栏 |
+| [`05_human_in_the_loop.py`](../examples/ollama/05_human_in_the_loop.py) | 扩展示例：HITL 工具触发（Playground） |
 | [`06_orchestration.py`](../examples/ollama/06_orchestration.py) | 示例 6：编排 Agent |
 | [`07_sync_async_stream.py`](../examples/ollama/07_sync_async_stream.py) | 示例 7：同步/异步/流式运行 |
+| [`08_memory.py`](../examples/ollama/08_memory.py) | 示例 8：记忆系统（综合） |
 | [`08a_memory_simple_provider.py`](../examples/ollama/08a_memory_simple_provider.py) | 示例 8A：记忆系统（SimpleMemory） |
 | [`08b_memory_mem0_provider.py`](../examples/ollama/08b_memory_mem0_provider.py) | 示例 8B：记忆系统（Mem0Provider） |
 | [`08c_memory_file_provider.py`](../examples/ollama/08c_memory_file_provider.py) | 示例 8C：记忆系统（文件持久化） |
@@ -1280,6 +1345,7 @@ agent = Agent(name="assistant", instructions="...")
 | [`16_lifecycle_hooks.py`](../examples/ollama/16_lifecycle_hooks.py) | 示例 16：生命周期 Hooks 与 Callbacks |
 | [`17_checkpoint_handoff_resume.py`](../examples/ollama/17_checkpoint_handoff_resume.py) | 示例 17：Checkpoint 深度恢复（Handoff + Resume） |
 | [`18_model_cosplay.py`](../examples/ollama/18_model_cosplay.py) | 示例 18：ModelCosplay（运行时改写预设模型） |
+| [`19_hitl_deterministic.py`](../examples/ollama/19_hitl_deterministic.py) | 示例 19：HITL 确定性触发 |
 
 ---
 

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/docs/README.md

@@ -3,7 +3,7 @@
 > Python 原生的 Agent 开发框架，内置一等公民级别的 Skill 支持和自研多模型适配层。
 
 [![Python](https://img.shields.io/badge/Python-≥3.11-blue.svg)](https://python.org)
-[![Version](https://img.shields.io/badge/Version-0.7.0-green.svg)]()
+[![Version](https://img.shields.io/badge/Version-0.7.2-green.svg)]()
 [![License](https://img.shields.io/badge/License-MIT-yellow.svg)]()
 
 ---
@@ -35,7 +35,6 @@ pip install "ni.agentkit[openai]"    # OpenAI + 国内兼容厂商
 pip install "ni.agentkit[anthropic]" # Anthropic Claude
 pip install "ni.agentkit[google]"    # Google Gemini
 pip install "ni.agentkit[memory]"    # 记忆系统 (mem0)
-pip install "ni.agentkit[docker]"    # 预留：SandboxExecutor Docker 扩展依赖
 pip install "ni.agentkit[all]"       # 安装所有可选依赖
 ```
 

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/docs/Reference.md

@@ -505,7 +505,7 @@ from agentkit import Skill, SkillFrontmatter, SkillResources
 | `on_load_hook` | `Callable \| None` | **生命周期钩子**：在 Agent 执行前加载资源 |
 | `on_unload_hook` | `Callable \| None` | **生命周期钩子**：在 Agent 执行后释放资源 |
 
-**便捷属性**：`skill.name`、`skill.description`、`skill.additional_tools`、`skill.llm_config`
+**便捷属性**：`skill.name`、`skill.description`、`skill.additional_tools`、`skill.triggers`、`skill.dependencies`、`skill.tools`、`skill.tool_specs`、`skill.llm_config`
 
 ---
 
@@ -516,7 +516,20 @@ from agentkit import Skill, SkillFrontmatter, SkillResources
 | `name` | `str` | kebab-case 标识符（≤64 字符） |
 | `description` | `str` | 描述（≤1024 字符） |
 | `license` | `str \| None` | 许可证 |
-| `metadata` | `dict` | 扩展元数据，可含 `additional_tools` 和 `llm_config` |
+| `compatibility` | `str \| None` | 可选兼容性标记（版本/平台约束） |
+| `triggers` | `list[str]` | 触发关键词列表，用于描述 Skill 的适用场景 |
+| `dependencies` | `list[str]` | Skill 运行依赖声明（如三方包/外部能力） |
+| `tools` | `list[SkillToolSpec]` | Skill 声明的工具列表；支持字符串简写和对象写法，最终归一化为 `SkillToolSpec` |
+| `metadata` | `dict` | 扩展元数据，可含 `additional_tools`（兼容旧写法）和 `llm_config` |
+
+`SkillToolSpec` 字段：
+
+| 字段 | 类型 | 说明 |
+|------|------|------|
+| `name` | `str` | 工具名称（必填） |
+| `description` | `str \| None` | 工具描述 |
+| `entry` | `str \| None` | 动态加载入口，格式 `module:attr` 或相对 Skill 目录的 `path.py:attr` |
+| `parameters` | `dict[str, Any]` | 参数 Schema 片段，用于构建工具 JSON Schema |
 
 ---
 

ni_agentkit-0.7.2/docs/TestReport.md

@@ -0,0 +1,61 @@
+# AgentKit 示例测试报告
+
+> 测试时间：`2026-05-05`  
+> 测试环境：`macOS (Apple Silicon)`  
+> 模型：`qwen/qwen3.5-flash` (DashScope)  
+> AgentKit 版本：v0.7.2  
+> Thinking 模式：开启（默认）  
+> LLM 调用模式：非流式（默认）  
+> 缓存：开启（默认）  
+> 执行脚本：`examples/test_standard.py`
+
+---
+
+## 测试结果
+
+| # | 示例 | 文件 | 耗时 | 状态 | 说明 |
+|---|------|------|-----:|:----:|------|
+| 1 | 基础对话 | `01_basic_chat.py` | 11.89s | ✅ | 运行通过 |
+| 2 | 工具调用 | `02_tool_calling.py` | 5.47s | ✅ | 运行通过 |
+| 3 | Skill 使用 | `03_skill_usage.py` | 8.80s | ✅ | 运行通过 |
+| 3B | Skill tools.entry 动态注册/发现 | `03b_skill_tools_entry.py` | 5.83s | ✅ | 运行通过 |
+| 4 | 多 Agent 协作 | `04_multi_agent.py` | 34.73s | ✅ | 运行通过 |
+| 5 | 安全护栏 | `05_guardrail.py` | 4.80s | ✅ | 运行通过 |
+| 6 | 编排 Agent | `06_orchestration.py` | 84.79s | ✅ | 运行通过 |
+| 7 | 同步/异步/流式 | `07_sync_async_stream.py` | 5.88s | ✅ | 运行通过 |
+| 8 | 记忆系统（综合） | `08_memory.py` | 77.63s | ✅ | 运行通过 |
+| 8A | SimpleMemory | `08a_memory_simple_provider.py` | 13.58s | ✅ | 运行通过 |
+| 8B | Mem0Provider | `08b_memory_mem0_provider.py` | 0.21s | ✅ | 未配置 OPENAI_API_KEY，自动跳过 |
+| 8C | 文件持久化 Memory | `08c_memory_file_provider.py` | 19.65s | ✅ | 运行通过 |
+| 9A | 结构化数据（SQL） | `09a_structured_data_sql.py` | 2.41s | ✅ | 运行通过 |
+| 9B | 结构化数据（图） | `09b_structured_data_graph.py` | 2.48s | ✅ | 运行通过 |
+| 9C | NebulaGraphTool（直调） | `09c_nebula_graph_tool.py` | 0.32s | ✅ | 运行通过 |
+| 10 | Skill 生命周期 | `10_skill_lifecycle.py` | 1.53s | ✅ | 运行通过 |
+| 11 | 编排增强 | `11_orchestration_enhancement.py` | 17.11s | ✅ | 运行通过 |
+| 12 | 序列化协议 | `12_run_context_serialization.py` | 0.31s | ✅ | 运行通过 |
+| 13 | Human in the Loop | `13_human_in_the_loop.py` | 4.39s | ✅ | 运行通过 |
+| 14 | Event 标准化 | `14_event_standardization.py` | 5.13s | ✅ | 运行通过 |
+| 15 | 多租户隔离 | `15_multi_tenant_isolation.py` | 4.58s | ✅ | 运行通过 |
+| 16 | 生命周期 Hooks | `16_lifecycle_hooks.py` | 4.74s | ✅ | 运行通过 |
+| 17 | Checkpoint + Handoff + Resume | `17_checkpoint_handoff_resume.py` | 0.17s | ✅ | 运行通过 |
+| 18 | ModelCosplay | `18_model_cosplay.py` | 0.18s | ✅ | 运行通过 |
+| | **合计** | | **316.61s** | **24/24** | |
+
+## 耗时分析
+
+- **最快示例**：17 Checkpoint + Handoff + Resume (0.17s)
+- **最慢示例**：06 编排 Agent (84.79s)
+- **性能改进**：相比 Ollama 运行，DashScope 接口响应更快，且在大规模编排和记忆检索场景下稳定性更好。
+
+## 已知问题
+
+| 问题 | 严重程度 | 说明 |
+|------|:--------:|------|
+| 运行异常 | - | 无，24 个示例全部通过 |
+
+## 运行方式
+
+```bash
+# 在 agentkit 目录执行
+python examples/test_standard.py
+```

ni_agentkit-0.7.2/examples/Skill.md

@@ -0,0 +1,41 @@
+---
+name: "skill_name"
+version: "1.0.0"
+description: "一句话说明技能用途"
+author: "your_name"
+license: "MIT"
+triggers:
+  - "触发词1"
+  - "触发词2"
+dependencies:
+  - package1>=1.0
+  - package2
+tools:
+  - name: "tool_name"
+    description: "工具功能简述"
+    entry: "tools/tool_module.py:tool_function"
+    parameters:
+      param1: { type: string, description: "参数说明" }
+      param2: { type: integer, default: 10, description: "可选参数" }
+metadata:
+  additional_tools:
+    - "extra_tool_name"
+  sandbox_required: true
+  timeout: 30
+---
+
+# 🛠️ 技能名称
+
+## 🎯 能力边界
+- ✅ 支持：...
+- ❌ 不支持：...
+- ⚠️ 限制：...
+
+## 💡 调用示例
+**用户**: "请执行 XX 操作"
+**Agent**:
+```json
+{
+  "tool": "tool_name",
+  "arguments": { "param1": "value", "param2": 5 }
+}

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/examples/ollama/01_basic_chat.py

@@ -12,12 +12,13 @@ import sys, os
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", ".."))
 
 from agentkit import Agent, Runner
+from model_config import resolve_model
 
 # 创建最简 Agent —— 使用本地 Ollama 模型
 agent = Agent(
     name="assistant",
     instructions="你是一个有帮助的中文助手。回答尽量简洁。",
-    model="ollama/qwen3.5:cloud",      # 本地 Ollama 模型，无需 API Key
+    model=resolve_model("qwen3.5:cloud"),      # 本地 Ollama 模型，无需 API Key
 )
 
 # 同步运行

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/examples/ollama/02_tool_calling.py

@@ -14,7 +14,7 @@ import sys, os
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", ".."))
 
 from agentkit import Agent, Runner, function_tool
-
+from model_config import resolve_model
 
 # ===== 定义工具 =====
 
@@ -38,17 +38,15 @@ def get_weather(city: str) -> str:
     }
     return weather_data.get(city, f"{city}：暂无数据")
 
-
 # ===== 创建 Agent =====
 
 agent = Agent(
     name="smart-assistant",
     instructions="你是一个全能助手。可以做数学计算和查天气。根据用户需求选择合适的工具。回答简洁。",
-    model="ollama/qwen3.5:cloud",
+    model=resolve_model("qwen3.5:cloud"),
     tools=[add, multiply, get_weather],
 )
 
-
 # ===== 运行测试 =====
 
 queries = [

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/examples/ollama/03_skill_usage.py

@@ -14,7 +14,7 @@ import sys, os
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", ".."))
 
 from agentkit import Agent, Runner, Skill, SkillFrontmatter, function_tool
-
+from model_config import resolve_model
 
 # ===== 定义工具 =====
 
@@ -30,7 +30,6 @@ def get_weather(city: str) -> str:
     }
     return weather_data.get(city, f"{city}：暂无数据")
 
-
 # ===== 定义 Skill =====
 
 weather_skill = Skill(
@@ -49,18 +48,16 @@ weather_skill = Skill(
 4. 用简洁的中文回复用户""",
 )
 
-
 # ===== 创建带 Skill 的 Agent =====
 
 agent = Agent(
     name="skill-agent",
     instructions="你是一个智能助手，可以使用专业技能来完成任务。",
-    model="ollama/qwen3.5:cloud",
+    model=resolve_model("qwen3.5:cloud"),
     skills=[weather_skill],
     tools=[get_weather],
 )
 
-
 # ===== 运行测试 =====
 
 queries = [

ni_agentkit-0.7.2/examples/ollama/03b_skill_tools_entry.py

@@ -0,0 +1,45 @@
+"""
+示例 3B：SKILL.md tools.entry 动态工具注册/发现（Ollama 版）
+
+运行前请确保：
+  ollama serve
+  ollama pull qwen3.5:cloud
+
+运行：
+  python examples/ollama/03b_skill_tools_entry.py
+"""
+import os
+import sys
+from pathlib import Path
+
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", ".."))
+
+from agentkit import Agent, Runner, load_skill_from_dir
+from model_config import resolve_model
+
+skill_dir = Path(__file__).resolve().parents[1] / "skills" / "weather-tools-entry"
+weather_skill = load_skill_from_dir(skill_dir)
+
+agent = Agent(
+    name="skill-tools-entry-agent",
+    instructions="你是天气助手。遇到天气问题优先加载并使用 weather-tools-entry Skill。",
+    model=resolve_model(),
+    skills=[weather_skill],
+)
+
+queries = [
+    "深圳今天适合穿什么？",
+    "广州今天需要带伞吗？",
+]
+
+for q in queries:
+    print(f"\n用户: {q}")
+    result = Runner.run_sync(agent, input=q)
+    if result.success:
+        print(f"助手: {result.final_output}")
+    else:
+        print(f"❌ 错误: {result.error}")
+
+    for event in result.events:
+        if event.type == "tool_result":
+            print(f"  🔧 {event.data.get('tool')}: {event.data.get('result')}")

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/examples/ollama/04_multi_agent.py

@@ -14,7 +14,7 @@ import sys, os
 sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", ".."))
 
 from agentkit import Agent, Runner
-
+from model_config import resolve_model
 
 # ============================================================
 # 模式 A：as_tool（委派）
@@ -27,13 +27,13 @@ print("=" * 50)
 researcher = Agent(
     name="researcher",
     instructions="你是一个研究助手。收到问题后，给出简短的研究结论（不超过 3 句话）。",
-    model="ollama/qwen3.5:cloud",
+    model=resolve_model("qwen3.5:cloud"),
 )
 
 manager = Agent(
     name="manager",
     instructions="你是项目经理。需要研究信息时调用 research 工具。综合研究结果给出你的建议。",
-    model="ollama/qwen3.5:cloud",
+    model=resolve_model("qwen3.5:cloud"),
     tools=[
         researcher.as_tool("research", "调用研究助手获取研究信息"),
     ],
@@ -49,7 +49,6 @@ for event in result.events:
     if event.type == "tool_result":
         print(f"  🔧 研究员返回: {str(event.data)[:100]}")
 
-
 # ============================================================
 # 模式 B：Handoff（转介）
 # ============================================================
@@ -61,19 +60,19 @@ print("=" * 50)
 billing_agent = Agent(
     name="billing",
     instructions="你是账单专家。处理所有账单相关的问题，给出专业的解答。",
-    model="ollama/qwen3.5:cloud",
+    model=resolve_model("qwen3.5:cloud"),
 )
 
 tech_agent = Agent(
     name="tech",
     instructions="你是技术支持专家。处理所有技术相关的问题。",
-    model="ollama/qwen3.5:cloud",
+    model=resolve_model("qwen3.5:cloud"),
 )
 
 triage_agent = Agent(
     name="triage",
     instructions="你是客服分诊员。根据用户问题类型，转交给合适的专家：账单问题转给 billing，技术问题转给 tech。",
-    model="ollama/qwen3.5:cloud",
+    model=resolve_model("qwen3.5:cloud"),
     handoffs=[billing_agent, tech_agent],
 )
 

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/examples/ollama/05_guardrail.py

@@ -18,7 +18,7 @@ from agentkit import (
     input_guardrail, output_guardrail, GuardrailResult,
     PermissionPolicy,
 )
-
+from model_config import resolve_model
 
 # ===== 定义工具 =====
 
@@ -32,7 +32,6 @@ def delete_file(filename: str) -> str:
     """删除文件"""
     return f"[模拟] 已删除文件 {filename}"
 
-
 # ===== 定义护栏 =====
 
 @input_guardrail
@@ -54,13 +53,12 @@ async def check_output_safety(ctx, output):
             return GuardrailResult(triggered=True, reason=f"输出包含危险内容: {word}")
     return GuardrailResult(triggered=False)
 
-
 # ===== 创建带安全护栏的 Agent =====
 
 agent = Agent(
     name="safe-agent",
     instructions="你是一个安全的助手。可以帮用户读取文件，但不能删除文件。",
-    model="ollama/qwen3.5:cloud",
+    model=resolve_model("qwen3.5:cloud"),
     tools=[read_file, delete_file],
     input_guardrails=[block_sensitive_words],
     output_guardrails=[check_output_safety],
@@ -70,7 +68,6 @@ agent = Agent(
     ),
 )
 
-
 # ===== 运行测试 =====
 
 print("=" * 50)

{ni_agentkit-0.7.0 → ni_agentkit-0.7.2}/examples/ollama/05_human_in_the_loop.py

@@ -13,22 +13,19 @@ sys.path.insert(0, os.path.join(os.path.dirname(__file__), "..", "..", ".."))
 from agentkit import Agent
 from agentkit.tools.base_tool import request_human_input
 from agentkit.tools.function_tool import FunctionTool
-
+from model_config import resolve_model
 
 def confirm_action(action: str) -> str:
     """敏感操作执行前请求人工确认。"""
     request_human_input(f"即将执行敏感操作: {action}，请确认 (approve/reject)")
 
-
 def execute_action(action: str) -> str:
     """执行操作（示例返回）。"""
     return f"操作 '{action}' 已执行。"
 
-
 confirm_tool = FunctionTool.from_function(confirm_action)
 execute_tool = FunctionTool.from_function(execute_action)
 
-
 agent = Agent(
     name="hitl-agent",
     instructions=(
@@ -37,6 +34,6 @@ agent = Agent(
         "收到确认后再调用 execute_action。"
     ),
     # 使用纯本地模型，避免 cloud 变体在未鉴权/网络抖动时触发远端 502。
-    model="ollama/qwen3.5:4b",
+    model=resolve_model(),
     tools=[confirm_tool, execute_tool],
 )