[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M69B7HCPV1Y19VDP8A1DJEEB":3,"skill-same:01M69B7HCPV1Y19VDP8A1DJEEB":58},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":29,"linkOnly":30,"markdownContent":31,"markdownBody":32,"frontMatter":33,"refName":34,"commitSha":35,"skillDirectory":36,"forksCount":37,"repositoryHtmlUrl":38,"repositoryHomepageUrl":39,"ownerHtmlUrl":40,"ownerBlogUrl":41,"ownerDescription":42,"updatedAt":43,"install":44,"resources":57},"01M69B7HCPV1Y19VDP8A1DJEEB","agents-sdk-typescript-debugging",null,"Use when troubleshooting an agent built with the Microsoft Agents SDK (@microsoft\u002Fagents-hosting and related packages). Trigger on any of these symptoms: build or TypeScript errors, crashes on startup, 401 or auth errors on incoming requests, the bot not responding to messages, .env configuration problems, Azure AD credential failures (AADSTS errors), port conflicts, or the agent not connecting in Teams or the Agents Playground. Use even if the user doesn't mention the SDK by name — trigger on symptoms like \"my bot won't start\", \"getting 401s\", or \"bot isn't responding.\"","microsoft\u002FAgents","microsoft","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F6154722?v=4","01M698VYDXZ6JW5WH3CRV650R8","Microsoft","01M69B7CR81D1HSNV69XDT8KAR",1109,"MIT","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FAgents\u002Fblob\u002Fmain\u002Fagent-plugins\u002Fagents-for-js\u002Fskills\u002Fagents-sdk-typescript-debugging\u002FSKILL.md",[],[19,20,21,22,23,24,9,25,26,27,28],"typescript","agents sdk","sdk","debugging","agents sdk typescript debugging","bot","auth","azure","packages","teams","2026-11-10 10:12:30",false,"---\nname: agents-sdk-typescript-debugging\ndescription: >\n  Use when troubleshooting an agent built with the Microsoft Agents SDK\n  (@microsoft\u002Fagents-hosting and related packages). Trigger on any of these\n  symptoms: build or TypeScript errors, crashes on startup, 401 or auth errors\n  on incoming requests, the bot not responding to messages, .env configuration\n  problems, Azure AD credential failures (AADSTS errors), port conflicts, or the\n  agent not connecting in Teams or the Agents Playground. Use even if the user\n  doesn't mention the SDK by name — trigger on symptoms like \"my bot won't\n  start\", \"getting 401s\", or \"bot isn't responding.\"\n---\n\n# Debugging Agents Built with Microsoft Agents SDK\n\n## Overview\n\nMost agent failures fall into one of three categories: the code doesn't build or start, the configuration is wrong, or the agent isn't reachable. Work through this checklist in order — each step confirms a prerequisite for the next.\n\n## Checklist\n\nYou MUST create a task for each of these items and complete them in order:\n\n1. Make sure the code builds successfully.\n2. Make sure the application starts and runs without crashing.\n3. Make sure the application opens a port and listens for incoming requests.\n4. Validate the `.env` configuration.\n5. Validate the bot's credentials against Azure AD.\n6. Use the Agents Playground to test the agent end-to-end locally.\n\n---\n\n### 1. Build the code\n\n```bash\nnpm run build\n```\n\nExpected: exits with code 0, no errors. Fix any TypeScript or import errors before continuing.\n\n---\n\n### 2. Start the application\n\nRun with debug logging enabled to get detailed output from the SDK internals:\n\n```bash\nDEBUG=agents:* npm start\n```\n\nOr for anonymous local dev:\n\n```bash\nDEBUG=agents:* node .\u002Fdist\u002Findex.js\n```\n\nThe `DEBUG=agents:*` flag enables verbose logging across all SDK namespaces. Scope down to reduce noise:\n\n```bash\nDEBUG=agents:* npm start                    # everything\nDEBUG=agents:authorization:* npm start      # all auth (most useful starting point)\nDEBUG=agents:msal npm start                 # token acquisition only\n```\n\n\n#### Auth & connections\n\n| Namespace | What it logs |\n|---|---|\n| `agents:authorization:connections` | Auth connections loaded at startup (clientId, tenantId, authType); which connection is selected per request |\n| `agents:authorization:manager` | Auth handlers configured at startup (type, scopes); which handler is invoked per request |\n| `agents:authorization:azurebot` | Azure Bot sign-in flow detail (token exchange, magic code, SSO) |\n| `agents:authorization:agentic` | Agentic auth flow detail (token acquisition, OBO) |\n| `agents:authorization` | High-level authorization middleware decisions |\n| `agents:msal` | MSAL token acquisition (token requests, cache hits, OBO) |\n| `agents:jwt-middleware` | Incoming JWT validation |\n| `agents:authConfiguration` | Auth configuration loading |\n\n#### Adapter & request handling\n\n| Namespace | What it logs |\n|---|---|\n| `agents:cloud-adapter` | Incoming request processing, activity dispatch |\n| `agents:base-adapter` | Base adapter lifecycle |\n| `agents:connector-client` | Outbound calls to the Bot Connector service |\n| `agents:user-token-client` | User token client requests |\n\n#### Application & state\n\n| Namespace | What it logs |\n|---|---|\n| `agents:app` | AgentApplication routing and lifecycle |\n| `agents:activity-handler` | ActivityHandler event dispatch |\n| `agents:state` | State read\u002Fwrite operations |\n| `agents:turnState` | Turn state access |\n| `agents:memory-storage` | MemoryStorage read\u002Fwrite |\n| `agents:middleware` | Middleware pipeline execution |\n\n#### Streaming, attachments & transcripts\n\n| Namespace | What it logs |\n|---|---|\n| `agents:streamingResponse` | Streaming response lifecycle |\n| `agents:attachmentDownloader` | Attachment download requests |\n| `agents:M365AttachmentDownloader` | M365-specific attachment downloads |\n| `agents:file-transcript-logger` | File transcript write operations |\n| `agents:rest-client` | REST client calls (transcript middleware) |\n\n#### Agent-to-agent\n\n| Namespace | What it logs |\n|---|---|\n| `agents:agent-client` | Outbound agent client calls and response handling |\n\nWatch for crash output. Common startup errors:\n\n- **`Cannot find module`** — missing `npm install`, or `dist\u002F` not built yet\n- **`ERR_MODULE_NOT_FOUND`** — check `\"type\": \"module\"` in `package.json` and that imports use `.js` extensions\n- **Port already in use** — another process is on port 3978; kill it or set `PORT` in `.env`\n\nIf the agent starts cleanly, you should see output like:\n\n```\nServer listening on port 3978\n```\n\n---\n\n### 3. Confirm the agent is reachable\n\n```bash\ncurl -s -o \u002Fdev\u002Fnull -w \"%{http_code}\" \\\n  -X POST http:\u002F\u002Flocalhost:3978\u002Fapi\u002Fmessages \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{}'\n```\n\n| Response | Meaning |\n|---|---|\n| `401` | Agent is running, auth is active — this is correct for a configured agent |\n| `200` | Agent is running with auth disabled (blank `clientId`) — correct for anonymous local dev |\n| `000` or connection refused | Agent is not running, wrong port, or crashed on startup |\n\n---\n\n### 4. Validate `.env` configuration\n\nConfiguration mistakes are the most common source of failures. Check each area below.\n\n#### 4a. Confirm the file is being loaded\n\nThe SDK requires `node --env-file .env` (Node 20+) or a manual `dotenv` call. If you're using `npm start`, check that `package.json` uses `--env-file`:\n\n```json\n\"start\": \"node --env-file .env .\u002Fdist\u002Findex.js\"\n```\n\nWithout `--env-file`, environment variables silently don't load and the agent starts with no auth config.\n\n#### 4b. Check for the correct env var format\n\nThe SDK uses the **modern `connections__` format**. Using the legacy flat format (`clientId=`, `clientSecret=`, `tenantId=`) still works but is only for backwards compatibility. Mixing the two formats causes silent misconfiguration.\n\n**Modern format (use this):**\n```\nconnections__serviceConnection__settings__clientId=\u003Cyour-app-id>\nconnections__serviceConnection__settings__clientSecret=\u003Cyour-secret>\nconnections__serviceConnection__settings__tenantId=\u003Cyour-tenant-id>\nconnectionsMap__0__connection=serviceConnection\nconnectionsMap__0__serviceUrl=*\n```\n\n**Legacy format (avoid for new agents):**\n```\nclientId=\u003Cyour-app-id>\nclientSecret=\u003Cyour-secret>\ntenantId=\u003Cyour-tenant-id>\n```\n\n#### 4c. Check double-underscore separators\n\nA single underscore (`_`) is not the same as a double underscore (`__`). The SDK uses `__` to separate path segments. A typo like `connections_serviceConnection_settings_clientId` will be silently ignored.\n\n#### 4d. Check `connectionsMap` entries\n\nIf you have multiple connections, each must have a `connectionsMap` entry. The first entry whose `serviceUrl` pattern matches the incoming request wins. Always include a `serviceUrl=*` fallback as the last entry.\n\nWith a single connection, `connectionsMap` can be omitted — the SDK defaults to `serviceUrl=*`.\n\n#### 4e. Check OAuth handler variables\n\nIf your agent uses user sign-in (`authorization: { graph: { ... } }`), the OAuth connection name must be set:\n\n```\nAgentApplication__UserAuthorization__Handlers__graph__Settings__azureBotOAuthConnectionName=GraphOAuthConnection\n```\n\nThe handler ID (`graph`) must match the key used in the `authorization` config in your code. A mismatch causes the sign-in flow to fail silently or with a cryptic error.\n\n---\n\n### 5. Validate bot credentials against Azure AD\n\nOnce the `.env` looks correct, confirm the credentials actually work by requesting a token:\n\n```bash\ncurl -s -X POST \\\n  \"https:\u002F\u002Flogin.microsoftonline.com\u002F$tenantId\u002Foauth2\u002Fv2.0\u002Ftoken\" \\\n  -d \"grant_type=client_credentials\\\n&client_id=$clientId\\\n&client_secret=$clientSecret\\\n&scope=https:\u002F\u002Fapi.botframework.com\u002F.default\" \\\n  | jq '{token_type, expires_in, error, error_description}'\n```\n\nA successful response includes `access_token`. Common errors:\n\n| Error code | Cause |\n|---|---|\n| `AADSTS700016` | `clientId` not found in tenant — wrong ID or wrong tenant |\n| `AADSTS7000215` | Invalid `clientSecret` — expired or incorrect |\n| `AADSTS90002` | `tenantId` not found |\n\n---\n\n### 6. Test with Agents Playground\n\nThe Agents Playground acts as a mock connector and channel client. It lets you test the full message flow locally without deploying to Azure or configuring a real Bot resource.\n\n**Install:**\n```bash\nnpm install -g agentsplayground\n```\n\n**Run against an anonymous agent (no `.env` needed):**\n```bash\nnpm test\n```\n\nThis assumes your `package.json` has:\n```json\n\"start:anon\": \"node .\u002Fdist\u002Findex.js\",\n\"test-tool\": \"agentsplayground -c emulator\",\n\"test\": \"npm-run-all -p -r start:anon test-tool\"\n```\n\n**Run against an authenticated agent:**\n```bash\nagentsplayground -c msteams \\\n  --client-id \u003Cyour-app-id> \\\n  --client-secret \u003Cyour-secret> \\\n  --tenant-id \u003Cyour-tenant-id>\n```\n\n**Channel options** (`-c`): `msteams`, `webchat`, `directline`, `emulator`, `agents`\n\nIf the playground connects but messages don't get responses, the agent is running but a message handler may be missing or the route isn't matching. Add a fallback handler to confirm:\n\n```typescript\nthis.onActivity('message', async (ctx: TurnContext) => {\n  await ctx.sendActivity(`Echo: ${ctx.activity.text}`)\n}, [], RouteRank.Last)\n```\n\n---\n\n### Validate an OAuth connection name\n\nOAuth connection names can only be tested end-to-end through a real sign-in flow:\n\n**Azure Portal → Your Bot Resource → Settings → OAuth Connection Settings → [your connection] → Test Connection**\n\nThis confirms the connection name matches, the OAuth app has the right scopes, and the redirect URI (`https:\u002F\u002Ftoken.botframework.com\u002F.auth\u002Fweb\u002Fredirect`) is registered on the app registration.\n\n## Contributing\n\nIf you hit a problem this skill couldn't solve, found a workaround, or noticed something wrong or outdated, that's valuable — please help improve this skill for everyone.\n\nDraft a suggested issue title and body based on the conversation, then ask the user to open it at: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagents\u002Fissues\u002Fnew\n\nA good issue includes:\n- What the user was trying to do\n- What went wrong (errors, unexpected behavior)\n- What worked — including any workaround found during this conversation\n- Relevant code or config snippets\n","# Debugging Agents Built with Microsoft Agents SDK\n\n## Overview\n\nMost agent failures fall into one of three categories: the code doesn't build or start, the configuration is wrong, or the agent isn't reachable. Work through this checklist in order — each step confirms a prerequisite for the next.\n\n## Checklist\n\nYou MUST create a task for each of these items and complete them in order:\n\n1. Make sure the code builds successfully.\n2. Make sure the application starts and runs without crashing.\n3. Make sure the application opens a port and listens for incoming requests.\n4. Validate the `.env` configuration.\n5. Validate the bot's credentials against Azure AD.\n6. Use the Agents Playground to test the agent end-to-end locally.\n\n---\n\n### 1. Build the code\n\n```bash\nnpm run build\n```\n\nExpected: exits with code 0, no errors. Fix any TypeScript or import errors before continuing.\n\n---\n\n### 2. Start the application\n\nRun with debug logging enabled to get detailed output from the SDK internals:\n\n```bash\nDEBUG=agents:* npm start\n```\n\nOr for anonymous local dev:\n\n```bash\nDEBUG=agents:* node .\u002Fdist\u002Findex.js\n```\n\nThe `DEBUG=agents:*` flag enables verbose logging across all SDK namespaces. Scope down to reduce noise:\n\n```bash\nDEBUG=agents:* npm start                    # everything\nDEBUG=agents:authorization:* npm start      # all auth (most useful starting point)\nDEBUG=agents:msal npm start                 # token acquisition only\n```\n\n\n#### Auth & connections\n\n| Namespace | What it logs |\n|---|---|\n| `agents:authorization:connections` | Auth connections loaded at startup (clientId, tenantId, authType); which connection is selected per request |\n| `agents:authorization:manager` | Auth handlers configured at startup (type, scopes); which handler is invoked per request |\n| `agents:authorization:azurebot` | Azure Bot sign-in flow detail (token exchange, magic code, SSO) |\n| `agents:authorization:agentic` | Agentic auth flow detail (token acquisition, OBO) |\n| `agents:authorization` | High-level authorization middleware decisions |\n| `agents:msal` | MSAL token acquisition (token requests, cache hits, OBO) |\n| `agents:jwt-middleware` | Incoming JWT validation |\n| `agents:authConfiguration` | Auth configuration loading |\n\n#### Adapter & request handling\n\n| Namespace | What it logs |\n|---|---|\n| `agents:cloud-adapter` | Incoming request processing, activity dispatch |\n| `agents:base-adapter` | Base adapter lifecycle |\n| `agents:connector-client` | Outbound calls to the Bot Connector service |\n| `agents:user-token-client` | User token client requests |\n\n#### Application & state\n\n| Namespace | What it logs |\n|---|---|\n| `agents:app` | AgentApplication routing and lifecycle |\n| `agents:activity-handler` | ActivityHandler event dispatch |\n| `agents:state` | State read\u002Fwrite operations |\n| `agents:turnState` | Turn state access |\n| `agents:memory-storage` | MemoryStorage read\u002Fwrite |\n| `agents:middleware` | Middleware pipeline execution |\n\n#### Streaming, attachments & transcripts\n\n| Namespace | What it logs |\n|---|---|\n| `agents:streamingResponse` | Streaming response lifecycle |\n| `agents:attachmentDownloader` | Attachment download requests |\n| `agents:M365AttachmentDownloader` | M365-specific attachment downloads |\n| `agents:file-transcript-logger` | File transcript write operations |\n| `agents:rest-client` | REST client calls (transcript middleware) |\n\n#### Agent-to-agent\n\n| Namespace | What it logs |\n|---|---|\n| `agents:agent-client` | Outbound agent client calls and response handling |\n\nWatch for crash output. Common startup errors:\n\n- **`Cannot find module`** — missing `npm install`, or `dist\u002F` not built yet\n- **`ERR_MODULE_NOT_FOUND`** — check `\"type\": \"module\"` in `package.json` and that imports use `.js` extensions\n- **Port already in use** — another process is on port 3978; kill it or set `PORT` in `.env`\n\nIf the agent starts cleanly, you should see output like:\n\n```\nServer listening on port 3978\n```\n\n---\n\n### 3. Confirm the agent is reachable\n\n```bash\ncurl -s -o \u002Fdev\u002Fnull -w \"%{http_code}\" \\\n  -X POST http:\u002F\u002Flocalhost:3978\u002Fapi\u002Fmessages \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{}'\n```\n\n| Response | Meaning |\n|---|---|\n| `401` | Agent is running, auth is active — this is correct for a configured agent |\n| `200` | Agent is running with auth disabled (blank `clientId`) — correct for anonymous local dev |\n| `000` or connection refused | Agent is not running, wrong port, or crashed on startup |\n\n---\n\n### 4. Validate `.env` configuration\n\nConfiguration mistakes are the most common source of failures. Check each area below.\n\n#### 4a. Confirm the file is being loaded\n\nThe SDK requires `node --env-file .env` (Node 20+) or a manual `dotenv` call. If you're using `npm start`, check that `package.json` uses `--env-file`:\n\n```json\n\"start\": \"node --env-file .env .\u002Fdist\u002Findex.js\"\n```\n\nWithout `--env-file`, environment variables silently don't load and the agent starts with no auth config.\n\n#### 4b. Check for the correct env var format\n\nThe SDK uses the **modern `connections__` format**. Using the legacy flat format (`clientId=`, `clientSecret=`, `tenantId=`) still works but is only for backwards compatibility. Mixing the two formats causes silent misconfiguration.\n\n**Modern format (use this):**\n```\nconnections__serviceConnection__settings__clientId=\u003Cyour-app-id>\nconnections__serviceConnection__settings__clientSecret=\u003Cyour-secret>\nconnections__serviceConnection__settings__tenantId=\u003Cyour-tenant-id>\nconnectionsMap__0__connection=serviceConnection\nconnectionsMap__0__serviceUrl=*\n```\n\n**Legacy format (avoid for new agents):**\n```\nclientId=\u003Cyour-app-id>\nclientSecret=\u003Cyour-secret>\ntenantId=\u003Cyour-tenant-id>\n```\n\n#### 4c. Check double-underscore separators\n\nA single underscore (`_`) is not the same as a double underscore (`__`). The SDK uses `__` to separate path segments. A typo like `connections_serviceConnection_settings_clientId` will be silently ignored.\n\n#### 4d. Check `connectionsMap` entries\n\nIf you have multiple connections, each must have a `connectionsMap` entry. The first entry whose `serviceUrl` pattern matches the incoming request wins. Always include a `serviceUrl=*` fallback as the last entry.\n\nWith a single connection, `connectionsMap` can be omitted — the SDK defaults to `serviceUrl=*`.\n\n#### 4e. Check OAuth handler variables\n\nIf your agent uses user sign-in (`authorization: { graph: { ... } }`), the OAuth connection name must be set:\n\n```\nAgentApplication__UserAuthorization__Handlers__graph__Settings__azureBotOAuthConnectionName=GraphOAuthConnection\n```\n\nThe handler ID (`graph`) must match the key used in the `authorization` config in your code. A mismatch causes the sign-in flow to fail silently or with a cryptic error.\n\n---\n\n### 5. Validate bot credentials against Azure AD\n\nOnce the `.env` looks correct, confirm the credentials actually work by requesting a token:\n\n```bash\ncurl -s -X POST \\\n  \"https:\u002F\u002Flogin.microsoftonline.com\u002F$tenantId\u002Foauth2\u002Fv2.0\u002Ftoken\" \\\n  -d \"grant_type=client_credentials\\\n&client_id=$clientId\\\n&client_secret=$clientSecret\\\n&scope=https:\u002F\u002Fapi.botframework.com\u002F.default\" \\\n  | jq '{token_type, expires_in, error, error_description}'\n```\n\nA successful response includes `access_token`. Common errors:\n\n| Error code | Cause |\n|---|---|\n| `AADSTS700016` | `clientId` not found in tenant — wrong ID or wrong tenant |\n| `AADSTS7000215` | Invalid `clientSecret` — expired or incorrect |\n| `AADSTS90002` | `tenantId` not found |\n\n---\n\n### 6. Test with Agents Playground\n\nThe Agents Playground acts as a mock connector and channel client. It lets you test the full message flow locally without deploying to Azure or configuring a real Bot resource.\n\n**Install:**\n```bash\nnpm install -g agentsplayground\n```\n\n**Run against an anonymous agent (no `.env` needed):**\n```bash\nnpm test\n```\n\nThis assumes your `package.json` has:\n```json\n\"start:anon\": \"node .\u002Fdist\u002Findex.js\",\n\"test-tool\": \"agentsplayground -c emulator\",\n\"test\": \"npm-run-all -p -r start:anon test-tool\"\n```\n\n**Run against an authenticated agent:**\n```bash\nagentsplayground -c msteams \\\n  --client-id \u003Cyour-app-id> \\\n  --client-secret \u003Cyour-secret> \\\n  --tenant-id \u003Cyour-tenant-id>\n```\n\n**Channel options** (`-c`): `msteams`, `webchat`, `directline`, `emulator`, `agents`\n\nIf the playground connects but messages don't get responses, the agent is running but a message handler may be missing or the route isn't matching. Add a fallback handler to confirm:\n\n```typescript\nthis.onActivity('message', async (ctx: TurnContext) => {\n  await ctx.sendActivity(`Echo: ${ctx.activity.text}`)\n}, [], RouteRank.Last)\n```\n\n---\n\n### Validate an OAuth connection name\n\nOAuth connection names can only be tested end-to-end through a real sign-in flow:\n\n**Azure Portal → Your Bot Resource → Settings → OAuth Connection Settings → [your connection] → Test Connection**\n\nThis confirms the connection name matches, the OAuth app has the right scopes, and the redirect URI (`https:\u002F\u002Ftoken.botframework.com\u002F.auth\u002Fweb\u002Fredirect`) is registered on the app registration.\n\n## Contributing\n\nIf you hit a problem this skill couldn't solve, found a workaround, or noticed something wrong or outdated, that's valuable — please help improve this skill for everyone.\n\nDraft a suggested issue title and body based on the conversation, then ask the user to open it at: https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002Fagents\u002Fissues\u002Fnew\n\nA good issue includes:\n- What the user was trying to do\n- What went wrong (errors, unexpected behavior)\n- What worked — including any workaround found during this conversation\n- Relevant code or config snippets\n",{"name":5,"description":7},"main","8171bc7e0ca3b8defd578a6bb317367c2901983f","agent-plugins\u002Fagents-for-js\u002Fskills\u002Fagents-sdk-typescript-debugging",346,"https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FAgents","https:\u002F\u002Faka.ms\u002Fagentsdkdocs","https:\u002F\u002Fgithub.com\u002Fmicrosoft","https:\u002F\u002Fopensource.microsoft.com","Open source projects and samples from Microsoft","2026-11-14 08:54:12",{"source":8,"skillName":5,"commands":45,"prompt":55,"zipAvailable":56},[46,49,52],{"tool":47,"command":48},"npx","npx skills add microsoft\u002FAgents --skill agents-sdk-typescript-debugging",{"tool":50,"command":51},"bunx","bunx skills add microsoft\u002FAgents --skill agents-sdk-typescript-debugging",{"tool":53,"command":54},"pnpm","pnpm dlx skills add microsoft\u002FAgents --skill agents-sdk-typescript-debugging","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FAgents\u002Fblob\u002Fmain\u002Fagent-plugins\u002Fagents-for-js\u002Fskills\u002Fagents-sdk-typescript-debugging\u002FSKILL.md",true,[],[59,76,94,108,121,130],{"skillNo":60,"name":61,"nameZh":6,"description":62,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":63,"categories":64,"keywords":65,"publishedAt":29},"01M6PJCYCYJQDX318SQN3EBF0E","sync-teams-samples-to-agents-sdk","CI instructions for a bounded Teams SDK to Agents SDK sample synchronization using the selected language profile.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FAgents\u002Fblob\u002Fmain\u002Fautomation\u002Fteams-sample-sync\u002Fskills\u002Fsync-teams-samples-to-agents-sdk\u002FSKILL.md",[],[20,21,66,28,67,68,69,70,71,72,73,74,75],"sync","sync teams samples to agents sdk","ci","synchronization","instructions","profile","language","sample","for","bounded",{"skillNo":77,"name":78,"nameZh":6,"description":79,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":80,"categories":81,"keywords":82,"publishedAt":29},"01M6PJCFNGCX555YERYQ459JFE","teams-sdk-to-agents-sdk-typescript-migration","Migrate a JavaScript or TypeScript application using the Microsoft Teams SDK App runtime to Microsoft 365 Agents SDK while preserving its Teams behaviors. Use for Teams SDK migrations, including automated sample synchronization; use the separate Bot Framework migration skill for botbuilder applications.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FAgents\u002Fblob\u002Fmain\u002Fagent-plugins\u002Fagents-for-js\u002Fskills\u002Fteams-sdk-to-agents-sdk-typescript-migration\u002FSKILL.md",[],[28,19,20,21,83,84,85,86,87,88,89,73,90,91,69,92,74,24,93,9],"agents sdk typescript","migration","teams sdk to agents sdk typescript migration","microsoft teams","applications","app","runtime","migrations","use","migrate","javascript",{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":98,"categories":99,"keywords":105,"publishedAt":29},"01M69B8QV24JVPXH25EH77X0SZ","teams-app-manifest","Create or audit a Microsoft Teams app manifest for an existing Microsoft 365 Agents SDK application by mapping declared intent and source-code evidence to released manifest capabilities. Use when manifest.json is missing, incomplete, or must be checked against implemented Teams features. Does not configure Microsoft Entra, Azure Bot, Developer Portal, or deployment unless separately requested.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FAgents\u002Fblob\u002Fmain\u002Fagent-plugins\u002Fagents-sdk-common\u002Fskills\u002Fteams-app-manifest\u002FSKILL.md",[100],{"categoryNo":101,"categoryName":102,"taxonomyType":103,"taxonomyTypeDesc":104},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[28,106,21,24,20,9,26,107],"teams app manifest","deployment",{"skillNo":109,"name":110,"nameZh":6,"description":111,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":112,"categories":113,"keywords":114,"publishedAt":29},"01M69B8MN62NBY93YTJAQG2Y81","agents-sdk-provision","Use when provisioning Azure resources for a Microsoft Agents SDK application — including creating an Azure Bot Service resource, setting up Entra app registrations, configuring identity credentials (UserManagedIdentity, FederatedCredentials, or ClientSecret), adding a Teams channel, running Bicep deployments for SSO, or setting up OAuth user sign-in connections via az CLI. Trigger even if the user doesn't say \"provision\" — use on requests like \"set up my bot on Azure\", \"deploy my bot\", \"configure Azure for my bot\", or \"get Teams SSO working.\" Applies to all languages (dotnet, Node.js, Python).","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FAgents\u002Fblob\u002Fmain\u002Fagent-plugins\u002Fagents-sdk-common\u002Fskills\u002Fagents-sdk-provision\u002FSKILL.md",[],[20,21,115,24,116,117,9,118,119,120,26,28],"agents sdk provision","cli","python","dotnet","identity","deploy",{"skillNo":122,"name":123,"nameZh":6,"description":124,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":125,"categories":126,"keywords":127,"publishedAt":29},"01M69B8HFZ45NQGWQQD483TWPB","agents-sdk-to-prod","Assess, create, harden, deploy, or review production readiness of Python Microsoft 365 Agents SDK agents and their direct hosting\u002Foperations files. Use only for Agents SDK scenarios, not unrelated application hardening.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FAgents\u002Fblob\u002Fmain\u002Fagent-plugins\u002Fagents-for-python\u002Fskills\u002Fagents-sdk-to-prod\u002FSKILL.md",[],[128,21,20,9,117,129,120],"agents sdk to prod","review",{"skillNo":131,"name":132,"nameZh":6,"description":133,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":134,"categories":135,"keywords":144,"publishedAt":29},"01M69B8ENJGC9NPQBZAYAN4706","agents-sdk-python-otel","Use when adding, configuring, validating, or troubleshooting OpenTelemetry observability for a Microsoft 365 Agents SDK application in Python. Trigger when the user mentions OpenTelemetry, OTel, telemetry, traces, metrics, logs, OTLP, Aspire Dashboard, Application Insights, Azure Monitor, distributed tracing, custom tracers or meters, span sampling, or observing microsoft_agents SDK signals.","https:\u002F\u002Fgithub.com\u002Fmicrosoft\u002FAgents\u002Fblob\u002Fmain\u002Fagent-plugins\u002Fagents-for-python\u002Fskills\u002Fagents-sdk-python-otel\u002FSKILL.md",[136,141],{"categoryNo":137,"categoryName":138,"taxonomyType":139,"taxonomyTypeDesc":140},"01JBSEEDCAT000000000000013","分析与可视化","SCENARIO","使用场景",{"categoryNo":142,"categoryName":143,"taxonomyType":103,"taxonomyTypeDesc":104},"01JBSEEDCAT000000000000033","数据分析师",[20,117,145,21,146,147,26,148,9,149,150,151,152],"otel","agents sdk python otel","aspire","telemetry","dashboard","distributed","aspire dashboard","monitor"]