fix: structured output add instructions for the agent since some clients consider only structured output if present (#352)

Author: MQ37

src/tools/search-apify-docs.ts

@@ -78,12 +78,14 @@ Search results for "${query}":
 
 ${results.map((result) => `- Document URL: ${result.url}${result.fragment ? `\n  Document fragment: ${result.fragment}` : ''}
    Content: ${result.content}`).join('\n\n')}`;
+
         const structuredContent = {
             results: results.map((result) => ({
                 url: result.url,
                 fragment: result.fragment,
                 content: result.content,
             })),
+            instructions: `You can use the Apify docs fetch tool to retrieve the full content of a document by its URL. The document fragment refers to the section of the content containing the relevant part for the search result item.`,
         };
         return buildMCPResponse({ texts: [textContent], structuredContent });
     },

src/tools/store_collection.ts

@@ -172,6 +172,8 @@ Returns list of Actor cards with the following info:
             actors: structuredActorCards,
             query: parsed.keywords,
             count: actorCards.length,
+            instructions: `If you need more detailed information about any of these Actors, including their input schemas and usage instructions, please use the ${HelperTools.ACTOR_GET_DETAILS} tool with the specific Actor name.
+ If the search did not return relevant results, consider refining your keywords, use broader terms or removing less important words from the keywords.`,
         };
 
         return buildMCPResponse({ texts, structuredContent });

src/tools/structured-output-schemas.ts

@@ -144,6 +144,7 @@ export const actorSearchOutputSchema = {
         },
         query: { type: 'string', description: 'The search query used' },
         count: { type: 'number', description: 'Number of Actors returned' },
+        instructions: { type: 'string', description: 'Additional instructions for the LLM to follow when processing the search results.' },
     },
     required: ['actors', 'query', 'count'],
 };
@@ -163,6 +164,7 @@ export const searchApifyDocsToolOutputSchema = {
                 required: ['url', 'content'],
             },
         },
+        instructions: { type: 'string', description: 'Additional instructions for the LLM to follow when processing the search results.' },
     },
     required: ['results'],
 };