[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M71RCMRCVQJT32XERFAJDEG8":3,"skill-same:01M71RCMRCVQJT32XERFAJDEG8":47},{"skillNo":4,"name":5,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":14,"categories":15,"keywords":16,"publishedAt":22,"linkOnly":23,"markdownContent":24,"markdownBody":25,"frontMatter":26,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":12,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M71RCMRCVQJT32XERFAJDEG8","azure-ai-agents-persistent-dotnet",null,"javiertarazon\u002Fide-agente-free-jt7-","javiertarazon","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F153141207?v=4","01M71R52TB3S9HXKH6WSNT8A7V","01M71R52VG5KS2DKDDH4GDQ30A",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjaviertarazon\u002Fide-agente-free-jt7-\u002Fblob\u002Frelease\u002Fv4.2.11-panel-pro\u002F.github\u002Fskills\u002Fazure-ai-agents-persistent-dotnet\u002FSKILL.md",[],[17,18,19,20,21],"ai agents","dotnet","azure ai","azure","azure ai agents persistent dotnet","2026-11-10 13:02:02",false,"---\nname: azure-ai-agents-persistent-dotnet\ndescription: \"|\"\n  Azure AI Agents Persistent SDK for .NET. Low-level SDK for creating and managing AI agents with threads, messages, runs, and tools. Use for agent CRUD, conversation threads, streaming responses, function calling, file search, and code interpreter. Triggers: \"PersistentAgentsClient\", \"persistent agents\", \"agent threads\", \"agent runs\", \"streaming agents\", \"function calling agents .NET\".\npackage: Azure.AI.Agents.Persistent\nrisk: unknown\nsource: community\n---\n\n# Azure.AI.Agents.Persistent (.NET)\n\nLow-level SDK for creating and managing persistent AI agents with threads, messages, runs, and tools.\n\n## Installation\n\n```bash\ndotnet add package Azure.AI.Agents.Persistent --prerelease\ndotnet add package Azure.Identity\n```\n\n**Current Versions**: Stable v1.1.0, Preview v1.2.0-beta.8\n\n## Environment Variables\n\n```bash\nPROJECT_ENDPOINT=https:\u002F\u002F\u003Cresource>.services.ai.azure.com\u002Fapi\u002Fprojects\u002F\u003Cproject>\nMODEL_DEPLOYMENT_NAME=gpt-4o-mini\nAZURE_BING_CONNECTION_ID=\u003Cbing-connection-resource-id>\nAZURE_AI_SEARCH_CONNECTION_ID=\u003Csearch-connection-resource-id>\n```\n\n## Authentication\n\n```csharp\nusing Azure.AI.Agents.Persistent;\nusing Azure.Identity;\n\nvar projectEndpoint = Environment.GetEnvironmentVariable(\"PROJECT_ENDPOINT\");\nPersistentAgentsClient client = new(projectEndpoint, new DefaultAzureCredential());\n```\n\n## Client Hierarchy\n\n```\nPersistentAgentsClient\n├── Administration  → Agent CRUD operations\n├── Threads         → Thread management\n├── Messages        → Message operations\n├── Runs            → Run execution and streaming\n├── Files           → File upload\u002Fdownload\n└── VectorStores    → Vector store management\n```\n\n## Core Workflow\n\n### 1. Create Agent\n\n```csharp\nvar modelDeploymentName = Environment.GetEnvironmentVariable(\"MODEL_DEPLOYMENT_NAME\");\n\nPersistentAgent agent = await client.Administration.CreateAgentAsync(\n    model: modelDeploymentName,\n    name: \"Math Tutor\",\n    instructions: \"You are a personal math tutor. Write and run code to answer math questions.\",\n    tools: [new CodeInterpreterToolDefinition()]\n);\n```\n\n### 2. Create Thread and Message\n\n```csharp\n\u002F\u002F Create thread\nPersistentAgentThread thread = await client.Threads.CreateThreadAsync();\n\n\u002F\u002F Create message\nawait client.Messages.CreateMessageAsync(\n    thread.Id,\n    MessageRole.User,\n    \"I need to solve the equation `3x + 11 = 14`. Can you help me?\"\n);\n```\n\n### 3. Run Agent (Polling)\n\n```csharp\n\u002F\u002F Create run\nThreadRun run = await client.Runs.CreateRunAsync(\n    thread.Id,\n    agent.Id,\n    additionalInstructions: \"Please address the user as Jane Doe.\"\n);\n\n\u002F\u002F Poll for completion\ndo\n{\n    await Task.Delay(TimeSpan.FromMilliseconds(500));\n    run = await client.Runs.GetRunAsync(thread.Id, run.Id);\n}\nwhile (run.Status == RunStatus.Queued || run.Status == RunStatus.InProgress);\n\n\u002F\u002F Retrieve messages\nawait foreach (PersistentThreadMessage message in client.Messages.GetMessagesAsync(\n    threadId: thread.Id, \n    order: ListSortOrder.Ascending))\n{\n    Console.Write($\"{message.Role}: \");\n    foreach (MessageContent content in message.ContentItems)\n    {\n        if (content is MessageTextContent textContent)\n            Console.WriteLine(textContent.Text);\n    }\n}\n```\n\n### 4. Streaming Response\n\n```csharp\nAsyncCollectionResult\u003CStreamingUpdate> stream = client.Runs.CreateRunStreamingAsync(\n    thread.Id, \n    agent.Id\n);\n\nawait foreach (StreamingUpdate update in stream)\n{\n    if (update.UpdateKind == StreamingUpdateReason.RunCreated)\n    {\n        Console.WriteLine(\"--- Run started! ---\");\n    }\n    else if (update is MessageContentUpdate contentUpdate)\n    {\n        Console.Write(contentUpdate.Text);\n    }\n    else if (update.UpdateKind == StreamingUpdateReason.RunCompleted)\n    {\n        Console.WriteLine(\"\\n--- Run completed! ---\");\n    }\n}\n```\n\n### 5. Function Calling\n\n```csharp\n\u002F\u002F Define function tool\nFunctionToolDefinition weatherTool = new(\n    name: \"getCurrentWeather\",\n    description: \"Gets the current weather at a location.\",\n    parameters: BinaryData.FromObjectAsJson(new\n    {\n        Type = \"object\",\n        Properties = new\n        {\n            Location = new { Type = \"string\", Description = \"City and state, e.g. San Francisco, CA\" },\n            Unit = new { Type = \"string\", Enum = new[] { \"c\", \"f\" } }\n        },\n        Required = new[] { \"location\" }\n    }, new JsonSerializerOptions { PropertyNamingPolicy = JsonNamingPolicy.CamelCase })\n);\n\n\u002F\u002F Create agent with function\nPersistentAgent agent = await client.Administration.CreateAgentAsync(\n    model: modelDeploymentName,\n    name: \"Weather Bot\",\n    instructions: \"You are a weather bot.\",\n    tools: [weatherTool]\n);\n\n\u002F\u002F Handle function calls during polling\ndo\n{\n    await Task.Delay(500);\n    run = await client.Runs.GetRunAsync(thread.Id, run.Id);\n\n    if (run.Status == RunStatus.RequiresAction \n        && run.RequiredAction is SubmitToolOutputsAction submitAction)\n    {\n        List\u003CToolOutput> outputs = [];\n        foreach (RequiredToolCall toolCall in submitAction.ToolCalls)\n        {\n            if (toolCall is RequiredFunctionToolCall funcCall)\n            {\n                \u002F\u002F Execute function and get result\n                string result = ExecuteFunction(funcCall.Name, funcCall.Arguments);\n                outputs.Add(new ToolOutput(toolCall, result));\n            }\n        }\n        run = await client.Runs.SubmitToolOutputsToRunAsync(run, outputs, toolApprovals: null);\n    }\n}\nwhile (run.Status == RunStatus.Queued || run.Status == RunStatus.InProgress);\n```\n\n### 6. File Search with Vector Store\n\n```csharp\n\u002F\u002F Upload file\nPersistentAgentFileInfo file = await client.Files.UploadFileAsync(\n    filePath: \"document.txt\",\n    purpose: PersistentAgentFilePurpose.Agents\n);\n\n\u002F\u002F Create vector store\nPersistentAgentsVectorStore vectorStore = await client.VectorStores.CreateVectorStoreAsync(\n    fileIds: [file.Id],\n    name: \"my_vector_store\"\n);\n\n\u002F\u002F Create file search resource\nFileSearchToolResource fileSearchResource = new();\nfileSearchResource.VectorStoreIds.Add(vectorStore.Id);\n\n\u002F\u002F Create agent with file search\nPersistentAgent agent = await client.Administration.CreateAgentAsync(\n    model: modelDeploymentName,\n    name: \"Document Assistant\",\n    instructions: \"You help users find information in documents.\",\n    tools: [new FileSearchToolDefinition()],\n    toolResources: new ToolResources { FileSearch = fileSearchResource }\n);\n```\n\n### 7. Bing Grounding\n\n```csharp\nvar bingConnectionId = Environment.GetEnvironmentVariable(\"AZURE_BING_CONNECTION_ID\");\n\nBingGroundingToolDefinition bingTool = new(\n    new BingGroundingSearchToolParameters(\n        [new BingGroundingSearchConfiguration(bingConnectionId)]\n    )\n);\n\nPersistentAgent agent = await client.Administration.CreateAgentAsync(\n    model: modelDeploymentName,\n    name: \"Search Agent\",\n    instructions: \"Use Bing to answer questions about current events.\",\n    tools: [bingTool]\n);\n```\n\n### 8. Azure AI Search\n\n```csharp\nAzureAISearchToolResource searchResource = new(\n    connectionId: searchConnectionId,\n    indexName: \"my_index\",\n    topK: 5,\n    filter: \"category eq 'documentation'\",\n    queryType: AzureAISearchQueryType.Simple\n);\n\nPersistentAgent agent = await client.Administration.CreateAgentAsync(\n    model: modelDeploymentName,\n    name: \"Search Agent\",\n    instructions: \"Search the documentation index to answer questions.\",\n    tools: [new AzureAISearchToolDefinition()],\n    toolResources: new ToolResources { AzureAISearch = searchResource }\n);\n```\n\n### 9. Cleanup\n\n```csharp\nawait client.Threads.DeleteThreadAsync(thread.Id);\nawait client.Administration.DeleteAgentAsync(agent.Id);\nawait client.VectorStores.DeleteVectorStoreAsync(vectorStore.Id);\nawait client.Files.DeleteFileAsync(file.Id);\n```\n\n## Available Tools\n\n| Tool | Class | Purpose |\n|------|-------|---------|\n| Code Interpreter | `CodeInterpreterToolDefinition` | Execute Python code, generate visualizations |\n| File Search | `FileSearchToolDefinition` | Search uploaded files via vector stores |\n| Function Calling | `FunctionToolDefinition` | Call custom functions |\n| Bing Grounding | `BingGroundingToolDefinition` | Web search via Bing |\n| Azure AI Search | `AzureAISearchToolDefinition` | Search Azure AI Search indexes |\n| OpenAPI | `OpenApiToolDefinition` | Call external APIs via OpenAPI spec |\n| Azure Functions | `AzureFunctionToolDefinition` | Invoke Azure Functions |\n| MCP | `MCPToolDefinition` | Model Context Protocol tools |\n| SharePoint | `SharepointToolDefinition` | Access SharePoint content |\n| Microsoft Fabric | `MicrosoftFabricToolDefinition` | Access Fabric data |\n\n## Streaming Update Types\n\n| Update Type | Description |\n|-------------|-------------|\n| `StreamingUpdateReason.RunCreated` | Run started |\n| `StreamingUpdateReason.RunInProgress` | Run processing |\n| `StreamingUpdateReason.RunCompleted` | Run finished |\n| `StreamingUpdateReason.RunFailed` | Run errored |\n| `MessageContentUpdate` | Text content chunk |\n| `RunStepUpdate` | Step status change |\n\n## Key Types Reference\n\n| Type | Purpose |\n|------|---------|\n| `PersistentAgentsClient` | Main entry point |\n| `PersistentAgent` | Agent with model, instructions, tools |\n| `PersistentAgentThread` | Conversation thread |\n| `PersistentThreadMessage` | Message in thread |\n| `ThreadRun` | Execution of agent against thread |\n| `RunStatus` | Queued, InProgress, RequiresAction, Completed, Failed |\n| `ToolResources` | Combined tool resources |\n| `ToolOutput` | Function call response |\n\n## Best Practices\n\n1. **Always dispose clients** — Use `using` statements or explicit disposal\n2. **Poll with appropriate delays** — 500ms recommended between status checks\n3. **Clean up resources** — Delete threads and agents when done\n4. **Handle all run statuses** — Check for `RequiresAction`, `Failed`, `Cancelled`\n5. **Use streaming for real-time UX** — Better user experience than polling\n6. **Store IDs not objects** — Reference agents\u002Fthreads by ID\n7. **Use async methods** — All operations should be async\n\n## Error Handling\n\n```csharp\nusing Azure;\n\ntry\n{\n    var agent = await client.Administration.CreateAgentAsync(...);\n}\ncatch (RequestFailedException ex) when (ex.Status == 404)\n{\n    Console.WriteLine(\"Resource not found\");\n}\ncatch (RequestFailedException ex)\n{\n    Console.WriteLine($\"Error: {ex.Status} - {ex.ErrorCode}: {ex.Message}\");\n}\n```\n\n## Related SDKs\n\n| SDK | Purpose | Install |\n|-----|---------|---------|\n| `Azure.AI.Agents.Persistent` | Low-level agents (this SDK) | `dotnet add package Azure.AI.Agents.Persistent` |\n| `Azure.AI.Projects` | High-level project client | `dotnet add package Azure.AI.Projects` |\n\n## Reference Links\n\n| Resource | URL |\n|----------|-----|\n| NuGet Package | https:\u002F\u002Fwww.nuget.org\u002Fpackages\u002FAzure.AI.Agents.Persistent |\n| API Reference | https:\u002F\u002Flearn.microsoft.com\u002Fdotnet\u002Fapi\u002Fazure.ai.agents.persistent |\n| GitHub Source | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Ftree\u002Fmain\u002Fsdk\u002Fai\u002FAzure.AI.Agents.Persistent |\n| Samples | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Ftree\u002Fmain\u002Fsdk\u002Fai\u002FAzure.AI.Agents.Persistent\u002Fsamples |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n","# Azure.AI.Agents.Persistent (.NET)\n\nLow-level SDK for creating and managing persistent AI agents with threads, messages, runs, and tools.\n\n## Installation\n\n```bash\ndotnet add package Azure.AI.Agents.Persistent --prerelease\ndotnet add package Azure.Identity\n```\n\n**Current Versions**: Stable v1.1.0, Preview v1.2.0-beta.8\n\n## Environment Variables\n\n```bash\nPROJECT_ENDPOINT=https:\u002F\u002F\u003Cresource>.services.ai.azure.com\u002Fapi\u002Fprojects\u002F\u003Cproject>\nMODEL_DEPLOYMENT_NAME=gpt-4o-mini\nAZURE_BING_CONNECTION_ID=\u003Cbing-connection-resource-id>\nAZURE_AI_SEARCH_CONNECTION_ID=\u003Csearch-connection-resource-id>\n```\n\n## Authentication\n\n```csharp\nusing Azure.AI.Agents.Persistent;\nusing Azure.Identity;\n\nvar projectEndpoint = Environment.GetEnvironmentVariable(\"PROJECT_ENDPOINT\");\nPersistentAgentsClient client = new(projectEndpoint, new DefaultAzureCredential());\n```\n\n## Client Hierarchy\n\n```\nPersistentAgentsClient\n├── Administration  → Agent CRUD operations\n├── Threads         → Thread management\n├── Messages        → Message operations\n├── Runs            → Run execution and streaming\n├── Files           → File upload\u002Fdownload\n└── VectorStores    → Vector store management\n```\n\n## Core Workflow\n\n### 1. Create Agent\n\n```csharp\nvar modelDeploymentName = Environment.GetEnvironmentVariable(\"MODEL_DEPLOYMENT_NAME\");\n\nPersistentAgent agent = await client.Administration.CreateAgentAsync(\n    model: modelDeploymentName,\n    name: \"Math Tutor\",\n    instructions: \"You are a personal math tutor. Write and run code to answer math questions.\",\n    tools: [new CodeInterpreterToolDefinition()]\n);\n```\n\n### 2. Create Thread and Message\n\n```csharp\n\u002F\u002F Create thread\nPersistentAgentThread thread = await client.Threads.CreateThreadAsync();\n\n\u002F\u002F Create message\nawait client.Messages.CreateMessageAsync(\n    thread.Id,\n    MessageRole.User,\n    \"I need to solve the equation `3x + 11 = 14`. Can you help me?\"\n);\n```\n\n### 3. Run Agent (Polling)\n\n```csharp\n\u002F\u002F Create run\nThreadRun run = await client.Runs.CreateRunAsync(\n    thread.Id,\n    agent.Id,\n    additionalInstructions: \"Please address the user as Jane Doe.\"\n);\n\n\u002F\u002F Poll for completion\ndo\n{\n    await Task.Delay(TimeSpan.FromMilliseconds(500));\n    run = await client.Runs.GetRunAsync(thread.Id, run.Id);\n}\nwhile (run.Status == RunStatus.Queued || run.Status == RunStatus.InProgress);\n\n\u002F\u002F Retrieve messages\nawait foreach (PersistentThreadMessage message in client.Messages.GetMessagesAsync(\n    threadId: thread.Id, \n    order: ListSortOrder.Ascending))\n{\n    Console.Write($\"{message.Role}: \");\n    foreach (MessageContent content in message.ContentItems)\n    {\n        if (content is MessageTextContent textContent)\n            Console.WriteLine(textContent.Text);\n    }\n}\n```\n\n### 4. Streaming Response\n\n```csharp\nAsyncCollectionResult\u003CStreamingUpdate> stream = client.Runs.CreateRunStreamingAsync(\n    thread.Id, \n    agent.Id\n);\n\nawait foreach (StreamingUpdate update in stream)\n{\n    if (update.UpdateKind == StreamingUpdateReason.RunCreated)\n    {\n        Console.WriteLine(\"--- Run started! ---\");\n    }\n    else if (update is MessageContentUpdate contentUpdate)\n    {\n        Console.Write(contentUpdate.Text);\n    }\n    else if (update.UpdateKind == StreamingUpdateReason.RunCompleted)\n    {\n        Console.WriteLine(\"\\n--- Run completed! ---\");\n    }\n}\n```\n\n### 5. Function Calling\n\n```csharp\n\u002F\u002F Define function tool\nFunctionToolDefinition weatherTool = new(\n    name: \"getCurrentWeather\",\n    description: \"Gets the current weather at a location.\",\n    parameters: BinaryData.FromObjectAsJson(new\n    {\n        Type = \"object\",\n        Properties = new\n        {\n            Location = new { Type = \"string\", Description = \"City and state, e.g. San Francisco, CA\" },\n            Unit = new { Type = \"string\", Enum = new[] { \"c\", \"f\" } }\n        },\n        Required = new[] { \"location\" }\n    }, new JsonSerializerOptions { PropertyNamingPolicy = JsonNamingPolicy.CamelCase })\n);\n\n\u002F\u002F Create agent with function\nPersistentAgent agent = await client.Administration.CreateAgentAsync(\n    model: modelDeploymentName,\n    name: \"Weather Bot\",\n    instructions: \"You are a weather bot.\",\n    tools: [weatherTool]\n);\n\n\u002F\u002F Handle function calls during polling\ndo\n{\n    await Task.Delay(500);\n    run = await client.Runs.GetRunAsync(thread.Id, run.Id);\n\n    if (run.Status == RunStatus.RequiresAction \n        && run.RequiredAction is SubmitToolOutputsAction submitAction)\n    {\n        List\u003CToolOutput> outputs = [];\n        foreach (RequiredToolCall toolCall in submitAction.ToolCalls)\n        {\n            if (toolCall is RequiredFunctionToolCall funcCall)\n            {\n                \u002F\u002F Execute function and get result\n                string result = ExecuteFunction(funcCall.Name, funcCall.Arguments);\n                outputs.Add(new ToolOutput(toolCall, result));\n            }\n        }\n        run = await client.Runs.SubmitToolOutputsToRunAsync(run, outputs, toolApprovals: null);\n    }\n}\nwhile (run.Status == RunStatus.Queued || run.Status == RunStatus.InProgress);\n```\n\n### 6. File Search with Vector Store\n\n```csharp\n\u002F\u002F Upload file\nPersistentAgentFileInfo file = await client.Files.UploadFileAsync(\n    filePath: \"document.txt\",\n    purpose: PersistentAgentFilePurpose.Agents\n);\n\n\u002F\u002F Create vector store\nPersistentAgentsVectorStore vectorStore = await client.VectorStores.CreateVectorStoreAsync(\n    fileIds: [file.Id],\n    name: \"my_vector_store\"\n);\n\n\u002F\u002F Create file search resource\nFileSearchToolResource fileSearchResource = new();\nfileSearchResource.VectorStoreIds.Add(vectorStore.Id);\n\n\u002F\u002F Create agent with file search\nPersistentAgent agent = await client.Administration.CreateAgentAsync(\n    model: modelDeploymentName,\n    name: \"Document Assistant\",\n    instructions: \"You help users find information in documents.\",\n    tools: [new FileSearchToolDefinition()],\n    toolResources: new ToolResources { FileSearch = fileSearchResource }\n);\n```\n\n### 7. Bing Grounding\n\n```csharp\nvar bingConnectionId = Environment.GetEnvironmentVariable(\"AZURE_BING_CONNECTION_ID\");\n\nBingGroundingToolDefinition bingTool = new(\n    new BingGroundingSearchToolParameters(\n        [new BingGroundingSearchConfiguration(bingConnectionId)]\n    )\n);\n\nPersistentAgent agent = await client.Administration.CreateAgentAsync(\n    model: modelDeploymentName,\n    name: \"Search Agent\",\n    instructions: \"Use Bing to answer questions about current events.\",\n    tools: [bingTool]\n);\n```\n\n### 8. Azure AI Search\n\n```csharp\nAzureAISearchToolResource searchResource = new(\n    connectionId: searchConnectionId,\n    indexName: \"my_index\",\n    topK: 5,\n    filter: \"category eq 'documentation'\",\n    queryType: AzureAISearchQueryType.Simple\n);\n\nPersistentAgent agent = await client.Administration.CreateAgentAsync(\n    model: modelDeploymentName,\n    name: \"Search Agent\",\n    instructions: \"Search the documentation index to answer questions.\",\n    tools: [new AzureAISearchToolDefinition()],\n    toolResources: new ToolResources { AzureAISearch = searchResource }\n);\n```\n\n### 9. Cleanup\n\n```csharp\nawait client.Threads.DeleteThreadAsync(thread.Id);\nawait client.Administration.DeleteAgentAsync(agent.Id);\nawait client.VectorStores.DeleteVectorStoreAsync(vectorStore.Id);\nawait client.Files.DeleteFileAsync(file.Id);\n```\n\n## Available Tools\n\n| Tool | Class | Purpose |\n|------|-------|---------|\n| Code Interpreter | `CodeInterpreterToolDefinition` | Execute Python code, generate visualizations |\n| File Search | `FileSearchToolDefinition` | Search uploaded files via vector stores |\n| Function Calling | `FunctionToolDefinition` | Call custom functions |\n| Bing Grounding | `BingGroundingToolDefinition` | Web search via Bing |\n| Azure AI Search | `AzureAISearchToolDefinition` | Search Azure AI Search indexes |\n| OpenAPI | `OpenApiToolDefinition` | Call external APIs via OpenAPI spec |\n| Azure Functions | `AzureFunctionToolDefinition` | Invoke Azure Functions |\n| MCP | `MCPToolDefinition` | Model Context Protocol tools |\n| SharePoint | `SharepointToolDefinition` | Access SharePoint content |\n| Microsoft Fabric | `MicrosoftFabricToolDefinition` | Access Fabric data |\n\n## Streaming Update Types\n\n| Update Type | Description |\n|-------------|-------------|\n| `StreamingUpdateReason.RunCreated` | Run started |\n| `StreamingUpdateReason.RunInProgress` | Run processing |\n| `StreamingUpdateReason.RunCompleted` | Run finished |\n| `StreamingUpdateReason.RunFailed` | Run errored |\n| `MessageContentUpdate` | Text content chunk |\n| `RunStepUpdate` | Step status change |\n\n## Key Types Reference\n\n| Type | Purpose |\n|------|---------|\n| `PersistentAgentsClient` | Main entry point |\n| `PersistentAgent` | Agent with model, instructions, tools |\n| `PersistentAgentThread` | Conversation thread |\n| `PersistentThreadMessage` | Message in thread |\n| `ThreadRun` | Execution of agent against thread |\n| `RunStatus` | Queued, InProgress, RequiresAction, Completed, Failed |\n| `ToolResources` | Combined tool resources |\n| `ToolOutput` | Function call response |\n\n## Best Practices\n\n1. **Always dispose clients** — Use `using` statements or explicit disposal\n2. **Poll with appropriate delays** — 500ms recommended between status checks\n3. **Clean up resources** — Delete threads and agents when done\n4. **Handle all run statuses** — Check for `RequiresAction`, `Failed`, `Cancelled`\n5. **Use streaming for real-time UX** — Better user experience than polling\n6. **Store IDs not objects** — Reference agents\u002Fthreads by ID\n7. **Use async methods** — All operations should be async\n\n## Error Handling\n\n```csharp\nusing Azure;\n\ntry\n{\n    var agent = await client.Administration.CreateAgentAsync(...);\n}\ncatch (RequestFailedException ex) when (ex.Status == 404)\n{\n    Console.WriteLine(\"Resource not found\");\n}\ncatch (RequestFailedException ex)\n{\n    Console.WriteLine($\"Error: {ex.Status} - {ex.ErrorCode}: {ex.Message}\");\n}\n```\n\n## Related SDKs\n\n| SDK | Purpose | Install |\n|-----|---------|---------|\n| `Azure.AI.Agents.Persistent` | Low-level agents (this SDK) | `dotnet add package Azure.AI.Agents.Persistent` |\n| `Azure.AI.Projects` | High-level project client | `dotnet add package Azure.AI.Projects` |\n\n## Reference Links\n\n| Resource | URL |\n|----------|-----|\n| NuGet Package | https:\u002F\u002Fwww.nuget.org\u002Fpackages\u002FAzure.AI.Agents.Persistent |\n| API Reference | https:\u002F\u002Flearn.microsoft.com\u002Fdotnet\u002Fapi\u002Fazure.ai.agents.persistent |\n| GitHub Source | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Ftree\u002Fmain\u002Fsdk\u002Fai\u002FAzure.AI.Agents.Persistent |\n| Samples | https:\u002F\u002Fgithub.com\u002FAzure\u002Fazure-sdk-for-net\u002Ftree\u002Fmain\u002Fsdk\u002Fai\u002FAzure.AI.Agents.Persistent\u002Fsamples |\n\n## When to Use\nThis skill is applicable to execute the workflow or actions described in the overview.\n",{},"release\u002Fv4.2.11-panel-pro","a92ea02bcf7e2b3dbaf46d49696c29a3cb490d4f",".github\u002Fskills\u002Fazure-ai-agents-persistent-dotnet","https:\u002F\u002Fgithub.com\u002Fjaviertarazon\u002Fide-agente-free-jt7-","https:\u002F\u002Fgithub.com\u002Fjaviertarazon","2026-07-12 07:10:45",{"source":7,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add javiertarazon\u002Fide-agente-free-jt7- --skill azure-ai-agents-persistent-dotnet",{"tool":39,"command":40},"bunx","bunx skills add javiertarazon\u002Fide-agente-free-jt7- --skill azure-ai-agents-persistent-dotnet",{"tool":42,"command":43},"pnpm","pnpm dlx skills add javiertarazon\u002Fide-agente-free-jt7- --skill azure-ai-agents-persistent-dotnet","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjaviertarazon\u002Fide-agente-free-jt7-\u002Fblob\u002Frelease\u002Fv4.2.11-panel-pro\u002F.github\u002Fskills\u002Fazure-ai-agents-persistent-dotnet\u002FSKILL.md",true,[],[48,80,107,127,142,164],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":52,"categories":53,"keywords":59,"publishedAt":22},"01M71TQ7Q6Z10VWF3C2H5X1KW9","zustand-store-ts","Create Zustand stores with TypeScript, subscribeWithSelector middleware, and proper state\u002Faction separation. Use when building React state management, creating global stores, or implementing reacti...","https:\u002F\u002Fgithub.com\u002Fjaviertarazon\u002Fide-agente-free-jt7-\u002Fblob\u002Frelease\u002Fv4.2.11-panel-pro\u002F.github\u002Fskills\u002Fzustand-store-ts\u002FSKILL.md",[54],{"categoryNo":55,"categoryName":56,"taxonomyType":57,"taxonomyTypeDesc":58},"01JBSEEDCAT000000000000009","前端开发","SCENARIO","使用场景",[60,61,62,63,64,65,66,67,68,69,70,71,72,73,74,75,76,77,78,79],"zustand","store","zustand store ts","community","middleware","implementing","use","react state management","when","unknown","react","with","state","create","state management","typescript","action","management","separation","global",{"skillNo":81,"name":82,"nameZh":6,"description":83,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":84,"categories":85,"keywords":89,"publishedAt":22},"01M71TQ5EAR40G6W0MV5ZDVEZT","zoom-automation","Automate Zoom meeting creation, management, recordings, webinars, and participant tracking via Rube MCP (Composio). Always search tools first for current schemas.","https:\u002F\u002Fgithub.com\u002Fjaviertarazon\u002Fide-agente-free-jt7-\u002Fblob\u002Frelease\u002Fv4.2.11-panel-pro\u002F.github\u002Fskills\u002Fzoom-automation\u002FSKILL.md",[86],{"categoryNo":87,"categoryName":88,"taxonomyType":57,"taxonomyTypeDesc":58},"01JBSEEDCAT000000000000023","Skill与智能体开发",[90,91,92,63,93,94,95,96,97,69,98,99,100,101,102,103,104,105,77,106],"zoom automation","zoom","automation","creation","for","search","schemas","MCP","first","via","meeting","search tools","tracking","webinars","composio","recordings","Tools",{"skillNo":108,"name":109,"nameZh":6,"description":110,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":111,"categories":112,"keywords":114,"publishedAt":22},"01M71TQ29B1EYBCEAP1ZBGXQ1A","zoho-crm-automation","Automate Zoho CRM tasks via Rube MCP (Composio): create\u002Fupdate records, search contacts, manage leads, and convert leads. Always search tools first for current schemas.","https:\u002F\u002Fgithub.com\u002Fjaviertarazon\u002Fide-agente-free-jt7-\u002Fblob\u002Frelease\u002Fv4.2.11-panel-pro\u002F.github\u002Fskills\u002Fzoho-crm-automation\u002FSKILL.md",[113],{"categoryNo":87,"categoryName":88,"taxonomyType":57,"taxonomyTypeDesc":58},[115,116,92,117,118,119,63,120,121,94,122,95,96,123,97,69,124,125,126,73],"crm automation","zoho crm automation","crm","zoho crm","zoho","leads","manage leads","manage","records","convert","tasks","contacts",{"skillNo":128,"name":129,"nameZh":6,"description":130,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":131,"categories":132,"keywords":134,"publishedAt":22},"01M71TPZPMN60DH0XV58KVHY23","zendesk-automation","Automate Zendesk tasks via Rube MCP (Composio): tickets, users, organizations, replies. Always search tools first for current schemas.","https:\u002F\u002Fgithub.com\u002Fjaviertarazon\u002Fide-agente-free-jt7-\u002Fblob\u002Frelease\u002Fv4.2.11-panel-pro\u002F.github\u002Fskills\u002Fzendesk-automation\u002FSKILL.md",[133],{"categoryNo":87,"categoryName":88,"taxonomyType":57,"taxonomyTypeDesc":58},[135,92,136,63,94,95,96,97,137,69,125,138,139,98,99,140,101,104,106,141],"zendesk automation","zendesk","organizations","replies","users","tickets","automate",{"skillNo":143,"name":144,"nameZh":6,"description":145,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":146,"categories":147,"keywords":148,"publishedAt":22},"01M71TPXDWKHKG4N6TVEPXWD0N","zapier-make-patterns","No-code automation democratizes workflow building. Zapier and Make (formerly Integromat) let non-developers automate business processes without writing code. But no-code doesn't mean no-complexity ...","https:\u002F\u002Fgithub.com\u002Fjaviertarazon\u002Fide-agente-free-jt7-\u002Fblob\u002Frelease\u002Fv4.2.11-panel-pro\u002F.github\u002Fskills\u002Fzapier-make-patterns\u002FSKILL.md",[],[149,150,151,152,153,154,155,156,157,92,158,69,159,160,161,162,163,141],"zapier make patterns","zapier","patterns","make","No-Code","complexity","writing","spawner","business","workflow","code","integromat","apache","processes","but",{"skillNo":165,"name":166,"nameZh":6,"description":167,"descriptionZh":6,"repositoryFullName":7,"ownerLogin":8,"ownerAvatarUrl":9,"ownerAccountNo":10,"ownerDisplayName":6,"repositoryNo":11,"starsCount":12,"licenseSpdxId":13,"licenseFileUrl":6,"sourceHtmlUrl":168,"categories":169,"keywords":173,"publishedAt":22},"01M71TPT5T10WXNKW9G7ZXZ27W","youtube-summarizer","Extract transcripts from YouTube videos and generate comprehensive, detailed summaries using intelligent analysis frameworks","https:\u002F\u002Fgithub.com\u002Fjaviertarazon\u002Fide-agente-free-jt7-\u002Fblob\u002Frelease\u002Fv4.2.11-panel-pro\u002F.github\u002Fskills\u002Fyoutube-summarizer\u002FSKILL.md",[170],{"categoryNo":171,"categoryName":172,"taxonomyType":57,"taxonomyTypeDesc":58},"01JBSEEDCAT000000000000016","图像与多媒体",[174,175,176,177,63,178,179,180,181,182,183,184,159,185,186,187,188,189,190,191],"summarizer","youtube","youtube summarizer","Video","content-analysis","frameworks","copilot","2025","github-copilot","extract transcripts","analysis","codex","cli","summaries","github","generate","summarization","2026"]