Playbooks use tools to perform specific tasks, such as KIO interacting with the CoreMedia Content Repository for actions like reading, updating, or searching for content items.

KIO automatically detects available tools and uses them as needed in playbook steps. As a playbook developer, understanding and effectively using these tools is essential.

New tools may be added in future KIO releases, so regularly check for updates.

To view available tools, you can simply ask KIO:

> List all tools that are available.

< I have the following tools available:
  1. Query Service Tool: Query content items using CoreMedia Query Language (CQL).
  2. Repository Metadata Tool: List all content types and their properties.
  3. Update Content Tool: Update properties of existing content items.
  ...

For details on a specific tool, you can also ask KIO:

> Show me examples on how to use the Update Content Tool.

< Here's an example of how you might use the Update Content Tool:

  Task: Update the title and detail text of a content item.
  Example Prompt:
  Update the content item with ID 12345. Change the title to 'New Exciting Title' and update the
  detail text to 'This is the updated content detail text.'

KIO can combine multiple tools internally. Related to the example above, KIO might use the Query Service Tool to find the content item and resolve the content ID first, and then use the Update Content Tool to apply the changes. With that in mind, you can also update content by ID, path, or just by referencing the current article or similar.

For a better understanding of how KIO uses tools in playbooks, you can enable debug output as described in the next section.