Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden of disclosure. It indicates results can be text OR files, which adds value, but doesn't specify what happens if the invocation hasn't completed, error behavior, or what the file results look like. The description does state the 'completed' precondition which is useful behavioral context.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence captures both the purpose and the return content type (text/files). Zero wasted words, front-loaded with the core action. Ideal conciseness for a straightforward retrieval tool.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With 1 fully-documented parameter, an output schema present, and a clear single-sentence description covering what's retrieved and from what context, the tool is well-specified. The description could add what happens on a pending invocation, but the 'completed' qualifier plus the sibling status tool gives adequate context. Output schema handles return-value documentation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The single parameter invocation_id has 100% schema coverage with a clear description of what it is ('returned by agents_invoke_agent'). The description's 'completed invocation' framing adds context that the parameter must reference a finished invocation. With full schema coverage and only 1 parameter, there's little the description needs to add beyond what's provided.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states what the tool does: retrieve text or file results from a completed agent or workflow invocation. It specifies the verb (retrieve), resource (invocation results), and distinguishes itself from sibling agents_get_invocation_status which checks status rather than retrieving results.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The condition 'completed invocation' implies this is for results after completion, distinguishing from agents_get_invocation_status which checks status during execution. It doesn't explicitly reference the sibling status tool or state when NOT to use it, but the 'completed' qualifier provides useful contextual guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. The description is a single terse sentence that doesn't explain polling behavior, whether it's idempotent/read-only, what the status values might be, whether it can be called repeatedly, or any rate-limit considerations. For a status-checking tool with zero annotation coverage, this is a significant gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single efficient sentence with zero waste. It's front-loaded with the core action. It could add more behavioral detail without becoming verbose, but as it stands it is appropriately concise.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists, so return-value explanation isn't needed. However, with no annotations and a status-checking tool where the state model is critical (what statuses exist, is it polling-safe, how long invocations take), the description alone is minimally adequate. It would benefit from describing the lifecycle or status values to be truly complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with the only parameter (invocation_id) clearly documented as the ID returned by agents_invoke_agent. The description itself adds no parameter detail, but the schema fully covers the parameter, and the cross-reference to agents_invoke_agent adds useful contextual meaning. Baseline 3 with the cross-reference justifies a 4.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description states 'Check the status of an agent or workflow invocation' with a clear verb (check) and resource (invocation status). It distinguishes from siblings like agents_get_invocation_result (which gets results) and agents_invoke_agent (which starts an invocation). It's clear but not very specific about what 'status' encompasses.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit when-to-use guidance or exclusions are provided. However, the schema parameter 'invocation_id' referencing agents_invoke_agent implies a workflow of invoke-then-check-status, which provides some implicit context. No alternatives or exclusions are mentioned.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden of behavioral disclosure. It does reveal key side effects: it creates a new conversation thread (rather than continuing an existing one) and performs is asynchronous by returning an ID rather than a result. However, it does not mention potential side effects, whether the invocation is blocking or fire-and-forget beyond the ID pattern, or any auth/rate-limit constraints. The behavioral descriptions given are accurate and useful but somewhat minimal.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two concise sentences, front-loaded with the primary action and immediately clarifying the return artifact. Every sentence earns its place, though the lifecycle info about thread creation and ID return is packed compactly. No wasted words, though the 'optional context' phrase slightly duplicates the parameter description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given this is an asynchronous invocation tool with an output schema and well-documented parameters, the description is reasonably complete. It explains the async pattern (returns ID, use status/result tools), which is essential operational knowledge. It could add a bit more about the relationship between the file_context param and typical agent usage, but for a tool whose complexity is moderate and whose lifecycle is clearly mapped to siblings, this is adequate.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema already has 100% coverage with descriptions for all 3 parameters, so the baseline is 3. The description adds value by clarifying that the returned invocation ID pairs with specific sibling tools for status polling and result retrieval, which helps the agent understand how the output parameter relates to the workflow. It also indicates that task is the required payload while file_context is optional supplementary context. This adds meaningful orchestration context beyond the raw schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('Invoke an agent or workflow'), the resource ('with a task and optional context'), and outlines the specific lifecycle: creates a new thread, submits the task, and returns an invocation ID. It also distinguishes itself by pointing to sibling tools (agents_get_invocation_status and agents_get_invocation_result) for following up, which clarifies its role as the initiation step in the workflow.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implicitly conveys when this tool is appropriate: to start an agent invocation and obtain an ID for later polling. It names the status and result retrieval tools as the follow-up path, providing clear context on the lifecycle. However, it does not explicitly state when NOT to use this tool (e.g., when you just want to list agents) or name agents_list_agents as a prerequisite-alternative.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden of disclosure. It usefully states that this is a read-only listing operation ('Returns a formatted list'), which implies no side effects. However, it doesn't describe pagination, sorting, or whether the returned list could be large or need to be queried differently. The read-only nature is implied but not explicitly stated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact (two short paragraphs plus example prompts) and front-loaded with the core purpose in the first sentence. The example prompts section is helpful but adds some length; it earns its place by making cases concrete. No wasted verbiage present.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has an output schema and 0 parameters, so the main thing the description needs to cover is what gets listed and the return format. It covers what's returned (IDs, models, descriptions, capabilities) and notes 'formatted list'. Given a no-parameter tool with an output schema, this is reasonably complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters, so there are no parameter semantics to describe. Per the rubric, 0 params earns a baseline of 4. The description appropriately focuses on the return value (the list of agents with their details) which is the meaningful output content.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('List') and specific resource ('all available agents and workflows in the Azure AI Foundry project'). It also describes what's returned (IDs, models, descriptions, capabilities), distinguishing this from siblings like agents_invoke_agent which clearly does invocation rather than listing.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description includes example prompts that implicitly tell an agent when to use it (when a user asks about available agents/workflows). However, it doesn't explicitly contrast with alternatives like workflows_list_sample_workflows, nor does it state when NOT to use it. The usage context is clear but exclusions/alternatives are not named.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses idempotency (returns confirmation without modifying existing index), which is valuable behavioral context. It also lists the full set of fields/schema supported, giving the agent a clear picture of what gets created. Could add more about latency or side effects but is solid for a no-parameter setup tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

Well-structured with clear sections, front-loaded with the core purpose sentence, then supporting details and example prompts. The field list is a bit verbose but useful. The example prompts add practical value. Slightly long but every section earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter, idempotent setup tool, the description is quite complete. It covers what gets created (all fields incl. vector embedding), idempotency behavior, and example invocations. The output schema exists, so return values aren't needed. Minor gap: doesn't clarify preconditions like whether an Azure AI Search resource must already exist, but this is a well-covered setup operation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters, so there is nothing to explain beyond what the schema shows. Schema coverage is 100% with an empty parameter list. The description zeroes in on what the tool accomplishes rather than parameters, which is appropriate for a parameterless operation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb+resource ('Create the project log search index in Azure AI Search') and lists the detailed schema fields it sets up. It clearly distinguishes from siblings like index_ingest_project_log (ingesting data) and search_vector_db (searching).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides clear context on what the tool does and explicitly notes it's safe to call idempotently ('Safe to call if the index already exists'). Includes example prompts showing intended usage patterns. However, it doesn't explicitly state when NOT to use it versus alternatives (e.g., vs ingest for populating data).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. It does state that it generates embeddings and auto-creates the index, which are meaningful behaviors. However, it doesn't disclose whether existing entries are overwritten, whether the title/short_summary are also vectorized vs only context, or what happens on re-ingestion of the same entry.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is efficient at three sentences, front-loaded with the core purpose and covering the notable side effect (auto-creating index) plus the embedding behavior. No redundancy or filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The schema covers all 9 parameters thoroughly, and an output schema exists so return-value documentation isn't required. The description covers the ingestion behavior and auto-create side effect. However, for a mutation tool with a side effect (index auto-creation) and no annotations, it could disclose more about failure modes or whether existing documents are updated or appended.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description adds the key semantic point that the context field is the one vectorized for search, which is valuable beyond the schema's terse 'will be vectorized for search' note. However, it doesn't add much else beyond what the schema already documents for the other 8 parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific action: ingesting a project log entry into an Azure AI Search index with vector embeddings. It distinguishes from siblings like index_create_project_log_index (which only creates the index) by noting it stores the entry and generates embeddings. However, it doesn't explicitly contrast with search_add_to_vector_db, though the 'creates the index automatically' note does partially differentiate it.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explains the ingestion behavior and that it auto-creates the index, providing clear context for when to use this operation. However, it doesn't explicitly state when NOT to use it or name sibling alternatives, such as when to prefer search_add_to_vector_db or when to first create the index manually with index_create_project_log_index.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden. It discloses the write/non-destructive-add nature and the indexing mechanism, but does not mention error cases (e.g., whether adding a title that already exists overwrites or fails), rate limits, size constraints on content, or what the output/confirmation looks like despite having an output schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

Two concise sentences state the action and purpose without waste. The description is front-loaded with the main verb and resource, and the second sentence adds meaningful mechanistic context about embedding generation.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a fairly complex 9-parameter write tool with an output schema and 100% parameter coverage, the description covers the core purpose well. Given the output schema exists and the schema documents all params, the main gap is the absence of behavioral caveats (e.g., how duplicate titles are handled, whether content size is limited), but overall it is reasonably complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so every one of the 9 parameters has schema-level documentation. The description itself adds no parameter-specific detail beyond what the schema provides, which keeps it at the baseline 3 for full coverage. It doesn't clarify relationships between parameters (e.g., whether short_summary is auto-generated or required for better search).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses specific verb+resource ('Add a new document to the project vector database') and clearly explains the mechanism: generates embedding and stores in Azure AI Search. It also distinguishes from the sibling tool 'search_vector_db' by positioning this as the write counterpart (add/produce vs search/query).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description states what happens (embeds content and stores for future semantic searches) which implies it is used to populate the index before searching. However, it does not explicitly contrast with the sibling search_vector_db tool or mention when NOT to use this tool, nor any prerequisites like needing an index to exist first.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the burden of disclosing behavior. It explains the mechanism (embedding generation, Azure AI Search index) which adds useful context about backend behavior. However, it doesn't disclose details like rate limits, authentication expectations, or behavior when no matches are found.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is efficient: a two-sentence first line plus a brief paragraph explaining the mechanism. No wasted words, front-loaded with the core purpose. Could arguably be trimmed but stays within reasonable bounds.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the output schema exists (so return format is documented elsewhere) and schema coverage is complete, the description is reasonably complete. It explains the query mechanism and result source. For a simple 2-parameter search tool with an output schema, the description provides sufficient operational context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents both parameters well. The description adds the context that 'query' gets embedded, which is a slight enhancement, but top_k semantics are already fully covered by the schema description. Baseline 3 is appropriate since schema handles parameter documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool searches a vector database using semantic similarity, specifying it generates embeddings and queries Azure AI Search. It clearly identifies the tool as the search counterpart to its sibling 'search_add_to_vector_db', though it doesn't explicitly contrast itself with that sibling.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives context on what the tool does (semantic search over project vector DB) which implicitly suggests when to use it. However, it doesn't explicitly state when NOT to use it or offer alternatives among siblings (e.g., contrast with search_add_to_vector_db which is for adding, not searching).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

This is a read-only list operation with no annotations to contradict, and the description communicates a non-destructive purpose clearly ('List...'). It goes beyond a simple verb to describe the specific return contents (names, locations, descriptions, and CLI commands), giving the agent expectation of what output to look for. It doesn't document edge cases like empty definitions or errors, but for a simple listing tool this is adequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is reasonably sized and front-loaded with the core purpose in the first line, then details what's returned, then example prompts. The example prompts add some value for an agent selecting the right tool but could be seen as slightly redundant since the core description is clear. Still, no wasted sentences.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

There is an output schema present, so the description needn't explain the return format in detail. The tool is a simple parameterless listing operation with a clear purpose. It's reasonably complete given the low complexity, though it could mention that this is a read-only/inspection operation and whether it requires any special setup or environment context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has 0 parameters and 100% schema coverage (empty schema), so there are no params needing explanation. The baseline for 0 params is 4, and the description appropriately focuses on what's returned rather than parameter handling, which is the right allocation for a parameterless tool.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states what the tool does: 'List the available sample workflow and agent definitions' with specific details about what's returned (names, locations, descriptions of YAML files in a specific directory, and available CLI commands). This distinguishes it well from sibling tools like workflows_run_project_log_workflow, which executes workflows rather than listing them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides example prompts showing exactly when to use this tool ('What sample workflows are available?', 'List the declarative agent templates I can deploy to Foundry'). While it gives clear context for usage, it doesn't explicitly state when NOT to use it or name alternatives, though sibling tools like agents_list_agents are distinguishable from context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden. It discloses the orchestration side-effect (writes to Azure AI Search vector index), the deployment-based behavior switch (Foundry API vs local Azure OpenAI), and that the combined result is stored as a single entry. This is meaningful behavioral disclosure beyond what schema captures, though it doesn't specify auth requirements or failure modes.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is structured with numbered agent steps for readability, making the orchestration flow easy to parse. Every sentence contributes meaningful information. It could be slightly more compact but the markdown structure improves scannability and the length is justified by the workflow complexity.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has moderate complexity (two-step orchestration, deployment-based branching logic, vector-index side effect). The description covers the workflow steps, the storage outcome, and the deployment variance. With an output schema present, the description need not explain return values. It adequately captures the workflow's full scope for an agent to invoke correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the baseline is 3. The description does describe the workflow's inputs implicitly (story_url drives CaseStudyAgent) but doesn't add format or additional semantics beyond what the schema already provides. The description's added value on parameters is minimal but not zero given the top-level workflow context.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Run') with a clear resource ('project-log ingestion workflow') and even details the two sequential agent steps (CaseStudyAgent, ArchitectureAgent) plus the final vector-index storage. It clearly distinguishes itself from sibling tools like agents_invoke_agent and index_ingest_project_log by describing the orchestrated multi-step composition.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description clearly states when to use this tool (running the full project-log workflow). While it doesn't explicitly name alternatives to avoid, it does describe the internal orchestration (agents invoked via Foundry API vs. running locally), which gives context on how it compares to lower-level siblings. It lacks explicit when-not-to-use guidance but provides decent context.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.