AI i agenci · Budowanie i kod
add-tool
/add-tool
Dodaje nowe narzędzie do agenta OCFT, które pozwala mu odpytywać dane, liczyć reguły lub przeszukiwać dokumenty.
- Autor
- pengguogo ↗
- Repozytorium
- ai-credit-dd ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 27.10.2026
Ocena i bezpieczeństwo
96/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność21 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Przestarzałość
Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.
Licencja
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Dodaje nowe narzędzie do agenta OCFT, które pozwala mu odpytywać dane, liczyć reguły lub przeszukiwać dokumenty.
Oryginalny opis (EN)
为 OCFT Agent 新增一个工具(数据查询、规则计算、文档检索等)。当需要让 Agent 访问新的数据表、执行新的业务规则或接入新数据源时使用。
Jak działa
- 1. 先确认
- 2. 实现
- 3. 接线
- 4. 验证
Sekcje z nagłówków SKILL.md, w oryginale · 57 linii, 165 słów
Podgląd SKILL.md
---
name: add-tool
description: 为 OCFT Agent 新增一个工具(数据查询、规则计算、文档检索等)。当需要让 Agent 访问新的数据表、执行新的业务规则或接入新数据源时使用。
---
# 新增 Agent 工具
按以下步骤执行,参考实现:`ocft-backend/app/tools/credit.py`。
## 1. 先确认
- 工具属于哪个场景?目标数据表/文档是什么?读出来的字段里有没有评测标签(如 `is_fraud`、`extracted_kpis`、`expected`、预存的 `decision`)?有就排除,并告诉用户。
- 已有工具能否满足?能就复用,不新增。
## 2. 实现
在 `ocft-backend/app/tools/<场景>.py` 中:
```python
from ..domain.types import EvidenceRecord, ToolResult
from .registry import register_tool
_FIELDS = ["id_col", "col_a", "col_b"] # 输出字段白名单,显式列举
@register_tool(
"get_xxx", # snake_case,动词开头
"一句话说清用途和何时调用。", # LLM 依赖它选工具,写准确
{"type": "object",
"properties": {"xxxId": {"type": "string", "description": "..."}}, # camelCase
"required": ["xxxId"]},
)
def get_xxx(db, run_ctx: dict, xxxId: str):
row = ... # 参数化查询,只读
if row is None:
return ToolResult.failure("not_found", f"{xxxId} 不存在"), [], {"xxxId": xxxId}
data = {...} # 只取 _FIELDS
evidence = EvidenceRecord(
source_type="db_query", # db_query | document | calculation
source_ref={"table": "...", "keys": {"xxxId": xxxId}},
snapshot=data, data_version=run_ctx["data_version"])
return ToolResult.success(data), [evidence], {"xxxId": xxxId}
```
规则:
- 只读;禁止拼接 SQL 字符串,用 ORM 或绑定参数。
- 不写任何题目答案或固定结论;规则阈值是业务逻辑,要写进 `detail` 便于证据复核。
- 计算类结论把公式和输入写进证据(`source_type="calculation"`,`source_ref.calc`)。
- 异常用 `ToolError(code, message)`,不要吞掉。
## 3. 接线
1. 新文件需在 `ocft-backend/app/tools/__init__.py` 中 import(注册副作用)。
2. 把工具名加入 `app/agent/scenarios.py` 对应场景的 `allowed_tools`。
3. 必要时在场景 `system_prompt` 中说明何时调用该工具(只写调用策略,不写答案)。
## 4. 验证
- 在 `ocft-backend/tests/` 写 pytest:成功、not_found、参数非法三种情况;断言输出不含白名单外字段。
- 起后端,用 `POST /api/agent/runs` 提一个需要该工具的问题,`GET /api/agent/runs/{runId}` 确认 `toolTraces` 出现该工具且有 `evidenceIds`。
- 跑 `redline-scan` skill。
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · pengguogo/ai-credit-dd | 96 | MIT |
| umbraco/Umbraco-MCP-Base | 100 | MIT |
| 26zl/cybersec-toolkit | 100 | MIT |
| steamfield/stacks | 96 | Apache-2.0 |
| steamfield/stacks | 96 | Apache-2.0 |
| cyanheads/ntfy-mcp-server | 95 | Apache-2.0 |
| cyanheads/clinicaltrialsgov-mcp-server | 91 | Apache-2.0 |
| cyanheads/mcp-ts-core | 91 | Apache-2.0 |
| cyanheads/orcid-mcp-server | 91 | Apache-2.0 |
Migawka bazy z 13.11.2026 · wersja paczki 5ea06955eed7 (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 90agent-tool
Dodaje nowe narzędzie do agenta retencji Order Hub albo zmienia jego prompt i ustawienia modelu, aby odpowiadał na nowe pytania. - 84add-knowledge
Dodaje do agenta Copilot Studio źródło wiedzy, publiczną stronę lub SharePoint, które agent ma przeszukiwać. - 100add-app-tool
Tworzy szkielet pary: narzędzie MCP App i zasób UI, dla narzędzi z interaktywnym lub wizualnym interfejsem. - 90agent
Przegląda narzędzia i uprawnienia agenta, wskazując, które mogą zmieniać lub kasować dane i które wymagają zatwierdzenia. - 100agent-tool
Dodaje do agenta AI nową funkcję, którą model może wywołać, na przykład zapytanie do zewnętrznego API. - 100self-customize
Dostosowuje własnego agenta: dodaje funkcje, instaluje pakiety i serwery MCP oraz edytuje kod lub AGENTS.md.