a2a-t-sdk 0.1.0__tar.gz

a2a_t_sdk-0.1.0/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

a2a_t_sdk-0.1.0/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: a2a-t-sdk
+Version: 0.1.0
+Summary: Python A2A SDK for Telecom Scenarios
+Keywords: a2a,agent,telecom,sdk
+Author: A2A SDK Team
+License-Expression: Apache-2.0
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Requires-Dist: a2a-sdk>=1.0.1
+Requires-Dist: fastapi>=0.115.0
+Requires-Dist: sqlalchemy>=2.0.36
+Requires-Dist: sse-starlette>=2.1.3
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: pydantic>=2.6.0
+Requires-Dist: jsonschema>=4.23.0
+Requires-Dist: packaging>=24.0
+Requires-Dist: python-dotenv>=1.1.0
+Requires-Dist: uvicorn>=0.32.0
+Requires-Dist: openai
+Requires-Dist: grpcio>=1.62.0 ; extra == 'grpc'
+Requires-Python: >=3.14
+Project-URL: Homepage, https://github.com/a2a/a2a-t-sdk
+Project-URL: Documentation, https://github.com/a2a/a2a-t-sdk#readme
+Provides-Extra: grpc
+Description-Content-Type: text/markdown
+
+# a2a-t-sdk
+
+## 项目简介
+
+`a2a-t-sdk` 是一个面向电信场景的 Python SDK，用于生成任务提示词并处理任务协商流程，基于上游 `a2a-sdk` 进行扩展。当前版本为 `0.1.0`，处于 **Alpha** 阶段，适合用于原型验证、接口联调和能力评估，暂不建议直接用于生产环境。
+
+这个 SDK 主要面向两类使用方：
+
+- 客户端：根据用户输入生成任务提示词，并发起、接收和推进协商流程。
+- 服务端：校验符合 SDK 格式的 `processed task prompt`（处理后的任务提示词），并发起、接收和推进协商流程。
+
+## 核心能力
+
+- 任务提示词生成链路：覆盖输入归一化、场景识别、槽位提取、槽位校验、任务提示词渲染。
+- 客户端 API：提供任务提示词生成结果流，以及 `start_negotiation`、`receive_negotiation`、`continue_negotiation` 等协商入口。
+- 服务端校验 API：面向符合 SDK 格式的 `processed task prompt`，执行元数据解析、槽位提取和槽位校验，并支持可选的 guardrail（防护）钩子。
+- 协商类型：内置 `information`、`clarification`、`feasibility`、`fulfillment` 四类协商类型。
+- 资源组织：内置提示词资源位于 `package_data/prompt_resources`，包含 `prompts`、`scenarios`、`slots`、`templates`。
+- 内置示例场景：当前随包仅提供 `subscribe_incident`。
+
+## 项目结构
+
+仓库的核心代码位于 `src/a2a_t`，主要模块如下：
+
+- `client`：客户端封装，提供任务提示词生成与协商入口。
+- `server`：服务端封装，提供 `processed task prompt` 校验与协商入口。
+- `common`：共享的提示词资源加载与运行时公共能力。
+- `config`：模型相关配置及其加载逻辑。
+- `llm`：LLM 适配层、客户端和会话存储抽象。
+- `negotiation`：协商类型、运行时处理与状态存储。
+- `prompt`：任务提示词格式、分析、渲染与校验相关能力。
+
+## 安装与环境要求
+
+- Python 要求：`>=3.14`
+- 包名：`a2a-t-sdk`
+- 许可证：`Apache-2.0`
+- 构建后端：`uv_build`
+- 上游依赖：`a2a-sdk @ a2a-python v1.0.0-alpha.0`
+
+当前版本更适合通过源码方式试用、联调和评估。开始前，建议先将 `package_data/env.example` 复制为 `package_data/.env`。
+
+## 开发与测试
+
+项目使用 `uv_build` 作为构建后端，开发依赖包括：
+
+- `pytest`
+- `pytest-asyncio`
+- `pytest-cov`
+- `ruff`
+- `mypy`
+
+建议的最小开发流程如下：
+
+```bash
+uv sync --dev
+uv run pytest
+uv run ruff check .
+uv run mypy src
+```
+
+`tests/` 目录包含客户端提示词生成、服务端校验、协商运行时、提示词资源和 LLM 适配等测试用例。对于外部贡献者，建议优先执行与本次改动相关的测试和静态检查。
+
+## 当前支持范围
+
+使用前建议先确认以下限制：
+
+- 项目整体处于 **Alpha** 阶段，接口和资源组织仍可能调整。
+- 内置 LLM 适配器目前仅支持 DeepSeek。
+- 内置 guardrail 机制目前仅提供 `noop`。
+- 提示词资源目前仅支持本地文件。
+- 协商状态存储目前仅提供内存实现，不保证持久化。
+- 随包资源与语言覆盖有限，不包含 `registry`（注册中心）等远程资源加载能力。
+- 本文档主要介绍 SDK 本身，不涉及 CLI、托管服务、部署流程或可直接使用的应用方案。
+
+## 许可证
+
+本项目采用 [Apache-2.0](LICENSE) 许可证。

a2a_t_sdk-0.1.0/README.md

@@ -0,0 +1,78 @@
+# a2a-t-sdk
+
+## 项目简介
+
+`a2a-t-sdk` 是一个面向电信场景的 Python SDK，用于生成任务提示词并处理任务协商流程，基于上游 `a2a-sdk` 进行扩展。当前版本为 `0.1.0`，处于 **Alpha** 阶段，适合用于原型验证、接口联调和能力评估，暂不建议直接用于生产环境。
+
+这个 SDK 主要面向两类使用方：
+
+- 客户端：根据用户输入生成任务提示词，并发起、接收和推进协商流程。
+- 服务端：校验符合 SDK 格式的 `processed task prompt`（处理后的任务提示词），并发起、接收和推进协商流程。
+
+## 核心能力
+
+- 任务提示词生成链路：覆盖输入归一化、场景识别、槽位提取、槽位校验、任务提示词渲染。
+- 客户端 API：提供任务提示词生成结果流，以及 `start_negotiation`、`receive_negotiation`、`continue_negotiation` 等协商入口。
+- 服务端校验 API：面向符合 SDK 格式的 `processed task prompt`，执行元数据解析、槽位提取和槽位校验，并支持可选的 guardrail（防护）钩子。
+- 协商类型：内置 `information`、`clarification`、`feasibility`、`fulfillment` 四类协商类型。
+- 资源组织：内置提示词资源位于 `package_data/prompt_resources`，包含 `prompts`、`scenarios`、`slots`、`templates`。
+- 内置示例场景：当前随包仅提供 `subscribe_incident`。
+
+## 项目结构
+
+仓库的核心代码位于 `src/a2a_t`，主要模块如下：
+
+- `client`：客户端封装，提供任务提示词生成与协商入口。
+- `server`：服务端封装，提供 `processed task prompt` 校验与协商入口。
+- `common`：共享的提示词资源加载与运行时公共能力。
+- `config`：模型相关配置及其加载逻辑。
+- `llm`：LLM 适配层、客户端和会话存储抽象。
+- `negotiation`：协商类型、运行时处理与状态存储。
+- `prompt`：任务提示词格式、分析、渲染与校验相关能力。
+
+## 安装与环境要求
+
+- Python 要求：`>=3.14`
+- 包名：`a2a-t-sdk`
+- 许可证：`Apache-2.0`
+- 构建后端：`uv_build`
+- 上游依赖：`a2a-sdk @ a2a-python v1.0.0-alpha.0`
+
+当前版本更适合通过源码方式试用、联调和评估。开始前，建议先将 `package_data/env.example` 复制为 `package_data/.env`。
+
+## 开发与测试
+
+项目使用 `uv_build` 作为构建后端，开发依赖包括：
+
+- `pytest`
+- `pytest-asyncio`
+- `pytest-cov`
+- `ruff`
+- `mypy`
+
+建议的最小开发流程如下：
+
+```bash
+uv sync --dev
+uv run pytest
+uv run ruff check .
+uv run mypy src
+```
+
+`tests/` 目录包含客户端提示词生成、服务端校验、协商运行时、提示词资源和 LLM 适配等测试用例。对于外部贡献者，建议优先执行与本次改动相关的测试和静态检查。
+
+## 当前支持范围
+
+使用前建议先确认以下限制：
+
+- 项目整体处于 **Alpha** 阶段，接口和资源组织仍可能调整。
+- 内置 LLM 适配器目前仅支持 DeepSeek。
+- 内置 guardrail 机制目前仅提供 `noop`。
+- 提示词资源目前仅支持本地文件。
+- 协商状态存储目前仅提供内存实现，不保证持久化。
+- 随包资源与语言覆盖有限，不包含 `registry`（注册中心）等远程资源加载能力。
+- 本文档主要介绍 SDK 本身，不涉及 CLI、托管服务、部署流程或可直接使用的应用方案。
+
+## 许可证
+
+本项目采用 [Apache-2.0](LICENSE) 许可证。

a2a_t_sdk-0.1.0/package_data/env.example

@@ -0,0 +1,40 @@
+A2AT_PROMPT_DEFAULT_TTL_SECONDS=3600
+A2AT_PROMPT_LOCAL_DIR=./prompts
+A2AT_PROMPT_ALLOWED_EXTENSIONS=.md
+A2AT_DEFAULT_PROMPT_EXTENSION_URI=default-prompt
+A2AT_PROMPT_EXTENSION_URI_OVERRIDES={"agent":"prompt://agent-extension"}
+A2AT_DEFAULT_PROMPT_INDEX_URL_PARAM_KEY=promptIndexUrl
+A2AT_PROMPT_INDEX_URL_PARAM_KEY_OVERRIDES={"agent":"agentPromptCatalogUrl"}
+
+# Prompt compliance
+# Only "noop" is supported for A2AT_PROMPT_COMPLIANCE_GUARDRAIL_PROVIDER.
+# Other historical values such as "google_model_armor" are no longer implemented.
+A2AT_PROMPT_COMPLIANCE_ENABLED=false
+A2AT_PROMPT_COMPLIANCE_GUARDRAIL_PROVIDER=noop
+A2AT_PROMPT_COMPLIANCE_GUARDRAIL_TIMEOUT_SECONDS=10
+A2AT_PROMPT_COMPLIANCE_GUARDRAIL_POLICY_ID=
+A2AT_PROMPT_COMPLIANCE_GUARDRAIL_ENDPOINT=
+A2AT_PROMPT_COMPLIANCE_GUARDRAIL_REGION=
+A2AT_PROMPT_COMPLIANCE_GUARDRAIL_CREDENTIALS_REF=
+A2AT_PROMPT_COMPLIANCE_SLOT_EXTRACTION_PROVIDER=
+A2AT_PROMPT_COMPLIANCE_SLOT_EXTRACTION_MODEL=
+A2AT_PROMPT_COMPLIANCE_SLOT_EXTRACTION_TIMEOUT_SECONDS=30
+A2AT_PROMPT_COMPLIANCE_SLOT_EXTRACTION_TEMPERATURE=0
+A2AT_PROMPT_COMPLIANCE_SLOT_EXTRACTION_MAX_RETRIES=2
+A2AT_PROMPT_COMPLIANCE_SLOT_LOCAL_DIR=./slots
+A2AT_PROMPT_COMPLIANCE_SLOT_FILE_NAME=slot.json
+A2AT_PROMPT_COMPLIANCE_SLOT_NOT_FOUND_POLICY=strict
+
+# LLM runtime
+# Only "deepseek" is supported for A2AT_LLM_PROVIDER in the current project.
+# OpenAI / Google / Anthropic will be supported in future versions.
+A2AT_LLM_PROVIDER=deepseek
+A2AT_LLM_MODEL=deepseek-chat
+A2AT_LLM_API_KEY=
+A2AT_LLM_BASE_URL=https://api.deepseek.com
+A2AT_LLM_MAX_TOKENS=2000
+A2AT_LLM_TEMPERATURE=0
+A2AT_LLM_TIMEOUT_SECONDS=60
+A2AT_LLM_HISTORY_WINDOW=10
+A2AT_LLM_SESSION_MAX_TOTAL=300
+A2AT_LLM_SESSION_MAX_PER_PROVIDER=100

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/clarification_negotiation/0.0.1/en-US/system.md

@@ -0,0 +1 @@
+Clarification negotiation started by the {role} side.

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/clarification_negotiation/0.0.1/en-US/user.md

@@ -0,0 +1,4 @@
+Status={status}
+Round={round}
+Content={content_text}
+Facts={facts_json}

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/feasibility_negotiation/0.0.1/en-US/system.md

@@ -0,0 +1 @@
+Feasibility negotiation started by the {role} side.

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/feasibility_negotiation/0.0.1/en-US/user.md

@@ -0,0 +1,4 @@
+Status={status}
+Round={round}
+Content={content_text}
+Facts={facts_json}

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/fulfillment_negotiation/0.0.1/en-US/system.md

@@ -0,0 +1 @@
+Fulfillment negotiation started by the {role} side.

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/fulfillment_negotiation/0.0.1/en-US/user.md

@@ -0,0 +1,4 @@
+Status={status}
+Round={round}
+Content={content_text}
+Facts={facts_json}

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/information_negotiation/0.0.1/en-US/system.md

@@ -0,0 +1 @@
+Information negotiation started by the {role} side.

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/information_negotiation/0.0.1/en-US/user.md

@@ -0,0 +1,4 @@
+Status={status}
+Round={round}
+Content={content_text}
+Facts={facts_json}

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/scenario_recognition/0.0.1/en-US/system.md

@@ -0,0 +1,19 @@
+You are a scenario recognition agent. Your task is to identify the best matching scenario from the provided scenario list based on the user's intent.
+
+## Output Format
+Return a JSON object with the following structure:
+- matched: boolean - true if a scenario matches, false otherwise
+- scenario_code: string or null - the matched scenario code, null if no match
+- error_message: string or null - explanation if matched=false, null if matched=true
+
+## Matching Strategy
+Match scenarios based on:
+1. **Task Type**: Identify the primary action (e.g., subscribe, analyze, query)
+2. **Domain Keywords**: Look for domain-specific terms (e.g., incident, alarm, energy, power)
+3. **Intent Semantics**: Understand what the user wants to accomplish
+
+## Constraints
+- ONLY recognize the scenario, DO NOT extract slot values
+- DO NOT reject a scenario due to missing or invalid slot values
+- Return matched=false ONLY when the input intent does not fit ANY supported scenario
+- When matched=true, scenario_code MUST be one of the exact codes from the scenario list

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/scenario_recognition/0.0.1/en-US/user.md

@@ -0,0 +1,12 @@
+Analyze the normalized input and match it to the best supported scenario.
+
+## Scenario Hints
+- **energy_saving**: Keywords include "energy", "power", "consumption", "saving", "efficiency", "optimize". Intent: analyze energy usage and suggest optimizations.
+- **subscribe_incident**: Keywords include "subscribe", "incident", "alarm", "event", "notification", "alert". Intent: subscribe to incident/alarm events from network devices.
+
+## Decision Rules
+1. If input clearly indicates one task type, select that scenario
+2. If input is ambiguous, choose the most likely scenario based on domain keywords
+3. If input cannot be mapped to any scenario, return matched=false with explanation
+
+Process the input now and return your matching result.

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/scenario_recognition/0.0.1/zh-CN/system.md

@@ -0,0 +1,19 @@
+你是一个场景识别代理。你的任务是根据用户意图从提供的场景列表中识别最佳匹配场景。
+
+## 输出格式
+返回一个 JSON 对象，包含以下字段：
+- matched: boolean - 如果场景匹配则为 true，否则为 false
+- scenario_code: string 或 null - 匹配的场景编码，无匹配时为 null
+- error_message: string 或 null - matched=false 时的解释，matched=true 时为 null
+
+## 匹配策略
+基于以下维度匹配场景：
+1. **任务类型**：识别主要动作（如订阅、分析、查询）
+2. **领域关键词**：查找领域术语（如 incident、告警、能耗、节能）
+3. **意图语义**：理解用户想要完成什么
+
+## 约束
+- 仅识别场景，不提取 slot 值
+- 不要因 slot 缺失或无效而拒绝场景
+- 仅当输入意图不匹配任何支持场景时返回 matched=false
+- matched=true 时，scenario_code 必须是场景列表中的精确编码

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/scenario_recognition/0.0.1/zh-CN/user.md

@@ -0,0 +1,12 @@
+分析归一化输入并将其匹配到最佳支持场景。
+
+## 场景提示
+- **energy_saving**：关键词包括"能耗"、"节能"、"电量"、"优化"。意图：分析能耗并提供优化建议。
+- **subscribe_incident**：关键词包括"订阅"、"incident"、"告警"、"事件"、"通知"。意图：订阅网络设备的告警事件。
+
+## 决策规则
+1. 如果输入明确指示一种任务类型，选择该场景
+2. 如果输入模糊，根据领域关键词选择最可能的场景
+3. 如果输入无法映射到任何场景，返回 matched=false 并解释原因
+
+现在处理输入并返回匹配结果。

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/slot_extraction/0.0.1/en-US/system.md

@@ -0,0 +1,45 @@
+You are a slot extraction agent. Your task is to extract slot values from the user input based on the provided slot schema and template context.
+
+## Output Format
+Return a JSON object with the following structure:
+```json
+{
+  "slots": {
+    "<slot_name>": "string value" | null,
+    ...
+  },
+  "slot_errors": [
+    {
+      "slot_name": "string",
+      "code": "missing_input" | "invalid_value",
+      "message": "string"
+    }
+  ]
+}
+```
+
+## Slot Value Rules
+- Every slot defined in the schema MUST appear in the `slots` object
+- Slot values MUST be either a non-empty string or null
+- Empty strings or whitespace-only strings MUST be treated as null
+
+## Error Reporting Rules
+Report errors ONLY in `slot_errors` array with the following codes:
+- **missing_input**: Required slot cannot be extracted from input (value set to null)
+- **invalid_value**: Extracted value violates the slot's value_constraint (value set to null)
+
+### Required vs Optional Slots
+- **Required slot missing**: Set value to null, add error with code="missing_input"
+- **Optional slot missing**: Set value to null, NO error entry needed
+- **Value violates constraint**: Set value to null, add error with code="invalid_value"
+
+## Extraction Strategy
+1. Analyze the user input to identify explicit slot values
+2. Cross-reference with slot schema for value_constraint validation
+3. Use template context to understand slot semantics and expected format
+4. For list-type slots, extract as JSON array string (e.g. "[\"item1\", \"item2\"]")
+
+## Constraints
+- DO NOT generate or infer values not present in the input
+- DO NOT produce final prompt text, ONLY extract slot values
+- Report ONLY slots with errors, omit successfully extracted slots from slot_errors

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/slot_extraction/0.0.1/en-US/user.md

@@ -0,0 +1,29 @@
+Extract slot values from the normalized input based on the slot schema and template provided below.
+
+## Extraction Guidelines
+1. Identify explicit values for each slot from the input text
+2. Validate extracted values against each slot's value_constraint
+3. For slots without explicit input, determine if they are required or optional
+4. Format list-type slots as JSON array strings
+
+## Error Handling
+- If a required slot cannot be extracted: set value=null, report code="missing_input"
+- If an optional slot cannot be extracted: set value=null, no error
+- If a value violates value_constraint: set value=null, report code="invalid_value"
+
+## Example Output
+```json
+{
+  "slots": {
+    "incident_name": "[\"eth-los\"]",
+    "incident_level": "[\"critical\", \"major\"]",
+    "extra_incident_subscription_condition": null,
+    "extra_incident_basic_info": null,
+    "extra_incident_analysis_result": null,
+    "extra_incident_business_impact": null
+  },
+  "slot_errors": []
+}
+```
+
+Process the input now and return your extraction result.

a2a_t_sdk-0.1.0/package_data/prompt_resources/prompts/slot_extraction/0.0.1/zh-CN/system.md

@@ -0,0 +1,45 @@
+你是一个 slot 提取代理。你的任务是根据提供的 slot schema 和模板上下文从用户输入中提取 slot 值。
+
+## 输出格式
+返回一个 JSON 对象，包含以下结构：
+```json
+{
+  "slots": {
+    "<slot_name>": "字符串值" | null,
+    ...
+  },
+  "slot_errors": [
+    {
+      "slot_name": "字符串",
+      "code": "missing_input" | "invalid_value",
+      "message": "字符串"
+    }
+  ]
+}
+```
+
+## Slot 值规则
+- slot schema 中定义的每个 slot 必须出现在 `slots` 对象中
+- slot 值必须是非空字符串或 null
+- 空字符串或纯空白字符串必须视为 null
+
+## 错误报告规则
+仅在 `slot_errors` 数组中报告错误，使用以下错误码：
+- **missing_input**：无法从输入中提取必填 slot（值设为 null）
+- **invalid_value**：提取的值违反 slot 的 value_constraint（值设为 null）
+
+### 必填 vs 可选 Slot
+- **必填 slot 缺失**：值设为 null，添加错误 code="missing_input"
+- **可选 slot 缺失**：值设为 null，无需错误条目
+- **值违反约束**：值设为 null，添加错误 code="invalid_value"
+
+## 提取策略
+1. 分析用户输入，识别明确的 slot 值
+2. 根据 slot schema 的 value_constraint 校验值
+3. 利用模板上下文理解 slot 语义和预期格式
+4. 对于 list 类型 slot，提取为 JSON 数组字符串（如 "[\"item1\", \"item2\"]")
+
+## 约束
+- 不要生成或推断输入中未出现的值
+- 不要生成最终 prompt 文本，仅提取 slot 值
+- 仅报告有错误的 slot，成功提取的 slot 不加入 slot_errors