claude-skills/

Anthropic公式スキル・プラグインの日本語ディレクトリ

last sync 22h ago
スキルOfficialdevelopment

🔧aidp-tools

プラグイン
oracle-ai-data-platform-workbench-engineer-agent
ソース
GitHub で見る ↗

説明

スタンドアロンの再利用可能なAIDPエージェントToolを作成・管理します。 対象となるToolの種類は、SQL、Prompt、RAG、HTTP、Custom、MCPツールで、 キーによって複数のエージェントフロー間で共有することができます。 次のような場合に使用: - 再利用可能なツールを定義したい場合（単一のフローにインラインで組み込むのではなく） - ツールの一覧表示・作成・更新・削除を行いたい場合 - ツールをテストしたい場合 - agent／エージェントフローノードから参照されるツールを構築したい場合 なお、単一フロー内でノードとしてツールをアタッチする場合は、 `aidp-agent-flows` および `references/agent-flow-nodes.md` を参照してください。

原文を表示

Create and manage standalone reusable AIDP agent Tools — SQL, Prompt, RAG, HTTP, Custom, and MCP tools that can be shared across agent flows by key. Use when the user wants to define a reusable tool (not inline in one flow), list/create/update/delete a tool, test a tool, or build a tool an agent/agent-flow node will reference. For attaching a tool inside a single flow as a node, see aidp-agent-flows + references/agent-flow-nodes.md.

ユースケース

  • ✓再利用可能なツールを定義したい
  • ✓ツールの一覧表示・作成・更新・削除を行いたい
  • ✓ツールをテストしたい
  • ✓複数のエージェントフロー間でツールを共有したい

本文（日本語訳）

aidp-tools — スタンドアロン再利用可能 Agent ツール

スタンドアロン Tool とは、Agent または Agent フローノードが toolKey で参照する再利用可能なツールオブジェクトです。 各フローに設定をインラインで記述する代わりに利用します。 LA AgentFlows ファミリー配下の Workspace スコープで管理されます。

エンジン: oci raw-request --profile DEFAULT（v1.0.0 では CLI グループなし）。Workspace スコープ。 書き込みパスは 2026-06-10 に本番環境で検証済み（oaseceal 上でラウンドトリップ確認）: POST …/workspaces/<ws>/tools → 200（key、toolConfig、toolProvider、toolType、inputSchema 等を返却）; DELETE …/tools/<key> → 204。

次のような場合に使用

  • 「再利用可能な Tool を作成/定義したい」「SQL / Prompt / RAG / HTTP / MCP / Custom ツールを作りたい」、ツールの一覧取得・更新・削除・テストを行いたい場合。
  • 単一フロー内でのみ使用するツールには使用しない（その場合はノードとしてインラインで記述 → aidp-agent-flows、references/agent-flow-nodes.md を参照）。

Tool の種類（toolType）

SQL · PROMPT · RAG · HTTP · CUSTOM · MCP（検証済み enum。ツール詳細モデルとして NL_TO_SQL も存在）。 各種類に対応する toolConfig が付随します（例: PromptToolConfiguration {llm, promptText, modelSettings}、SqlToolConfiguration、RagToolConfiguration → Knowledge Base が必要、など）。

CRUD（oci raw-request）

操作 呼び出し
一覧取得 GET …/workspaces/<ws>/tools
作成 POST …/workspaces/<ws>/tools — ボディ {displayName, description, toolType, properties, inputSchema, toolConfig}
取得 / 更新 / 削除 GET / PUT / DELETE …/workspaces/<ws>/tools/<key>
テスト POST …/workspaces/<ws>/tools/actions/test（TestMcpExternalTool 形式のボディ）— 本番環境でリクエスト形式を要確認

検証済み作成例（CUSTOM、最小構成 — ラウンドトリップ確認済み）:

oci raw-request --http-method POST --profile DEFAULT \
  --target-uri "https://aidp.<region>.oci.oraclecloud.com/20240831/dataLakes/<OCID>/workspaces/<WS>/tools" \
  --request-body '{"displayName":"my_tool","description":"…","toolType":"CUSTOM","properties":{}}'
# → 200、"key" を返却。削除は DELETE …/tools/<key> → 204

命名規則（検証済み）: 先頭は英字で始めること。使用できる特殊文字は _ のみ （先頭が _ またはその他の記号から始まる場合 → 400 InvalidParameter）。

Agent / フローへの紐付け

返却された key を、ツールノード（SQL_TOOL / PROMPT_TOOL / RAG_TOOL / HTTP_TOOL / CUSTOM_TOOL / MCP_TOOL）の toolKey として参照します。 詳細は references/agent-flow-nodes.md を参照してください。 RAG ツールを使用する場合は、事前に Knowledge Base の作成が必要です（aidp-knowledge-bases）。

ガードレール

  • 変更操作のゲート: 作成・更新・削除はステートを変更します。実行前にリクエストボディを提示してユーザーに確認を求め、.aidp/payloads/ に保存してください（references/payloads.md 参照）。シークレットをインラインで記述しないこと — aidp-credentials を使用してください。
  • 種類ごとの toolConfig フィールド名: 複雑な設定を記述する前に、SDK の create_*_tool_details または既存ツールを GET で取得してフィールド名を確認してください。設定フィールドを推測で補完しないこと。

参考リンク

原文（English）を表示

aidp-tools — standalone reusable agent tools

A standalone Tool is a reusable tool object an agent or an agent-flow node references by toolKey, instead of inlining the config in every flow. Workspace-scoped under the LA AgentFlows family.

Engine: oci raw-request --profile DEFAULT (no CLI group in v1.0.0). Workspace-scoped, and the write path is VERIFIED live 2026-06-10 (round-trip on oaseceal): POST …/workspaces/<ws>/tools → 200 (returns key, toolConfig, toolProvider, toolType, inputSchema, …); DELETE …/tools/<key> → 204.

When to use

  • "Create/define a reusable tool", "make a SQL/Prompt/RAG/HTTP/MCP/Custom tool", list/update/delete/test tools.
  • NOT a tool used only inside one flow (inline it as a node → aidp-agent-flows, references/agent-flow-nodes.md).

Tool kinds (toolType)

SQL · PROMPT · RAG · HTTP · CUSTOM · MCP (verified enum; NL_TO_SQL also exists as a tool-details model). Each carries a toolConfig of the matching type (e.g. PromptToolConfiguration {llm, promptText, modelSettings}, SqlToolConfiguration, RagToolConfiguration → needs a KB, etc.).

CRUD (oci raw-request)

Op Call
List GET …/workspaces/<ws>/tools
Create POST …/workspaces/<ws>/tools — body {displayName, description, toolType, properties, inputSchema, toolConfig}
Get / Update / Delete GET/PUT/DELETE …/workspaces/<ws>/tools/<key>
Test POST …/workspaces/<ws>/tools/actions/test (TestMcpExternalTool-style body) — confirm shape live

Verified create example (CUSTOM, minimal — round-tripped):

oci raw-request --http-method POST --profile DEFAULT \
  --target-uri "https://aidp.<region>.oci.oraclecloud.com/20240831/dataLakes/<OCID>/workspaces/<WS>/tools" \
  --request-body '{"displayName":"my_tool","description":"…","toolType":"CUSTOM","properties":{}}'
# → 200, returns "key"; delete with DELETE …/tools/<key> → 204

Name rule (verified): must start with a letter; only _ is allowed as a special character (a leading _ or other punctuation → 400 InvalidParameter).

Wire it to an agent / flow

Reference the returned key as toolKey on a tool node (SQL_TOOL/PROMPT_TOOL/RAG_TOOL/HTTP_TOOL/ CUSTOM_TOOL/MCP_TOOL) — see references/agent-flow-nodes.md. RAG tools require a Knowledge Base first (aidp-knowledge-bases).

Guardrails

  • Mutation gate: create/update/delete change state — show the body, confirm first, persist to .aidp/payloads/ (references/payloads.md). Don't inline secrets — use aidp-credentials.
  • Per-type toolConfig field names: confirm against the SDK create_*_tool_details / a live GET of an existing tool before authoring a non-trivial config; don't fabricate config fields.

References

原文・著作権は Anthropic および各プラグイン作者に帰属します。日本語訳は Claude API による自動翻訳です。