スキル Azure.AI.Agents.Persistent (.NET)
📦

Azure.AI.Agents.Persistent (.NET)

安全

Creación de agentes de IA persistentes con Azure AI SDK para .NET

Los desarrolladores necesitan integrar agentes de IA persistentes en aplicaciones .NET con gestión adecuada de hilos y streaming. Esta habilidad proporciona patrones completos de SDK para CRUD de agentes, flujos de conversación, llamada a funciones y búsqueda de archivos usando Azure AI Agents.

対応: Claude Codex Code(CC)
📊 69 十分
1

スキルZIPをダウンロード

2

Claudeでアップロード

設定 → 機能 → スキル → スキルをアップロードへ移動

3

オンにして利用開始

テストする

「Azure.AI.Agents.Persistent (.NET)」を使用しています。 Crear un agente tutor de matemáticas con code interpreter habilitado

期待される結果:

Agente creado exitosamente con ID 'asst_abc123'. El agente está configurado con el modelo gpt-4o-mini y CodeInterpreterTool. Instrucciones: 'Eres un tutor personal de matemáticas. Escribe y ejecuta código para responder preguntas matemáticas.' Listo para crear hilos y procesar mensajes de usuario.

「Azure.AI.Agents.Persistent (.NET)」を使用しています。 Transmitir una respuesta del agente para la pregunta del usuario sobre resolver 3x + 11 = 14

期待される結果:

Salida en streaming: 'Para resolver 3x + 11 = 14, necesito aislar x. Primero, reste 11 de ambos lados: 3x = 3. Luego divida por 3: x = 1. Permítame verificar esto con código.' Ejecución completada con respuesta final mostrando que x es igual a 1.

セキュリティ監査

安全
v1 • 2/24/2026

Documentation-only skill with no executable code. Static analysis found 0 security issues with risk score 0/100. The SKILL.md file contains legitimate Azure SDK usage examples for agent creation, thread management, streaming, and function calling. No security concerns identified.

0
スキャンされたファイル
0
解析された行数
0
検出結果
1
総監査数
セキュリティ問題は見つかりませんでした
監査者: claude

品質スコア

38
アーキテクチャ
100
保守性
87
コンテンツ
31
コミュニティ
100
セキュリティ
74
仕様準拠

作れるもの

Crear un Agente Tutor de Matemáticas

Cree un agente persistente que resuelve problemas matemáticos usando code interpreter. Los usuarios envían preguntas mediante mensajes de hilo, y el agente ejecuta código Python para calcular respuestas con explicaciones paso a paso.

Asistente de Búsqueda de Documentos

Implemente un agente con búsqueda de archivos en almacén vectorial para responder preguntas desde documentación cargada. Cargue archivos, cree almacenes vectoriales y consulte mediante conversaciones en lenguaje natural.

Bot del Clima con Llamada a Funciones

Construya un agente que llama a APIs externas del clima mediante definiciones de funciones. Defina esquemas de herramientas, maneje respuestas RequiresAction y devuelva datos del clima formateados a los usuarios.

これらのプロンプトを試す

Crear un Agente Básico
Cree un agente de IA persistente usando Azure.AI.Agents.Persistent SDK. El agente debe usar el modelo gpt-4o-mini con instrucciones para actuar como un asistente útil. Muestre autenticación con DefaultAzureCredential y código básico de creación de agente.
Implementar Respuestas en Streaming
Muéstreme cómo transmitir respuestas de agente en tiempo real usando CreateRunStreamingAsync. Incluya manejo para MessageContentUpdate y eventos de estado de ejecución como RunCreated y RunCompleted.
Agregar Llamada a Funciones al Agente
Cree un agente con una herramienta de función personalizada para obtener datos del clima. Defina FunctionToolDefinition con parámetros de esquema JSON, maneje el estado RequiresAction y envíe salidas de herramientas de vuelta a la ejecución.
Configurar Búsqueda de Archivos con Almacén Vectorial
Configure capacidades de búsqueda de archivos para un agente. Cargue un archivo de documento, cree un almacén vectorial con el ID del archivo, configure FileSearchToolResource y cree un agente que pueda buscar documentos para responder preguntas.

ベストプラクティス

  • Siempre disponga clientes usando declaraciones 'using' o eliminación explícita para liberar recursos
  • Sondee ejecuciones de agente con retrasos de 500ms entre verificaciones de estado para evitar límites de tasa
  • Elimine hilos, agentes y almacenes vectoriales cuando termine para limpiar recursos

回避

  • No omita el manejo de errores para RequestFailedException al llamar a APIs de agente
  • Evite codificar credenciales o URLs de endpoint directamente en el código de la aplicación
  • Evite bucles de polling ajustados sin retrasos que pueden activar límites de tasa

よくある質問

¿Cuál es la diferencia entre PersistentAgentsClient y Azure.AI.Projects?
PersistentAgentsClient proporciona acceso directo de bajo nivel a operaciones de agente. Azure.AI.Projects ofrece una abstracción de nivel superior que envuelve la funcionalidad de agentes persistentes con características adicionales de gestión de proyectos.
¿Cómo manejo la llamada a funciones en una ejecución en streaming?
La llamada a funciones requiere patrón de polling, no streaming. Cuando el estado de ejecución es RequiresAction, extraiga los detalles de la llamada a función, ejecute su función, envíe salidas de herramientas, luego continúe sondeando hasta completar.
¿Qué métodos de autenticación están soportados?
El SDK admite DefaultAzureCredential que incluye identidad gestionada, credenciales de Azure CLI, credenciales de Visual Studio y autenticación de entidad de servicio mediante variables de entorno.
¿Cuánto tiempo persisten los hilos y mensajes?
Los hilos y mensajes persisten indefinidamente hasta que se eliminan explícitamente. Almacene IDs de hilo para reanudar conversaciones más tarde. Considere implementar lógica de limpieza para hilos no utilizados para gestionar costos.
¿Puedo usar múltiples herramientas con un solo agente?
Sí, puede configurar múltiples herramientas al crear un agente. Pase un arreglo que contenga CodeInterpreterToolDefinition, FileSearchToolDefinition, FunctionToolDefinition y otros tipos de herramientas según sea necesario.
¿Cuáles son los límites de tasa para operaciones de agente?
Los límites de tasa dependen de su nivel de recurso Azure AI. Implemente retroceso exponencial para RequestFailedException con estado 429. El intervalo de polling predeterminado de 500ms es generalmente seguro para la mayoría de escenarios.

開発者の詳細

ファイル構成

📄 SKILL.md