Przejdź do treści
Biblioteka skilli
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.

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. 1. 先确认
  2. 2. 实现
  3. 3. 接线
  4. 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

RepozytoriumWynikLicencja
Ta strona · pengguogo/ai-credit-dd96MIT
umbraco/Umbraco-MCP-Base100MIT
26zl/cybersec-toolkit100MIT
steamfield/stacks96Apache-2.0
steamfield/stacks96Apache-2.0
cyanheads/ntfy-mcp-server95Apache-2.0
cyanheads/clinicaltrialsgov-mcp-server91Apache-2.0
cyanheads/mcp-ts-core91Apache-2.0
cyanheads/orcid-mcp-server91Apache-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.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.