Compartir contexto del agente para recomendaciones de verificación

Complete este paso solo cuando el aviso de incorporación inicial de Datadog incluya una URL de carga de contexto del agente, un token de carga y una versión de esquema.

Después de la instrumentación:

1. Inspeccione solo los archivos del repositorio necesarios para comprender el propósito, las herramientas, las reglas de comportamiento explícitas y las condiciones de transferencia del agente.

2. Incluya solo las expectativas respaldadas directamente por un aviso, instrucción, política o prueba citada. Registre un comportamiento atómico por expectativa, expréselo en términos observables en la entrada o salida del agente, el contexto de traza, las llamadas a herramientas, los resultados de las herramientas o su orden, y omita las reglas ambiguas o contradictorias en lugar de adivinar.

3. Cree un resumen JSON delimitado utilizando la versión de esquema del aviso de incorporación y esta forma exacta:

   {
     "schema_version": "<schema-version-from-the-onboarding-prompt>",
     "context": {
       "agent_summary": "A short description of the agent",
       "capabilities": [
         {
           "name": "...",
           "description": "...",
           "source_reference_ids": ["source-1"]
         }
       ],
       "tools": [
         {
           "name": "...",
           "purpose": "...",
           "source_reference_ids": ["source-1"]
         }
       ],
       "behavioral_expectations": [
         {
           "id": "expectation-1",
           "behavior": "...",
           "applicability": "...",
           "failure": "...",
           "observable_signals": ["agent_input", "agent_output"],
           "source_reference_ids": ["source-1"]
         }
       ],
       "handoff_conditions": [
         {
           "id": "handoff-1",
           "condition": "...",
           "destination": "...",
           "observable_signals": ["agent_input", "agent_output"],
           "source_reference_ids": ["source-1"]
         }
       ],
       "source_references": [
         {
           "id": "source-1",
           "source_kind": "prompt",
           "path": "relative/path",
           "line_start": 1,
           "line_end": 10,
           "description": "Why this source supports the summary"
         }
       ]
     }
   }
   

   Mantenga el objeto context codificado en 64 KiB o menos y utilice estos límites de recolección:

   • Hasta 20 capacidades y 30 herramientas.
   • Entre 1 y 30 expectativas de comportamiento.
   • Hasta 20 condiciones de transferencia.
   • Entre 1 y 60 referencias de fuente.

   Utilice entre 1 y 10 ID de referencia de fuente únicos para cada capacidad, herramienta, expectativa de comportamiento y condición de transferencia. Cada expectativa de comportamiento y condición de transferencia debe citar al menos una fuente prompt, instruction, policy o test e incluir entre 1 y 6 señales observables únicas.

   Mantenga agent_summary entre 1 y 1,000 caracteres. Mantenga los nombres y destinos de transferencia entre 1 y 120 caracteres. Mantenga las descripciones, propósitos, comportamientos, declaraciones de aplicabilidad, fallas, condiciones de transferencia y rutas de fuente entre 1 y 500 caracteres. Mantenga las descripciones de referencia de fuente entre 1 y 300 caracteres.

   Asigne a cada referencia de fuente, expectativa de comportamiento y condición de transferencia un ID de entre 1 y 64 caracteres que contenga solo letras, números, guiones o guiones bajos. Los ID de referencia de fuente deben ser únicos dentro de source_references. Los ID de expectativa de comportamiento y condición de transferencia deben ser únicos en ambas colecciones. Los ID son locales para esta carga y permiten que cada verificación recomendada cite su evidencia.

   Utilice source_kind solo desde prompt, instruction, policy, test, tool_definition o implementation. Utilice observable_signals solo desde agent_input, agent_output, trace_context, tool_call, tool_result o tool_order. Si incluye line_end, incluya también un line_start positivo y haga que line_end sea mayor o igual que line_start.

4. Envíe el JSON una vez a la URL de carga desde el aviso de incorporación. Utilice POST, configure Content-Type: application/json y pase el token de carga solo en el encabezado Authorization: Bearer <upload-token>.

Siga estos requisitos de seguridad:

• Trate el token de carga como un secreto de un solo uso. No lo escriba en archivos de fuente, configuración, historial de shell, resultados o registros.
• Cargue solo el resumen estructurado. No cargue código fuente sin procesar, prompts completos, secretos, credenciales, variables de entorno, datos de clientes, contenidos de rastreo o metadatos arbitrarios.
• Utilice rutas de fuente POSIX relativas al repositorio normalizadas y los rangos de líneas útiles más pequeños. No utilice rutas absolutas, barras invertidas, dos puntos, separadores no normalizados ni segmentos de ruta . o ... Las referencias de fuente identifican la evidencia; no deben copiar su contenido.
• Si la carga falla, continúe con la instrumentación e informe al usuario que Datadog no recibió el contexto opcional. No vuelva a intentarlo con datos más amplios.